體驗O365中的EXOPSV2 之十 通過EXOPSV2獲取收件人信息

體驗O365中的EXOPSV2 之十 通過EXOPSV2獲取收件人信息

在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>
體驗O365中的EXOPSV2 之十 通過EXOPSV2獲取收件人信息

2、直接使用默認參數值獲取前1000個收件人對象的默認最小屬性集

<code>Get-EXORecipient/<code>
體驗O365中的EXOPSV2 之十 通過EXOPSV2獲取收件人信息

3、獲取所有收件人對象的默認最小屬性集

<code>Get-EXORecipient -ResultSize Unlimited/<code>
體驗O365中的EXOPSV2 之十 通過EXOPSV2獲取收件人信息

4、獲取指定收件人對象的最小屬性集

<code>Get-EXORecipient zhangsan/<code>
體驗O365中的EXOPSV2 之十 通過EXOPSV2獲取收件人信息

5、獲取郵件聯繫人類型的收件人屬性信息

<code>Get-EXORecipient -RecipientType MailContact/<code>
體驗O365中的EXOPSV2 之十 通過EXOPSV2獲取收件人信息

6、獲取共享郵箱子類的收件人屬性信息

<code>Get-EXORecipient -RecipientTypeDetails SharedMailbox/<code>
體驗O365中的EXOPSV2 之十 通過EXOPSV2獲取收件人信息


分享到:


相關文章: