Set-DlpSensitiveInformationType

內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 某些參數和設定可能僅限於一個環境或另一個環境。

使用 Set-DlpSensitiveInformationType Cmdlet 來修改使用文件指紋的敏感資訊類型規則。

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

語法

Default (預設值)

Set-DlpSensitiveInformationType
    [-Identity] <SensitiveInformationTypeIdParameter>
    [-Confirm]
    [-Description <String>]
    [-FileData <Byte[]>]
    [-Fingerprints <MultiValuedProperty>]
    [-IsExact <Boolean>]
    [-Locale <CultureInfo>]
    [-Name <String>]
    [-Threshold <UInt32>]
    [-ThresholdConfig <PswsHashtable>]
    [-WhatIf]
    [<CommonParameters>]

Description

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

您必須已獲指派權限,才能執行此指令程式。 雖然本文列出 Cmdlet 的所有參數,但如果指派給您的權限中未包含某些參數,您可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限,請參閱 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 機密」的現有敏感資訊類型規則,而不會影響任何已定義的現有文件指紋。

範例 4

$cc = Get-DlpSensitiveInformationType "Contoso Confidential"

$a = [System.Collections.ArrayList]($cc.Fingerprints)

$a

$a.RemoveAt(0)

Set-DlpSensitiveInformationType $cc.Identity -FingerPrints $a

此範例修改名為「Contoso 機密」的敏感性資訊類型規則,方法是移除現有的文件指紋,而不影響已定義的其他文件指紋。

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

參數

-Confirm

適用對象:安全性 & 合規性

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

  • 破壞性的 Cmdlet (如 Remove-* cmdlets) 有內建暫停,它會先強迫您確認命令才會繼續作業。 對於這些 Cmdlet,您可以使用以下確切語法來略過確認提示:-Confirm:$false。
  • 其他大部分的 Cmdlet (如 New-* 和 Set-* cmdlets) 則沒有內建暫停。 針對這些 Cmdlet,指定不帶值的 Confirm 參數會造成暫停,強制您在繼續之前先確認命令。

此 Cmdlet 具有內建的暫停,因此請使用 -Confirm:$false 來略過確認。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False
別名:CF

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Description

適用對象:安全性 & 合規性

描述參數會指定敏感資訊類型規則的描述。 您可以使用 [描述] 參數搭配 [地區設定] 和 [名稱] 參數來指定不同語言的敏感資訊類型規則描述。 [描述] 的當地語系化值會出現在敏感資訊類型規則的 AllLocalizedDescriptions 屬性中。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-FileData

適用對象:安全性 & 合規性

{{ 填滿檔案資料描述 }}

參數屬性

類型:

Byte[]

預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Fingerprints

適用對象:安全性 & 合規性

Fingerprints 參數會指定敏感資訊類型規則用作指紋的位元組編碼文件檔案。 如需如何匯入文件以做為指紋範本的指示,請參閱 New-DlpFingerprint 或範例一節。 如需如何從現有的敏感資訊類型規則中新增和移除文件指紋的指示,請參閱範例一節。

參數屬性

類型:MultiValuedProperty
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Identity

適用對象:安全性 & 合規性

此 Identity 參數會指定您要修改的敏感資訊類型規則。 您可以使用唯一識別敏感資訊類型規則的任何值。 例如:

  • 名稱
  • LocalizedName
  • 身分識別 GUID 值

參數屬性

類型:SensitiveInformationTypeIdParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:1
必要:True
來自管線的值:True
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-IsExact

適用對象:安全性 & 合規性

{{ 填滿 IsExact 說明 }}

參數屬性

類型:Boolean
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Locale

適用對象:安全性 & 合規性

Locale 參數會新增或移除與敏感資訊類型規則相關聯的語言。

此參數的有效輸入是來自 Microsoft .NET Framework CultureInfo 類別的支援文化代碼值。 例如,丹麥文為 da-DK 或日文為 ja-JP。 如需詳細資訊,請參閱 CultureInfo 類別。

一般而言,您會使用 [地區設定] 參數搭配 [名稱] 和 [描述] 參數,以新增或移除敏感資訊類型規則的已翻譯名稱和描述。 您也可以搭配使用 Locale 參數與 IsDefault 切換,以指定現有的已翻譯名稱和描述作為預設值。 您需要先將另一個翻譯設定為預設值,才能移除預設翻譯。

參數屬性

類型:CultureInfo
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Name

適用對象:安全性 & 合規性

Name 參數會指定敏感資訊類型規則的名稱。 值必須小於 256 個字元。

您可以使用 Name 參數搭配 [地區設定] 和 [描述] 參數來指定不同語言的敏感資訊類型規則名稱。 Name 的當地語系化值會出現在敏感資訊類型規則的 AllLocalizedNames 屬性中。

Name 參數的值會用於在 Outlook 網頁版中顯示給使用者的 [原則秘訣]。 Name 參數的已翻譯值符合用戶端的語言時,會以用戶端的語言顯示 [原則提示]。 如果 Name 參數的已翻譯值不符合用戶端的語言時,則 IsDefault 參數所指定的預設翻譯是用於 [原則提示]。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Threshold

適用對象:安全性 & 合規性

{{ 填滿閾值說明 }}

參數屬性

類型:UInt32
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ThresholdConfig

適用對象:安全性 & 合規性

{{ Fill ThresholdConfig 描述 }}

參數屬性

類型:PswsHashtable
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-WhatIf

適用對象:安全性 & 合規性

WhatIf 開關無法在安全性與合規性 PowerShell 中使用。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False
別名:WI

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

CommonParameters

此 Cmdlet 支援常見參數: -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。