在Exchange Online中處理用戶郵箱之外,還包括大量的其它收件對象。因此,無論是用戶郵箱,還是資源郵箱、會議室郵箱、共享郵箱、聯繫人、通訊組等,在Exchange Online中都被定義為收件人。之前基本都是關於用戶郵箱的各種Exchange Online PowerShell V2使用體驗,接下來將對象的範圍擴大到收件人這一層進行體驗。
一、Get-EXORecipient命令
在Exchange Online PowerShell V2模塊中獲取郵箱對象和對應對象的屬性,以及屬性值,可以通過Get-EXORecipient(或EXORecipient)命令來實現。同時,該命令還可以為其它任務提供郵箱信息。
該命令的作用類似於舊版Exchange Online PowerShell的Get-Recipient命令的功能,但根據微軟的介紹,提高了返回輸出效率和擴展了功能。
默認返回所有已啟用郵件的對象。包括:用戶郵箱、郵件用戶、郵件聯繫人、通訊組、共享郵箱、會議室郵箱、資源郵箱等等。
1、完整語法
EXORecipient
[-Filter <string>]/<string>
[-OrganizationalUnit <string>]/<string>
[-Properties <string>]/<string>
[-PropertySets <propertyset>]/<propertyset>
[-IncludeSoftDeletedRecipients]
[-RecipientType <string>]/<string>
[-RecipientTypeDetails <string>]/<string>
[[-Identity] <string>]/<string>
[-ExternalDirectoryObjectId <guid>]/<guid>
[-UserPrincipalName <string>]/<string>
[-ResultSize <unlimited>]/<unlimited>
[<commonparameters>]/<commonparameters>
或
EXORecipient
[-Anr <string>]/<string>
[-Filter <string>]/<string>
[-OrganizationalUnit <string>]/<string>
[-Properties <string>]/<string>
[-PropertySets <propertyset>]/<propertyset>
[-IncludeSoftDeletedRecipients]
[-RecipientType <string>]/<string>
[-RecipientTypeDetails <string>]/<string>
[-ResultSize <unlimited>]/<unlimited>
[<commonparameters>]/<commonparameters>
2、參數說明
Anr:
指定用於模糊查詢的字符串。命令將返回在某些屬性的值中包含該參數指定字符串的對象。具體參考Get-EXOCsaMailbox的Anr參數。
ExternalDirectoryObjectId:
指定Azure Active Directory中收件人的ObjectId標識來檢索查找顯示要查看的收件人。
具體參考Get-EXOCsaMailbox的ExternalDirectoryObjectId參數。
Filter:
使用OPath語法對查詢的結果進行基於屬性和屬性值的篩選和查找。
具體參考Get-EXOCsaMailbox的Filter參數。
Identity:
指定查看的收件人。
具體參考Get-EXOCsaMailbox的Identity參數。
IncludeSoftDeletedRecipients:
指定返回被軟刪除的收件人。要執行該參數,必須要為組織管理員角色,或角色管理員角色。
其默認值為None。
OrganizationalUnit:
指定篩選對象所在AD中的OU名稱。
具體參考Get-EXOCsaMailbox的OrganizationalUnit參數。
Properties:
指定命令返回輸出的屬性。
具體參考Get-EXOCsaMailbox的Properties參數。
PropertySet:
指定命令返回輸出的屬性邏輯集,該命令支持的有效值有:
- Minimum(該集合為命令默認輸出)
- Archive
- Custom
- Policy
- MailboxMove
該參數默認為None。
RecipientType:
指定命令返回的結果按哪種收件人類型進行篩選,該參數的值可以是:
- DynamicDistributionGroup
- MailContact
- MailNonUniversalGroup
- MailUniversalDistributionGroup
- MailUniversalSecurityGroup
- MailUser
- PublicFolder
- UserMailbox
該參數默認為None。
RecipientTypeDetails:
指定命令返回的結果按收件人的哪種子類型進行篩選,該參數的值剋是:
- DiscoveryMailbox
- DynamicDistributionGroup
- EquipmentMailbox
- GroupMailbox
- GuestMailUser
- LegacyMailbox
- LinkedMailbox
- LinkedRoomMailbox
- MailContact
- MailForestContact
- MailNonUniversalGroup
- MailUniversalDistributionGroup
- MailUniversalSecurityGroup
- MailUser
- PublicFolder
- PublicFolderMailbox
- RemoteEquipmentMailbox
- RemoteRoomMailbox
- RemoteSharedMailbox
- RemoteTeamMailbox
- RemoteUserMailbox
- RoomList
- RoomMailbox
- SchedulingMailbox
- SharedMailbox
- TeamMailbox
- UserMailbox
該參數默認為None。
ResultSize:
指定要返回的最大查詢條目數。
具體參考Get-EXOCsaMailbox的ResultSize參數。
UserPrincipalName:
指定要查看收件人的UPN。其默認值為None。
二、體驗Get-EXORecipient
1、連接到Office 365的Exchange Online組織。
<code>Connect-ExchangeOnline -UserPrincipalName [email protected] -ExchangeEnvironmentName O365China/<code>
2、直接使用默認參數值獲取前1000個收件人對象的默認最小屬性集
<code>Get-EXORecipient/<code>
3、獲取所有收件人對象的默認最小屬性集
<code>Get-EXORecipient -ResultSize Unlimited/<code>
4、獲取指定收件人對象的最小屬性集
<code>Get-EXORecipient zhangsan/<code>
5、獲取郵件聯繫人類型的收件人屬性信息
<code>Get-EXORecipient -RecipientType MailContact/<code>
6、獲取共享郵箱子類的收件人屬性信息
<code>Get-EXORecipient -RecipientTypeDetails SharedMailbox/<code>
閱讀更多 技術直通車 的文章
關鍵字: 收件人 之十 PowerShell