Set-SensitiveInformationScanRule
此 Cmdlet 僅適用於安全性與合規性 PowerShell。 如需詳細資訊,請參閱 安全性與合規性 PowerShell。
使用 Set-SensitiveInformationScan Cmdlet 修改敏感性資訊掃描規則。
如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法。
語法
Default (預設值)
Set-SensitiveInformationScanRule
[-Identity] <ComplianceRuleIdParameter>
[-Comment <String>]
[-Confirm]
[-ContentCreatedOrUpdatedDateFrom <System.DateTime>]
[-ContentCreatedOrUpdatedDateTo <System.DateTime>]
[-ContentExtensionMatchesWords <MultiValuedProperty>]
[-ContentPropertyContainsWords <MultiValuedProperty>]
[-ExceptIfContentExtensionMatchesWords <MultiValuedProperty>]
[-ExceptIfContentPropertyContainsWords <MultiValuedProperty>]
[-StartImpactAssessment <Boolean>]
[-WhatIf]
[-Workload <PolicyConfiguration.Workload>]
[<CommonParameters>]
Description
若要在安全性與合規性 PowerShell 中使用此 Cmdlet,您必須獲得指派權限。 如需詳細資訊,請參閱 Microsoft Purview 合規性入口網站中的權限。
範例
範例 1
Set-SensitiveInformationScanRule "SharePoint scan rule1" -ContentExtensionMatchesWords "pdf","docx,csv" -StartImpactAssessment $true
此範例會更新隨選分類掃描,以分類 PDF、docx 和 csv 檔案類型。
參數
-Comment
適用對象:安全性 & 合規性
Comment 參數會指定選擇性註解。 如果指定的值含有空格,則必須以雙引號 (") 括住值,例如︰"This is an admin note"。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Confirm
適用對象:安全性 & 合規性
Confirm 參數會指定要顯示或隱藏確認提示。 此參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續。
- 破壞性的 Cmdlet (如 Remove-* cmdlets) 有內建暫停,它會先強迫您確認命令才會繼續作業。 對於這些 Cmdlet,您可以使用以下確切語法來略過確認提示:
-Confirm:$false。 - 其他大部分的 Cmdlet (如 New-* 和 Set-* cmdlets) 則沒有內建暫停。 針對這些 Cmdlet,指定不帶值的 Confirm 參數會造成暫停,強制您在繼續之前先確認命令。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | CF |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ContentCreatedOrUpdatedDateFrom
適用對象:安全性 & 合規性
ContentCreatedOrUpdatedDateFrom 參數會指定此掃描範圍內視為之檔案的最早修改日期 - 時間。
若要指定這個參數的日期/時間值,請使用下列其中一個選項︰
- 以 UTC 指定日期/時間值:例如,「2021-05-06 14:30:00z」。
- 將日期/時間值指定為將當地時區的日期/時間轉換為 UTC 的公式:例如,
(Get-Date "5/6/2021 9:30 AM").ToUniversalTime()。 如需詳細資訊,請參閱 Get-Date。
參數屬性
| 類型: | System.DateTime |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ContentCreatedOrUpdatedDateTo
適用對象:安全性 & 合規性
ContentCreatedOrUpdatedDateTo 參數會指定視同掃描範圍內之檔案的最新修改日期 - 時間。
若要指定這個參數的日期/時間值,請使用下列其中一個選項︰
- 以 UTC 指定日期/時間值:例如,「2021-05-06 14:30:00z」。
- 將日期/時間值指定為將當地時區的日期/時間轉換為 UTC 的公式:例如,
(Get-Date "5/6/2021 9:30 AM").ToUniversalTime()。 如需詳細資訊,請參閱 Get-Date。
參數屬性
| 類型: | System.DateTime |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ContentExtensionMatchesWords
適用對象:安全性 & 合規性
ContentExtensionMatchesWords 參數會指定規則的條件,以尋找副檔名中的文字。 您可以指定多個以逗號分隔的文字。 無論原始檔類型為何,此述詞會根據檔案名稱中存在的副檔名進行比對。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ContentPropertyContainsWords
適用對象:安全性 & 合規性
ContentPropertyContainsWords 參數會根據內容中的屬性相符,指定規則的條件。 此規則會套用到包含指定屬性的內容。
此參數接受下列格式的值: "Property1:Value1,Value2","Property2:Value3,Value4",..."PropertyN:ValueN,ValueN"。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ExceptIfContentExtensionMatchesWords
適用對象:安全性 & 合規性
ExceptIfContentExtensionMatchesWords 參數會指定在副檔名中尋找文字的規則例外。 您可以指定多個以逗號分隔的文字。 無論原始檔類型為何,此述詞會根據檔案名稱中存在的副檔名進行比對。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ExceptIfContentPropertyContainsWords
適用對象:安全性 & 合規性
ExceptIfContentPropertyContainsWords 參數會根據內容中屬性相符項目指定 DLP 規則的例外狀況。 此規則不會套用到包含指定之屬性的內容。
此參數接受下列格式的值: "Property1:Value1,Value2","Property2:Value3,Value4",..."PropertyN:ValueN,ValueN"。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Identity
適用對象:安全性 & 合規性
Identity 參數指定您要修改的敏感性資訊掃描規則。 您可以使用唯一識別規則的任何值。 例如:
- 名稱
- 辨別名稱 (DN)
- GUID
參數屬性
| 類型: | ComplianceRuleIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-StartImpactAssessment
適用對象:安全性 & 合規性
StartImpactAssessment 參數會指定是否要開始掃描估計。 有效值為:
- $true:預設會開始掃描估計。
- $false:預設為防止啟動掃描估計。
參數屬性
| 類型: | Boolean |
| 預設值: | 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 |
-Workload
適用對象:安全性 & 合規性
Workload 參數會指定工作負載。 有效值為:
- 應用程式
- AuditAlerting
- AWS
- Azure
- AzureBatch
- Copilot
- DynamicScope
- EndpointDevices
- Exchange
- ExchangeOnPremises
- Intune
- ModernGroup
- OneDriveForBusiness
- OnPremisesScanner
- PowerBI
- PublicFolder
- SharePoint
- SharePointOnPremises
- Skype
- 基材
- Teams
- ThirdPartyApps
- UnifiedAuditAzure
這個值會出現在 Get-SensitiveInformationScanRule cmdlet 輸出中的 LogicalWorkload 屬性中。
參數屬性
| 類型: | PolicyConfiguration.Workload |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援常見參數: -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。
備註
- 您無法在 ClassificationInProgress 和 ClassificationComplete 狀態中修改規則。
- 您必須將 StartImpactAssessment 參數與值 $true 搭配使用,才能重新啟動估算。 否則,掃描會保持 ImpactAssessmentRequired 狀態。