Set-DataClassification

此 Cmdlet 只能在內部部署 Exchange 中運作。

在Exchange Online中,此 Cmdlet 已由安全 & 性合規性 PowerShell 中的Set-DlpSensitiveInformationType Cmdlet 取代。

使用 Set-DataClassification 指令程式,可以修改使用文件指紋的資料分類規則。

如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法

Syntax

Set-DataClassification
   [-Identity] <DataClassificationIdParameter>
   [-Confirm]
   [-Description <String>]
   [-DomainController <Fqdn>]
   [-Fingerprints <MultiValuedProperty>]
   [-IsDefault]
   [-Locale <CultureInfo>]
   [-Name <String>]
   [-WhatIf]
   [<CommonParameters>]

Description

資料外洩防護 (DLP) 使用分類規則套件來偵測郵件中的敏感內容。

您必須已獲指派權限,才能執行此指令程式。 雖然本主題已列出這個指令程式的所有參數,不過,如果某些參數並未包含在指派給您的權限中,您可能就無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限,請參閱 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" 的資料分類規則。

前三個命令會傳回資料分類中的檔指紋清單。 清單中第一個文件指紋的索引號碼是 0、第二個的索引號碼是 1,以此類推。 您可以使用索引號碼來指定您想要移除的文件指紋。 最後兩個命令會移除清單中顯示的第一個檔指紋。

參數

-Confirm

Confirm 參數會指定要顯示或隱藏確認提示。 這個參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續作業。

  • 例如,具破壞性的 Cmdlet (例如 Remove-* Cmdlet) 內建暫停,可強制您在繼續之前確認命令。 對於這些 Cmdlet,您可以使用以下確切語法來略過確認提示:-Confirm:$false
  • 其他大部分的 Cmdlet (例如,New-* 和 Set-* Cmdlet) 沒有內建暫停。 在使用這些 Cmdlet 時,指定不含任何值的 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 參數會指定此 Cmdlet 用來向 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-指紋 或範例一節。 如需如何從現有資料分類規則中新增和移除文件指紋的指示,請參閱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
  • 身分識別 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 網頁版中呈現給使用者的原則提示中。 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

若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型),請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的,表示指令程式不會傳回資料。