Set-ComplianceSecurityFilter

語法

Default (預設值)

Set-ComplianceSecurityFilter
    -FilterName <String>
    [-Action <ComplianceSecurityFilterActionType>]
    [-Confirm]
    [-Description <String>]
    [-Filters <MultiValuedProperty>]
    [-Region <String>]
    [-Users <MultiValuedProperty>]
    [-WhatIf]
    [<CommonParameters>]

Description

範例

範例 1

$filterusers = Get-ComplianceSecurityFilter -FilterName "Ottawa Users Filter"

$filterusers.users.add("pilarp@contoso.com")

Set-ComplianceSecurityFilter -FilterName "Ottawa Users Filter" -Users $filterusers.users

範例 2

$filterusers = Get-ComplianceSecurityFilter -FilterName "Ottawa Users Filter"

$filterusers.users.remove("annb@contoso.com")

Set-ComplianceSecurityFilter -FilterName "Ottawa Users Filter" -Users $filterusers.users

參數

-Action

適用：Exchange Server 2016 Exchange Server 2019 安全性 & 合規性

Action 參數會指定套用篩選條件的搜尋動作類型。 此參數的有效值為 All，這表示篩選會套用至所有搜尋動作。

• 匯出：導出搜尋結果或準備在 eDiscovery Premium 中進行分析時，會套用篩選條件。
• 預覽：預覽搜尋結果時會套用篩選。
• 清除：清除搜尋結果時會套用篩選。 項目刪除方式是由 New-ComplianceSearchAction Cmdlet 上的 PurgeType 參數值所控制。 默認值為 SoftDelete，這表示用戶可復原已清除的專案，直到刪除的專案保留期間到期為止。
• 搜尋：執行搜尋時會套用篩選。
• Search：執行搜尋時才會套用篩選器。

參數屬性

參數集

-Confirm

適用：Exchange Server 2016 Exchange Server 2019 安全性 & 合規性

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

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

參數屬性

參數集

-Description

適用：Exchange Server 2016 Exchange Server 2019 安全性 & 合規性

Description 參數會指定合規性安全性篩選的描述。 最大長度為 256 個字元。 如果值包含空格，請使用引號 (") 括住值。

參數屬性

參數集

-FilterName

適用：Exchange Server 2016 Exchange Server 2019 安全性 & 合規性

FilterName 參數會指定您要修改之合規性安全性篩選的名稱。 如果值包含空格，請使用引號 (") 括住值。

參數屬性

參數集

-Filters

適用：Exchange Server 2016 Exchange Server 2019 安全性 & 合規性

Filters 參數會指定符合性安全性篩選器的搜尋準則。 您可以建立三個不同類型的篩選器：

• 信箱篩選：指定可由指派的用戶搜尋的信箱。 有效的語法是 Mailbox_<MailboxPropertyName>，其中 <MailboxPropertyName> 是信箱屬性值。 例如，"Mailbox_CustomAttribute10 -eq 'OttawaUsers'" 只允許使用者在 CustomAttribute10 屬性中搜尋值為[MarketplaceUsers] 的信箱。 如需支援的信箱屬性清單，請 參閱 RecipientFilter 參數的可篩選屬性。
• 信箱內容篩選：指定指派的使用者可以搜尋的信箱內容。 有效的語法為 MailboxContent_<SearchablePropertyName>，其中 <SearchablePropertyName> 指定可在合規性搜尋中指定的關鍵詞查詢語言 (KQL) 屬性。 例如， "MailboxContent_Recipients -like 'contoso.com'" 允許使用者只搜尋傳送給 contoso.com 網域中收件者的郵件。 如需可搜尋的電子郵件屬性清單，請參閱 電子檔探索的關鍵詞查詢。
• 網站和網站內容篩選：您可以建立兩個 SharePoint 和 OneDrive 網站相關篩選： Site_<SearchableSiteProperty> (指定網站相關屬性。例如，"Site_Path -eq 'https://contoso.sharepoint.com/sites/doctors'" 允許使用者只搜尋網站集合中https://contoso.sharepoint.com/sites/doctors的內容) ， (SiteContent_<SearchableSiteProperty> 指定內容相關的屬性。例如， "SiteContent_FileExtension -eq 'docx'" 允許使用者只搜尋 Word 檔) 。 如需可搜尋的網站屬性清單，請參閱 SharePoint Server 中編目和受控屬性的概觀。 在 [可查詢] 欄中標示為 [是] 的內容可以用來建立網站或網站內容篩選器。

您可以指定相同類型的多個篩選條件。 例如，"Mailbox_CustomAttribute10 -eq 'FTE' -and Mailbox_MemberOfGroup -eq '$($DG.DistinguishedName)'"。

參數屬性

參數集

-Region

適用：Exchange Server 2016 Exchange Server 2019 安全性 & 合規性

Region 參數會指定多地理位置租使用者在其中進行電子檔探索搜尋的衛星位置。 有效值為：

• APC：Asia-Pacific
• AUS：澳大利亞
• CAN：加拿大
• 歐洲：歐洲、中東、非洲
• FRA：法國
• GBR：英國
• IND：印度
• JPN：日本
• LAM：拉丁美洲
• NAM：北美洲

如果您未在多地理位置租使用者中使用此參數，則會在中央位置執行電子檔探索搜尋。

參數屬性

參數集

-Users

適用：Exchange Server 2016 Exchange Server 2019 安全性 & 合規性

Users 參數會指定取得套用至其搜尋之篩選條件的使用者。 有效值為：

• 一或多位使用者：依其別名或電子郵件地址識別使用者。 您可以指定多個以逗號分隔的值。
• 值 All：將篩選指派給所有使用者。 您只能單獨使用此值。
• 一或多個角色群組：依其名稱識別角色群組。 您可以指定多個以逗號分隔的值。

使用此參數，無法指定通訊群組。

您指定的值會覆寫任何現有的專案。 請參閱一節，以新增或移除使用者，而不會影響其他現有的專案。

參數屬性

參數集

-WhatIf

適用：Exchange Server 2016 Exchange Server 2019 安全性 & 合規性

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

參數屬性

參數集

CommonParameters