Get-MailUser (RTM)

適用版本： Exchange Server 2007

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

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

語法

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

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

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

詳細描述

重要事項：
在 Microsoft Exchange Server 2007 中，只會利用 Exchange 管理命令介面來擷取擁有郵件功能的使用者設定。

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

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

• Exchange 僅檢視管理角色

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

附註：
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)、電子郵件地址或別名。
OrganizationalUnit	選用	Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter	OrganizationalUnit 參數可指定用來限制結果的容器。您可指定組織單位 (OU) 或網域。應指定標準名稱。例如： OU:westcoast.contoso.com/users Domain:westcoast.contoso.com
ReadFromDomainController	選用	System.Management.Automation.SwitchParameter	ReadFromDomainController 參數指定從使用者網域的網域控制站讀取使用者資訊。如果您將收件者範圍設定為包含所有樹系中的收件者，且如果您不使用此參數，則可能會從通用類別目錄讀取含有過時資訊的使用者資訊。如果使用此參數，則可能需要多次讀取才能取得資訊。 附註： 依預設，收件者範圍會設為主控您的 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 技術資源中心.