Set-DataClassification
このコマンドレットは、オンプレミスの Exchange でのみ機能します。
Exchange Onlineでは、このコマンドレットはセキュリティ & コンプライアンス PowerShell の Set-DlpSensitiveInformationType コマンドレットに置き換えられました。
Set-DataClassification コマンドレットを使って、ドキュメントの指紋を使用するデータ分類規則を変更します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Set-DataClassification
[-Identity] <DataClassificationIdParameter>
[-Confirm]
[-Description <String>]
[-DomainController <Fqdn>]
[-Fingerprints <MultiValuedProperty>]
[-IsDefault]
[-Locale <CultureInfo>]
[-Name <String>]
[-WhatIf]
[<CommonParameters>]
説明
分類規則のパッケージは、データ損失防止 (DLP) でメッセージ内の機密性の高いコンテンツを検出するために使用されます。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
Set-DataClassification "Contoso Confidential" -Locale fr -Name "Contoso Confidentiel" -Description "Ce message contient des informations confidentielles." -IsDefault
この例では、"Contoso Confidential" という既存のデータ分類規則にフランス語翻訳を追加し、そのフランス語翻訳を既定に設定します。
例 2
Set-DataClassification "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-Fingerprint -FileData $Benefits_Template -Description "Contoso Benefits Template"
$Contoso_Confidential = Get-DataClassification "Contoso Confidential"
$Array = [System.Collections.ArrayList]($Contoso_Confidential.Fingerprints)
$Array.Add($Benefits_FingerPrint)
Set-DataClassification $Contoso_Confidential.Identity -FingerPrints $Array
この例では、既に定義済みの既存のドキュメントの指紋には影響を与えずに、C:\My Documents\Contoso Benefits Template.docx ファイルの新しいドキュメントの指紋を追加して、"Contoso Confidential" という既存のデータ分類規則を変更します。
例 4
$cc = Get-DataClassification "Contoso Confidential"
$a = [System.Collections.ArrayList]($cc.Fingerprints)
$a
$a.RemoveAt(0)
Set-DataClassification $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: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-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: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-DomainController
DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Fingerprints
Fingerprints パラメーターは、データ分類規則が指紋として使用するバイトエンコードされたドキュメント ファイルを指定します。 指紋のテンプレートとして使用するドキュメントをインポートする方法については、「 New-Fingerprint 」または「Examples」セクションを参照してください。 既存のデータ分類規則でドキュメントの指紋を追加および削除する方法については、「Examples」セクションを参照してください。
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Identity
Identity パラメーターは、変更するデータ分類規則を指定します。 データ分類ルールを一意に識別する任意の値を使用できます。 たとえば、
- 名前
- LocalizedName
- ID GUID 値
Type: | DataClassificationIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-IsDefault
IsDefault スイッチを Locale パラメーターと共に使用して、データ分類規則の既定の言語を指定します。 このスイッチで値を指定する必要はありません。
Locale の既定値は、DefaultCultureプロパティに格納されます。
Locale の既定値を変更すると、新しい既定のロケールに関連付けられた Name の値に合わせて、データ分類規則の Name の値が変わります。 規則が作成された時点の Name の元の値は、LocalizedName プロパティに永続的に格納されます。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Locale
Locale パラメーターは、データ分類規則に関連付けられた言語を追加または削除します。
このパラメーターの正しい入力は、Microsoft .NET Framework CultureInfo クラスでサポートされているカルチャ コード値です。 たとえば、デンマーク語の場合には da-DK、日本語の場合には ja-JP となります。 詳細については、「CultureInfo クラス」を参照してください。
通常、Locale パラメーターを Name および Description パラメーターと共に使用して、データ分類規則の翻訳された名前および説明を追加、削除します。 Locale パラメーターを IsDefault スイッチと共に使用して、既存の翻訳された名前と説明を既定値として指定することもできます。 既定の翻訳を削除するには、その前に、別の翻訳を既定として設定する必要があります。
Type: | CultureInfo |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-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: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-WhatIf
WhatIf スイッチは、コマンドの操作をシミュレートします。 このスイッチを使用すると、実際にその変更内容を適用せずに、発生する変更を確認できます。 このスイッチで値を指定する必要はありません。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
入力
Input types
このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。
出力
Output types
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。