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、Exchange Server SE、安全性 & 合規性

Action 參數會指定套用篩選的搜尋動作類型。 此參數的有效值為 [全部]，表示篩選器已套用至所有搜尋動作。

• 匯出：匯出搜尋結果或準備搜尋結果以在電子文件探索進階版中進行分析時，會套用篩選。
• 預覽：預覽搜尋結果時會套用篩選。
• 清除：清除搜尋結果時會套用篩選。 項目的刪除方式由 New-ComplianceSearchAction Cmdlet 上的 PurgeType 參數值所控制。 預設值為 SoftDelete，這表示在刪除的項目保留期間到期之前，使用者可以復原已清除的項目。
• 搜尋：執行搜尋時會套用篩選。
• Search：執行搜尋時才會套用篩選器。

參數屬性

參數集

-Confirm

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

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

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

參數屬性

參數集

-Description

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

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

參數屬性

參數集

-FilterName

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

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

參數屬性

參數集

-Filters

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

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

• 信箱篩選：指定指派的使用者可以搜尋的信箱。 有效的語法是 Mailbox_<MailboxPropertyName>，其中 <MailboxPropertyName> 是信箱屬性值。 例如，"Mailbox_CustomAttribute10 -eq 'OttawaUsers'" 允許使用者只搜尋 CustomAttribute10 屬性中具有 OttawaUsers 值的信箱。 有關支援的信箱屬性清單，請參閱 RecipientFilter 參數的可篩選屬性。
• 信箱內容篩選器：指定指派的使用者可以搜尋的信箱內容。 有效的語法是 MailboxContent_<SearchablePropertyName>，其中<SearchablePropertyName>指定可在合規性搜尋中指定的關鍵字查詢語言 (KQL) 屬性。 例如， "MailboxContent_Recipients -like 'contoso.com'" 允許使用者只搜尋傳送給 contoso.com 網域中收件者的郵件。 如需可搜尋電子郵件屬性的清單，請參閱 eDiscovery 的關鍵字查詢。
• 網站與網站內容篩選器：您可以建立兩個 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、Exchange Server SE、安全性 & 合規性

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

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

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

參數屬性

參數集

-Users

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

Users 參數會指定讓此篩選套用至其搜尋的使用者。 有效值為：

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

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

您指定的值會覆寫任何現有項目。 請參閱 [範例] 區段以新增或移除使用者，而不會影響其他現有項目。

參數屬性

參數集

-WhatIf

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

WhatIf 參數會顯示命令在不進行任何變更的情況下執行的動作。 您不需要使用此參數指定值。

參數屬性

參數集

CommonParameters