共用方式為

Get-MailUser

  • 發行項

 

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

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

使用 Get-MailUser 指令程式，可從 Active Directory 目錄服務中擷取指定使用者的相關郵件屬性。

語法

get-MailUser [-Identity <MailUserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]

get-MailUser [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]

get-MailUser [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]

詳細描述

Get-MailUser 指令程式會擷取指定收件者的所有郵件相關屬性。

若要執行 Get-MailUser 指令程式，您使用的帳戶必須已委派下列資格：

  • Exchange 僅檢視管理角色

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

note附註：
Get-MailUser 指令程式未擷取所有的使用者屬性。您可以利用 Get-User 指令程式來取得其他使用者屬性。

參數

參數 必要 類型 描述

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 參數是用來篩選所傳回的收件者清單。您可以指定要篩選的屬性。

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

Identity

選用

Microsoft.Exchange.Configuration.Tasks.MailUserIdParameter

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

IgnoreDefaultScope

選用

System.Management.Automation.SwitchParameter

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

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

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 伺服器之網域。

ResultSize

選用

Microsoft.Exchange.Data.Unlimited

ResultSize 參數可指定傳回的收件者物件數上限。如果未指定，則參數會傳回所有符合篩選器的結果。

SortBy

選用

System.String

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

輸入類型

傳回類型

錯誤

錯誤 描述

 

例外狀況

例外狀況 描述

 

範例

在第一個範例中，會在沒有參數的情況下使用 Get-MailUser 命令，以針對整個 Exchange 組織擷取完整的擁有郵件功能使用者清單。

在第二個範例中，擷取了使用者 Ted 的郵件設定，然後以管線傳輸至 Format-List 指令程式以供顯示。

Get-MailUser
Get-MailUser -Identity Ted | Format-List

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