Set-DlpSensitiveInformationType
このコマンドレットは、オンプレミスの Exchange およびクラウド ベースのサービスで使用できます。 一部のパラメーターと設定は、1 つの環境または他の環境に限定される場合があります。
Set-DlpSensitiveInformationType コマンドレットを使用して、ドキュメント フィンガープリントを使用する機密情報の種類の規則を変更します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Default (既定)
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 スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。
このコマンドレットには一時停止が組み込まれているため、 -Confirm:$false を使用して確認をスキップします。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Description
適用対象: セキュリティ & コンプライアンス
Description パラメーターは、機密情報の種類ルールの説明を指定します。 Description パラメーターと Locale パラメーターと Name パラメーターを使用して、さまざまな言語で機密情報の種類の規則の説明を指定します。 Description のローカライズされた値は、機密情報の種類ルールの AllLocalizedDescriptions プロパティに表示されます。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-FileData
適用対象: セキュリティ & コンプライアンス
{{ Fill FileData Description }}
パラメーターのプロパティ
| 型: | Byte[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Fingerprints
適用対象: セキュリティ & コンプライアンス
フィンガープリント パラメーターは、機密情報の種類の規則によってフィンガープリントとして使用されるバイトエンコードドキュメント ファイルを指定します。 指紋のテンプレートとして使用するドキュメントをインポートする方法については、「 New-DlpFingerprint 」または「Examples」セクションを参照してください。 既存の機密情報の種類の規則からドキュメント フィンガープリントを追加および削除する方法については、「例」セクションを参照してください。
パラメーターのプロパティ
| 型: | MultiValuedProperty |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Identity
適用対象: セキュリティ & コンプライアンス
Identity パラメーターは、変更する機密情報の種類の規則を指定します。 機密情報の種類の規則を一意に識別する任意の値を使用できます。 例:
- 名前
- LocalizedName
- ID GUID 値
パラメーターのプロパティ
| 型: | SensitiveInformationTypeIdParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-IsExact
適用対象: セキュリティ & コンプライアンス
{{ Fill IsExact Description }}
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Locale
適用対象: セキュリティ & コンプライアンス
Locale パラメーターは、機密情報の種類の規則に関連付けられている言語を追加または削除します。
このパラメーターの正しい入力は、Microsoft .NET Framework CultureInfo クラスでサポートされているカルチャ コード値です。 たとえば、デンマーク語の場合には da-DK、日本語の場合には ja-JP となります。 詳細については、「CultureInfo クラス」を参照してください。
通常、ロケール パラメーターと Name パラメーターと Description パラメーターを使用して、機密情報の種類ルールの翻訳された名前と説明を追加または削除します。 Locale パラメーターを IsDefault スイッチと共に使用して、既存の翻訳された名前と説明を既定値として指定することもできます。 既定の翻訳を削除するには、その前に、別の翻訳を既定として設定する必要があります。
パラメーターのプロパティ
| 型: | CultureInfo |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Name
適用対象: セキュリティ & コンプライアンス
Name パラメーターは、機密情報の種類の規則の名前を指定します。 値は 256 文字未満にする必要があります。
Name パラメーターと Locale パラメーターと Description パラメーターを使用して、機密情報の種類の規則の名前を異なる言語で指定します。 Name のローカライズされた値は、機密情報の種類ルールの AllLocalizedNames プロパティに表示されます。
Name パラメーターの値は、Outlook on the webのユーザーに提示されるポリシー ヒントで使用されます。 翻訳された Name パラメーターの値がクライアントの言語と一致する場合は、ポリシー ヒントがクライアントの言語で表示されます。 翻訳された Name パラメーターの値がクライアントの言語と一致しない場合は、IsDefault パラメーターで指定された既定の翻訳がポリシー ヒントに使用されます。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Threshold
適用対象: セキュリティ & コンプライアンス
{{ Fill Threshold Description }}
パラメーターのプロパティ
| 型: | UInt32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ThresholdConfig
適用対象: セキュリティ & コンプライアンス
{{ Fill ThresholdConfig Description }}
パラメーターのプロパティ
| 型: | PswsHashtable |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WhatIf
適用対象: セキュリティ & コンプライアンス
WhatIf スイッチは、セキュリティ/コンプライアンス PowerShell では機能しません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | ウィスコンシン |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、「about_CommonParameters」を参照してください。