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 狀態。