Set-DlpSensitiveInformationType
このコマンドレットは、オンプレミスの Exchange およびクラウド ベースのサービスで使用できます。 一部のパラメーターおよび設定は、いずれかの環境専用となっている場合があります。
Set-DlpSensitiveInformationType コマンドレットを使用して、ドキュメント フィンガープリントを使用する機密情報の種類の規則を変更します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Set-DlpSensitiveInformationType
[-Identity] <SensitiveInformationTypeIdParameter>
[-Confirm]
[-Description <String>]
[-FileData <Byte[]>]
[-Fingerprints <MultiValuedProperty>]
[-IsExact <Boolean>]
[-Locale <CultureInfo>]
[-Name <String>]
[-Threshold <UInt32>]
[-ThresholdConfig <PswsHashtable>]
[-WhatIf]
[<CommonParameters>]
説明
機密情報の種類のルール パッケージは、メッセージ内の機密性の高いコンテンツを検出するために、データ損失防止 (DLP) によって使用されます。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
Set-DlpSensitiveInformationType "Contoso Confidential" -Locale fr -Name "Contoso Confidentiel" -Description "Ce message contient des informations confidentielles." -IsDefault
次の使用例は、"Contoso Confidential" という名前の既存の機密情報の種類の規則にフランス語翻訳を追加し、このフランス語翻訳を既定値として設定します。
例 2
Set-DlpSensitiveInformationType "Contoso Confidential" -Locale es -Name $null -Description $null
次の使用例は、"Contoso Confidential" という名前の機密情報の種類の規則から、既存のスペイン語翻訳を削除します。
例 3
$Benefits_Template = [System.IO.File]::ReadAllBytes('C:\My Documents\Contoso Benefits Template.docx')
$Benefits_Fingerprint = New-DlpFingerprint -FileData $Benefits_Template -Description "Contoso Benefits Template"
$Contoso_Confidential = Get-DlpSensitiveInformationType "Contoso Confidential"
$Array = [System.Collections.ArrayList]($Contoso_Confidential.Fingerprints)
$Array.Add($Benefits_FingerPrint[0])
Set-DlpSensitiveInformationType $Contoso_Confidential.Identity -FingerPrints $Array
次の使用例は、ファイル C:\My Documents\Contoso Benefits Template.docxの新しいドキュメント フィンガープリントを追加することで、"Contoso Confidential" という名前の既存の機密情報の種類の規則を変更します。これは、既に定義されている既存のドキュメント フィンガープリントに影響を与えることなく行います。
例 4
$cc = Get-DlpSensitiveInformationType "Contoso Confidential"
$a = [System.Collections.ArrayList]($cc.Fingerprints)
$a
$a.RemoveAt(0)
Set-DlpSensitiveInformationType $cc.Identity -FingerPrints $a
この例では、既に定義されている他のドキュメント フィンガープリントに影響を与えることなく、既存のドキュメント フィンガープリントを削除することで、"Contoso Confidential" という名前の機密情報の種類の規則を変更します。
最初の 3 つのコマンドは、機密情報の種類のドキュメント フィンガープリントの一覧を返します。 一覧に最初に表示されるドキュメントの指紋のインデックス番号は 0、2 番目のドキュメントの指紋のインデックス番号は 1 となります。 このインデックス番号を使って、削除するドキュメントの指紋を指定します。 最後の 2 つのコマンドは、リストに表示される最初のドキュメント フィンガープリントを削除します。
パラメーター
-Confirm
Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。
- 破壊的なコマンドレット (Remove-* コマンドレットなど) には、続行する前にコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文
-Confirm:$false
を使用して、確認プロンプトを省略できます。 - 他のほとんどのコマンドレット (New-* コマンドレットや Set-* コマンドレットなど) には、一時停止が組み込まれています。 これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Description
Description パラメーターは、機密情報の種類ルールの説明を指定します。 Description パラメーターと Locale パラメーターと Name パラメーターを使用して、さまざまな言語で機密情報の種類の規則の説明を指定します。 Description のローカライズされた値は、機密情報の種類ルールの AllLocalizedDescriptions プロパティに表示されます。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-FileData
{{ Fill FileData Description }}
Type: | Byte[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Fingerprints
フィンガープリント パラメーターは、機密情報の種類の規則によってフィンガープリントとして使用されるバイトエンコードドキュメント ファイルを指定します。 指紋のテンプレートとして使用するドキュメントをインポートする方法については、「 New-DlpFingerprint 」または「Examples」セクションを参照してください。 既存の機密情報の種類の規則からドキュメント フィンガープリントを追加および削除する方法については、「例」セクションを参照してください。
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Identity
Identity パラメーターは、変更する機密情報の種類の規則を指定します。 機密情報の種類の規則を一意に識別する任意の値を使用できます。 例:
- 名前
- LocalizedName
- ID GUID 値
Type: | SensitiveInformationTypeIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-IsExact
{{ Fill IsExact Description }}
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Locale
Locale パラメーターは、機密情報の種類の規則に関連付けられている言語を追加または削除します。
このパラメーターの正しい入力は、Microsoft .NET Framework CultureInfo クラスでサポートされているカルチャ コード値です。 たとえば、デンマーク語の場合には da-DK、日本語の場合には ja-JP となります。 詳細については、「CultureInfo クラス」を参照してください。
通常、ロケール パラメーターと Name パラメーターと Description パラメーターを使用して、機密情報の種類ルールの翻訳された名前と説明を追加または削除します。 Locale パラメーターを IsDefault スイッチと共に使用して、既存の翻訳された名前と説明を既定値として指定することもできます。 既定の翻訳を削除するには、その前に、別の翻訳を既定として設定する必要があります。
Type: | CultureInfo |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Name
Name パラメーターは、機密情報の種類の規則の名前を指定します。 値は 256 文字未満にする必要があります。
Name パラメーターと Locale パラメーターと Description パラメーターを使用して、機密情報の種類の規則の名前を異なる言語で指定します。 Name のローカライズされた値は、機密情報の種類ルールの AllLocalizedNames プロパティに表示されます。
Name パラメーターの値は、Outlook on the webのユーザーに提示されるポリシー ヒントで使用されます。 翻訳された Name パラメーターの値がクライアントの言語と一致する場合は、ポリシー ヒントがクライアントの言語で表示されます。 翻訳された Name パラメーターの値がクライアントの言語と一致しない場合は、IsDefault パラメーターで指定された既定の翻訳がポリシー ヒントに使用されます。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Threshold
{{ Fill Threshold Description }}
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-ThresholdConfig
{{ Fill ThresholdConfig Description }}
Type: | PswsHashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-WhatIf
WhatIf スイッチは、セキュリティ & コンプライアンス PowerShell では機能しません。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |