Get-MailContact

  • 發行項

 

適用版本： Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

上次修改主題的時間： 2010-04-27

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

語法

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

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

Get-MailContact [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-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

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

IgnoreDefaultScope

選用

System.Management.Automation.SwitchParameter

IgnoreDefaultScope 參數會指示命令略過 Exchange 管理命令介面的預設收件者範圍設定，並以整個樹系作為範圍。如此可讓命令存取目前不在預設範圍內的 Active Directory 物件。使用 IgnoreDefaultScope 參數會產生下列限制：

  • 您無法使用 DomainController 參數。此命令會自動使用適當的通用類別目錄伺服器。
  • 您只可以針對 Identity 參數使用 DN。不接受其他形式的識別碼 (如別名或 GUID)。
  • 您無法同時使用 OrganizationalUnit 及 Identity 參數。
  • 您無法使用 Credential 參數。

輸入類型

傳回類型

錯誤

錯誤 描述

例外狀況

例外狀況 描述

範例

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

Get-MailContact -Identity Ted | Format-List

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