Get-CASMailbox (RTM)

 

適用版本: Exchange Server 2007

上次修改主題的時間: 2007-06-11

Get-CASMailbox 指令程式會傳回已安裝 Client Access server role 之電腦上的 Microsoft Exchange Server 2007 信箱的屬性清單。

語法

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

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

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

詳細描述

Get-CASMailbox 指令程式傳回 Exchange 2007 Client Access Server 之信箱的完整屬性清單。會傳回各種 CASMailbox 屬性。所傳回的屬性類型包括 Outlook Web Access、ActiveSync、POP3 及 IMAP4。

依預設,會傳回 Exchange 組織內所有信箱的所有屬性。您可以使用 Exchange 管理命令介面中的功能來篩選這些結果。

Get-CASMailbox 指令程式只能在已安裝 Mailbox server role 的 Exchange 2007 電腦上執行。若要執行 Get-CASMailbox 指令程式,必須對您使用的帳戶委派下列項目:

  • Exchange 僅檢視管理角色

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

參數

參數 必要 類型 描述

Anr

選用

System.String

這個參數接受字元組,以執行不明確名稱解析搜尋。所搜尋的屬性包括下列項目:

  • CommonName (CN)

  • DisplayName

  • FirstName

  • LastName

  • Alias

Filter

選用

System.String

這個參數會指定用於建立查詢的屬性組,以擷取信箱組。這個參數無法和 Database 參數一起使用。

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

Identity

選用

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

此參數可以是 ADObjectID 或代表 GUID、辨別名稱、網域\帳戶、使用者主要名稱、傳統 Exchange 辨別名稱、SMTP 位址或別名的字串。

Credential

選用

System.Management.Automation.PSCredential

此參數指定要使用的帳戶,用以讀取 Active Directory 目錄服務。

DomainController

選用

Microsoft.Exchange.Data.Fqdn

這個參數會指定要連線的網域控制站,以取得 Active Directory 驗證。

OrganizationalUnit

選用

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

這個參數是用來將搜尋限制在指定的容器內。

ReadFromDomainController

選用

System.Management.Automation.SwitchParameter

此參數指定從使用者網域的網域控制站讀取使用者資訊。如果將收件者範圍設為包括樹系中的所有收件者,但未使用此參數,則可能會從資訊過期的通用類別目錄伺服器中讀取使用者資訊。如果使用此參數,則可能需要多次讀取才能擷取該資訊。

附註   收件者範圍預設是設為主控 Exchange 伺服器的網域。

ResultSize

選用

Microsoft.Exchange.Data.Unlimited

這個參數會指定要傳回之結果的最大數量。預設值為 1000。

SortBy

選用

System.String

這個參數會指定用來排序結果的屬性。結果會以遞增順序排序。

輸入類型

傳回類型

錯誤

錯誤 描述

 

 

例外狀況

例外狀況 描述

 

 

範例

下列程式碼範例傳回 Contoso 網域之 Jeff Hay 這位使用者的所有 Client Access Server 信箱詳細資料。

Get-CASMailbox -identity jeffhay@contoso.com