Share via


Unlock-SPOSensitivityLabelEncryptedFile

It removes encryption on a Sensitivity label encrypted file in SharePoint Online. No need to download the file.

Syntax

Default (Default)

Unlock-SPOSensitivityLabelEncryptedFile
    [-FileUrl] <String>
    [-JustificationText] <String>
    [<CommonParameters>]

Description

The Unlock-SPOSensitivityLabelEncryptedFile cmdlet runs on a single office online file that is encrypted via sensitivity label. It decrypts the file and removes the label from the file.

You must be at least a SharePoint Online administrator to run the Unlock-SPOSensitivityLabelEncryptedFile cmdlet. This cmdlet doesn't work on files that have double key encryption or files that have encryption but are not processed by SharePoint. These files don't show the name of the label in the Sensitivity column, and you can't edit these files in Office Online.

For permissions and the most current information about Windows PowerShell for SharePoint Online, see the online documentation at Intro to SharePoint Online Management Shell.

Examples

EXAMPLE 1

 Unlock-SPOSensitivityLabelEncryptedFile -FileUrl "https://contoso.com/sites/Marketing/Shared Documents/Doc1.docx" -JustificationText "Need to recover this file"

This example will remove a regular label with admin defined encryption from the file Doc1.docx and also make an entry in audit logs.

Parameters

-FileUrl

Applicable: SharePoint Online

Full URL for the file.

Parameter properties

Type:System.String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:0
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-JustificationText

Applicable: SharePoint Online

Text that explains the reason to run this cmdlet on the given file.

Parameter properties

Type:System.String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:1
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

None

Outputs

System.Object