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。