Get-MailContact (RTM)

  • 發行項

 

適用版本： Exchange Server 2007

上次修改主題的時間： 2007-06-05

使用 Get-MailContact 指令程式，可以從 Active Directory 擷取所有指定之連絡人的屬性。

語法

Get-MailContact [-Identity <MailContactIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

Get-MailContact [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

Get-MailContact [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

詳細描述

此指令程式會擷取指定之連絡人的所有屬性。不需要參數。如果執行不含參數的指令程式，則會傳回 Exchange 組織的完整連絡人清單。

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

  • Exchange 僅檢視管理角色

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

參數

參數 必要 類型 描述

ANR

選用

System.String

會使用不明確名稱解析 (ANR) 來解析指定的參數。所搜尋的預設屬性如下：

  • CommonName (CN)

  • DisplayName (displayName)

  • FirstName (givenName)

  • LastName (sn)

  • Alias (mailNickname)

  • LegacyExchangeDN (legacyExchangeDN)

  • Name (name) (而非 CommonName/CN)

  • EmailAddresses (proxyAddresses)

  • SamAccountName (samAccountName)

  • Office (physicalDeliveryOfficeName)

Credential

選用

System.Management.Automation.PSCredential

此參數指定要用來存取 Active Directory 的帳戶。

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

DomainController

選用

Microsoft.Exchange.Data.Fqdn

若要指定從 Active Directory 擷取資料之網域控制站的網域全名，請在命令中加入 DomainController 參數。

Filter

選用

System.String

此參數是用來篩選所傳回之收件者的清單。您可以指定要篩選的屬性。

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

Identity

選用

Microsoft.Exchange.Configuration.Tasks.MailContactIdParameter

此參數會識別連絡人。您可以包含連絡人的 ADObjectID、辨別名稱、LegacyExchangeDN、GUID、Domain\SamAccountName、使用者主要名稱 (UPN)、電子郵件地址或別名。

OrganizationalUnit

選用

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

此參數指定用來限制結果的容器。可以指定組織單位 (OU) 或網域。而且，應該指定標準名稱。例如：

  • OU:westcoast.contoso.com/users

  • Domain:westcoast.contoso.com

ReadFromDomainController

選用

System.Management.Automation.SwitchParameter

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

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

RecipientTypeDetails

選用

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

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

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

  • MailEnabledContact

  • MailEnabledForestContact

ResultSize

選用

Microsoft.Exchange.Data.Unlimited

此參數指定要傳回之收件者物件的總數。如果未指定，則參數會傳回所有符合篩選器的結果。

SortBy

選用

System.String

此參數指定用來排序結果的屬性。排序是一次執行一個屬性，而且一律是以遞增順序進行。

輸入類型

傳回類型

錯誤

錯誤 描述

例外狀況

例外狀況 描述

範例

在此範例中，Get-MailContact 命令是用來擷取名為 Ted 的擁有郵件功能連絡人。

Get-MailContact -Identity Ted | Format-List