悅享人永久鏈接：http://yxzhao.com/2013/filters-in-recipient-shell-commands/
轉載請註明出處：悅享人-《Exchange 收件人命令行中的 filters》
可以使用多個 Exchange 命令行管理程序命令篩選一組收件人。可以在 Exchange 命令中創建下列類型的篩選器：
- 固有篩選器
- 使用 RecipientFilter 參數的自定義篩選器
- 使用 Filter 參數的自定義篩選器
- 使用 ContentFilter 參數的自定義篩選器
一、固有篩選器
“固有篩選器”是一種常用的 Exchange 篩選器，可用於滿足多種收件人篩選條件以創建動態通訊組、電子郵件地址策略、地址列表或 GAL。 使用固有篩選器時，可以使用 Exchange 命令行管理程序，也可以使用 Exchange 管理中心 (EMC)。 使用固有篩選器，可以執行下列操作：
- 確定收件人的範圍。
- 根據屬性（如公司、部門和國家/地區）添加有條件的篩選。
- 添加收件人的自定義屬性。 有關詳細信息，請參閱自定義屬性。
-下列參數視爲固有篩選器
IncludedRecipients
ConditionalCompany
ConditionalDepartment
ConditionalStateOrProvince
ConditionalCustomAttribute1–15.
-固有篩選器適用於下列 cmdlet
New-DynamicDistributionGroup
Set-DynamicDistributionGroup
New-EmailAddressPolicy
Set-EmailAddressPolicy
New-AddressList
Set-AddressList
New-GlobalAddressList
Set-GlobalAddressList
-示例
本示例介紹如何在命令行管理程序中使用固有篩選器創建動態通訊組。 本示例中的語法與用於創建電子郵件地址策略、地址列表或 GAL 的語法相似，但不完全相同。創建固有篩選器時，應提出下列問題：
希望包含哪個組織單位 (OU) 中的收件人？ （此問題對應於 RecipientContainer 參數。）
希望包含哪種類型的收件人？ （此問題對應於 IncludedRecipients 參數。）
希望在篩選器中包含哪些其他條件？ （此問題對應於 ConditionalCompany、ConditionalDepartment、ConditionalStateOrProvince 和 ConditionalCustomAttribute 參數。）
本示例爲 OU Contoso.com/Users 中的用戶郵箱創建動態通訊組 Contoso Finance，並指定條件以便僅包括 Department 屬性定義爲 Finance 且 Company 屬性定義爲 Contoso 的收件人。
|
1
|
New-DynamicDistributionGroup -Name "Contoso Finance" -OrganizationalUnit Contoso.com/Users -RecipientContainer Contoso.com/Users -IncludedRecipients MailboxUsers -ConditionalDepartment "Finance" -ConditionalCompany "Contoso" |
本示例顯示此新動態通訊組的屬性。
|
1
|
Get-DynamicDistributionGroup -Identity "Contoso Finance" | Format-List Recipient*,Included* |
二、使用 RecipientFilter 參數的自定義篩選器
如果固有篩選器不滿足創建或修改動態通訊組、電子郵件地址策略和地址列表的要求，則可通過使用 RecipientFilter 參數創建自定義篩選器。
-收件人篩選器參數適用於下列 cmdlet
New-DynamicDistributionGroup
Set-DynamicDistributionGroup
New-EmailAddressPolicy
Set-EmailAddressPolicy
New-AddressList
Set-AddressList
New-GlobalAddressList
Set-GlobalAddressList
有關可以與 RecipientFilter 參數一起使用的可篩選屬性的詳細信息，請參閱-RecipientFilter 參數的可篩選屬性。
-示例
以下示例使用 RecipientFilter 參數創建動態通訊組。 本示例中的語法與用於創建電子郵件地址策略、地址列表或 GAL 的語法相似，但不完全相同。
本示例使用自定義篩選器爲 Company 屬性定義爲 Contoso 且 Office 屬性定義爲 North Building 的用戶郵箱創建動態通訊組。
|
1
|
New-DynamicDistributionGroup -Name AllContosoNorth -OrganizationalUnit contoso.com/Users -RecipientFilter { ((RecipientType -eq 'UserMailbox') -and (Company -eq 'Contoso') -and (Office -eq 'North Building')) } |
三、使用 Filter 參數的自定義篩選器
可以使用 Filter 參數篩選命令結果，以指定要檢索的對象。 例如，可以通過使用篩選字符串指定一組用戶或組，而不是檢索所有的用戶或組。這種類型的篩選器不修改對象的任何配置或屬性，它只修改命令返回的對象集。
使用 Filter 參數修改命令結果稱爲“服務器端篩選”。服務器端篩選將命令和篩選器提交給服務器進行處理。命令行管理程序還支持客戶端篩選，在客戶端篩選中，命令從服務器檢索所有對象，然後在本地控制檯窗口中應用篩選器。若要執行客戶端篩選，使用 Where-Object cmdlet。有關服務器端篩選和客戶端篩選的詳細信息，請參閱處理命令輸出中的“如何篩選數據”。
若要爲具有 Filter 參數的 cmdlet 查找可篩選屬性，可以對對象運行 Get 命令並通過管道傳遞 Format-List 參數來設置輸出格式。 大多數返回值將可以在 Filter 參數中使用。 以下示例返回郵箱 Ayla 的詳細列表。
|
1
|
Get-Mailbox -Identity Ayla | Format-List |
-Filter 參數適用於下列 cmdlet
Get-ActiveSyncDevice
Get-ActiveSyncDeviceClass
Get-CASMailbox
Get-Contact
Get-DistributionGroup
Get-DynamicDistributionGroup
Get-Group
Get-Mailbox
Get-MailboxStatistics
Get-MailContact
Get-MailPublicFolder
Get-MailUser
Get-Message
Get-MobileDevice
Get-Queue
Get-QueueDigest
Get-Recipient
Get-RemoteMailbox
Get-RoleGroup
Get-SecurityPrincipal
Get-StoreUsageStatistics
Get-ThrottlingPolicyAssociation
Get-UMMailbox
Get-User
Get-UserPhoto
Remove-Message
Resume-Message
Resume-Queue
Retry-Queue
Suspend-Message
Suspend-Queue
-示例
本示例使用 Filter 參數返回有關 title 包含單詞 “manager” 的用戶的信息。
|
1
|
Get-User -Filter {Title -like 'Manager*'} |
四、使用 ContentFilter 參數的自定義篩選器
使用 New-MailboxExportRequest cmdlet 時，可以使用 ContentFilter 參數以選擇特定郵件內容進行導出。 如果該命令找到包含與內容篩選器匹配的內容的郵件，會將該郵件導出爲 .pst 文件。
-示例
本示例創建一個導出請求，該請求在 Ayla 的郵箱中搜索正文包含短語 “company prospectus” 的郵件。 如果找到此短語，則命令會將具有此短語的所有郵件導出爲 .pst 文件。
|
1
|
New-MailboxExportRequest -Mailbox Ayla -ContentFilter {Body -like "company prospectus*"} |
五、其他 OPATH 語法信息
創建自己的自定義篩選器時，應注意以下內容：
- 使用大括號 { } 將具有 Filter 或 RecipientFilter 參數的整個 OPATH 語法字符串括起來。
- 所有的運算符之前都要包含連字符。 最常用的運算符包括：
-and
-or
-not
-eq（等於）
-ne（不等於）
-lt（小於）
-gt（大於）
-like（字符串比較）
-notlike（字符串比較） - RecipientFilter 和 Filter 參數的許多屬性都接受通配符。 如果使用通配符，請使用 like 運算符，而不要使用 eq 運算符。 like 運算符可用於查找多種類型（諸如字符串）的模式匹配項，而 eq 運算符可用於查找完全匹配項。
- 運行下列命令獲得可使用的運算符的相關信息：
12
Help about_logical_operatorHelp about_comparison_operator - 收件人類型的大多數屬性可用於創建篩選器字符串。