Get-Recipient (RTM)

  • 發行項

 

適用版本： Exchange Server 2007

上次修改主題的時間： 2008-04-16

使用 Get-Recipient 指令程式，從 Active Directory 目錄服務中傳回收件者物件清單。

語法

get-Recipient [-Identity <RecipientIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientType <RecipientType[]>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

get-Recipient [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientType <RecipientType[]>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

get-Recipient [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientType <RecipientType[]>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

詳細描述

Get-Recipient 指令程式可擷取指定收件者的屬性。不需要參數。若沒有利用參數執行 指令程式，就會傳回組織的完整收件者清單。

若要執行 Get-Recipient 指令程式，必須對您使用的帳戶委派下列項目：

  • Exchange 僅檢視管理角色

如需管理 Exchange Server 2007 所需之權限、委派角色及權利的相關資訊，請參閱權限考量。

參數

參數 必要 類型 描述

Anr

選用

System.String

Anr 參數可指定執行不明確名稱解析 (ANR) 搜尋的字串。您可以指定部分字串，並搜尋具有與該字串相符之屬性的物件。所搜尋的預設屬性如下：

  • CommonName (CN)
  • DisplayName (displayName)
  • FirstName (givenName)
  • LastName (sn)
  • Alias (mailNickname)

Credential

選用

System.Management.Automation.PSCredential

Credential 參數可指定用於存取 Active Directory 的使用者名稱與密碼。

如果使用 Credential 參數，則在繼續之前，命令會先提示輸入帳戶的密碼。

DomainController

選用

Microsoft.Exchange.Data.Fqdn

若要指定將此組態變更寫入至 Active Directory 之網域控制站的網域全名 (FQDN)，請在命令中加入 DomainController 參數。

Filter

選用

System.String

使用 Filter 參數可指定一或多個屬性，用於限制查詢所傳回的收件者。此參數無法與 Identity 參數或 Anr 參數一起使用。

如需可過濾內容的相關資訊，請參閱-Filter 參數的可篩選內容。

Identity

選用

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter

Identity 參數會識別收件者。您可以使用下列其中一個值：

  • GUID
  • 網域\帳戶
  • 使用者主要名稱 (UPN)
  • LegacyExchangeDN
  • 簡易郵件傳送通訊協定 (SMTP) 位址
  • 名稱
  • 別名

OrganizationalUnit

選用

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

OrganizationalUnit 參數可指定組織單位 (OU) 或網域標準名稱，並用於限制結果。若您使用此參數，則只會取得您所指定之容器中的收件者。例如：

  • OU:westcoast.contoso.com/users
  • Domain:westcoast.contoso.com

ReadFromDomainController

選用

System.Management.Automation.SwitchParameter

ReadFromDomainController 參數指定從使用者網域的網域控制站讀取使用者資訊。如果您將收件者範圍設定為包含所有樹系中的收件者，且如果您不使用此參數，則可能會從通用類別目錄讀取含有過時資訊的使用者資訊。如果使用此參數，則可能需要多次讀取才能取得資訊。

note附註：
依預設，收件者範圍會設為主控您的 Exchange 伺服器之網域。

RecipientType

選用

Microsoft.Exchange.Data.Directory.Recipient.RecipientType[]

RecipientType 參數是一種篩選器，可指定要包含在通訊清單中的收件者類型。您可以使用下列一或多種類型：

  • UserMailbox
  • MailUser
  • MailContact
  • MailUniversalDistributionGroup
  • MailUniversalSecruityGroup
  • MailNonUniversalGroup
  • DynamicDistributionGroup
  • PublicFolder

RecipientTypeDetails

選用

Microsoft.Exchange.Data.Directory.Recipient.RecipientTypeDetails[]

RecipientTypeDetails 參數指定傳回的收件者類型。Microsoft Exchange Server 2007 中的收件者類型可分為收件者類型與子類型。每位收件者類型包含所有子類型的所有一般內容。例如，類型 UserMailbox 代表 Active Directory 中，具有關聯信箱的使用者帳戶。因為有數個信箱類型，每個信箱類型是透過 RecipientTypeDetails 參數來加以識別。例如，會議室信箱的 RecipientTypeDetails 是設定為 ConferenceRoomMailbox，而使用者信箱的 RecipientTypeDetails 則是設定為 UserMailbox。

對於此命令，可用的收件者類型詳細資料為：

  • ConferenceRoomMailbox
  • EquipmentMailbox
  • LegacyMailbox
  • LinkedMailbox
  • UserMailbox
  • MailContact
  • DynamicDistributionGroup
  • MailForestContact
  • MailNonUniversalGroup
  • MailUniversalDistributionGroup
  • MailUniversalSecurityGroup
  • MailUser
  • PublicFolder
  • SharedMailbox

ResultSize

選用

Microsoft.Exchange.Data.Unlimited

ResultSize 參數可指定傳回的結果筆數上限。如果想要傳回符合篩選器的所有收件者，請使用 "unlimited" 作為此參數值。預設值為 1000。

SortBy

選用

System.String

SortBy 參數指定用來排序結果的屬性。您一次只可以依據一個屬性進行排序。您可以依據下列屬性進行排序：

  • Alias
  • DisplayName
  • Name

結果會以遞增順序進行排序。

輸入類型

傳回類型

錯誤

錯誤 描述

   

 

例外狀況

例外狀況 描述

  

 

範例

第一個範例顯示如何取得組織中所有收件者的相關資訊。

第二個範例顯示如何取得組織中所有連絡人的相關資訊，並依名稱加以排序。

Get-Recipient -ResultSize unlimited
Get-Recipient -RecipientType DynamicDistributionGroup -SortBy Name

若要確保您目前閱讀的是最新資訊，並尋找其他的 Exchange Server 2007 說明文件，請造訪 Exchange Server 技術資源中心.