Remove-FileLabel
ファイルの秘密度ラベルを削除するか、ラベルの構成またはカスタムアクセス許可に従って保護を削除します。
構文
Remove-FileLabel
[-Path] <String[]>
[-JustificationMessage <String>]
[-RemoveLabel]
[-PreserveFileDetails]
[<CommonParameters>]
Remove-FileLabel
[-Path] <String[]>
[-JustificationMessage <String>]
[-RemoveLabel]
[-RemoveProtection]
[-PreserveFileDetails]
[<CommonParameters>]
Remove-FileLabel
[-Path] <String[]>
[-JustificationMessage <String>]
[-RemoveProtection]
[-PreserveFileDetails]
[<CommonParameters>]
説明
Microsoft Purview 情報保護 クライアントの場合、Remove-FileLabel コマンドレットは 1 つ以上のファイルの秘密度ラベルを削除します。
例
例 1: ファイルからラベルを削除する
PS C:\> Remove-FileLabel C:\Projects\Analysis.docx -RemoveLabel -JustificationMessage 'The previous label no longer applies'
FileName Status Comment
-------- ------ ------------
C:\Projects\Analysis.docx Success
このコマンドは、 C:\Projects\Analysis.docxという名前のファイルから既存のラベルを削除し、必須の理由メッセージを指定します。
関連する秘密度ラベル ポリシー設定でラベルを削除するための正当な理由が必要になるため、この理由付け方法が必要です。
注意
削除するラベルがテンプレートを使用してファイルを保護していた場合、このコマンドはラベルと保護の両方を削除します。
削除するラベルがカスタムアクセス許可を使用してファイルを保護していた場合、このコマンドはラベルのみを削除します。
例 8: ファイルから保護を削除する
PS C:\> Remove-FileLabel C:\Projects\Analysis.docx -RemoveProtection
FileName Status Comment
-------- ------ ------------
C:\Projects\Analysis.docx Success
このコマンドは、 という名前の 1 つのファイルから保護 Analysis.docx削除します。
例 9: ファイルから保護とラベルを削除する
PS C:\> Set-AIPFileLabel C:\Projects\Analysis.docx -RemoveProtection -RemoveLabel -JustificationMessage 'The previous label no longer applies'
FileName Status Comment
-------- ------ ------------
C:\Projects\Analysis.docx Success
このコマンドは、 という名前の 1 つのファイルからラベルとカスタム保護 Analysis.docx削除します。 ポリシーはラベルを削除するために正当な理由を要求するように構成されているため、理由をユーザーに求めずにコマンドを完了できるように、理由理由も指定されます。
パラメーター
-JustificationMessage
秘密度ラベル付けポリシーでユーザーがこの情報を指定する必要がある場合に、ラベルを削除したり、保護を削除したりする正当な理由。 ラベルを削除すると理由がトリガーされ、この理由が指定されていない場合、ラベルは削除されません。 この場合、"スキップ" というステータスが "正当な理由が必要です" というコメントと共に返されます。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Path
ラベルと保護情報を削除するファイルへのローカル パス、ネットワーク パス、または SharePoint Server URL を指定します。
ワイルドカードはサポートされていません。また、WebDav の場所はサポートされていません。
SharePoint パスの場合は、次がサポートされています。
- SharePoint Server 2022
- SharePoint Server 2019
- SharePoint Server 2016
- SharePoint Server 2013
例:
- C:\Folder\
- C:\Folder\Filename
- \\Server\Folder
- http://sharepoint.contoso.com/Shared%20Documents/Folder
パス値を引用符で囲む場合、パスにはスペースを含めることができます。
型: | String[] |
Aliases: | FullName, FileName |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-PreserveFileDetails
ラベルを付けるドキュメントの変更日 (Windows および SharePoint) と変更日 (SharePoint) の値を変更しない場合は、このパラメーターを指定します。
ローカル ファイルまたはネットワーク ファイルの場合、 変更日 の値は変更されません。
SharePoint ファイルの場合、[ 変更日 ] と [ 変更日] の値は変更されません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-RemoveLabel
ファイルに適用されているラベルを削除します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-RemoveProtection
ファイルから保護を削除します。 ファイルにラベルが付いた場合、ラベルは削除されません。
ファイルから保護を削除するには、十分な使用権限を持っているか、organizationのスーパー ユーザーである必要があります。 詳細については、「 Azure Rights Management および探索サービスまたはデータ復旧のためのスーパー ユーザーの構成」を参照してください。
Remove-FileLabel PowerShell コマンドレットを使用して、コンテナー ファイル (zip、 .rar、.7z、.pst) からの保護の削除を有効にします。
注意
この保護機能は既定で無効になっており、 Set-LabelPolicy コマンドレットを使用して最初に有効にする必要があります。
.pst ファイルの場合、このコマンドレットでサポートされる最大ファイル サイズは 5 GB です。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
System.String[]
出力
Microsoft.InformationProtection.Powershell.AIP.Results.SetAIPFileResult