Get-DistributionGroup (RTM)

適用版本： Exchange Server 2007

上次修改主題的時間： 2008-02-27

使用 Get-DistributionGroup 指令程式，可以查詢現有的通訊群組。

語法

Get-DistributionGroup [-Identity <DistributionGroupIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-ManagedBy <GeneralRecipientIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

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

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

詳細描述

您可以使用通訊群組來建立電子郵件通訊清單和安全性群組，以指派權限給共用資源。通訊群組只能用於電子郵件應用程式 (例如 Exchange)，傳送電子郵件給一群使用者。您可以使用 Get-DistributionGroup 指令程式來查詢現有的通訊群組。

若要執行 Get-DistributionGroup 指令程式，則必須將下列項目之一委派給您使用的帳戶：

• Exchange 僅檢視管理角色

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

參數

參數	必要	類型	描述
ANR	選用	System.String	ANR 參數指出會使用不明確名稱解析 (ANR) 來解析引數。
Credential	選用	System.Management.Automation.PSCredential	Credential 參數指出用來讀取 Active Directory 目錄服務之帳戶的網域及使用者名稱。
DomainController	選用	Microsoft.Exchange.Data.Fqdn	若要指定從 Active Directory 擷取資料之網域控制站的網域全名 (FQDN)，請在命令中加入 DomainController 參數。
Filter	選用	System.String	Filter 參數指出用來篩選收件者的 OPath 篩選器。 如需可過濾內容的相關資訊，請參閱-Filter 參數的可篩選內容。
Identity	選用	Microsoft.Exchange.Configuration.Tasks.DistributionGroupIdParameter	通訊群組的 Identity 參數會採用下列其中一種形式： GUID 辨別名稱 (DN) LegacyExchangeDN 網域\帳戶名稱 別名
ManagedBy	選用	Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter	ManagedBy 參數指出管理群組之使用者或連絡人的辨別名稱。
OrganizationalUnit	選用	Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter	OrganizationalUnit 參數會將結果限制在特定的組織單位 (OU) 容器。
ReadFromDomainController	選用	System.Management.Automation.SwitchParameter	ReadFromDomainController 參數指定從使用者網域的網域控制站讀取使用者資訊。如果您將收件者範圍設定為包含所有樹系中的收件者，且如果您不使用此參數，則可能會從通用類別目錄讀取含有過時資訊的使用者資訊。如果使用此參數，則可能需要多次讀取才能取得資訊。 附註： 依預設，收件者範圍會設為主控您的 Exchange 伺服器之網域。
RecipientTypeDetails	選用	Microsoft.Exchange.Data.Directory.Recipient.RecipientTypeDetails[]	RecipientTypeDetails 參數指定傳回的收件者類型。Microsoft Exchange Server 2007 中的收件者類型可分為收件者類型與子類型。每位收件者類型包含所有子類型的所有一般內容。例如，類型 UserMailbox 代表 Active Directory 中，具有關聯信箱的使用者帳戶。因為有數個信箱類型，每個信箱類型是透過 RecipientTypeDetails 參數來加以識別。例如，會議室信箱的 RecipientTypeDetails 是設定為 ConferenceRoomMailbox，而使用者信箱的 RecipientTypeDetails 則是設定為 UserMailbox。 對於此命令，可用的收件者類型詳細資料為： MailNonUniversalGroup MailUniversalDistributionGroup MailUniversalSecurityGroup
ResultSize	選用	Microsoft.Exchange.Data.Unlimited	ResultSize 參數指出將傳回之收件者物件的最大數目。
SortBy	選用	System.String	SortBy 屬性是用來排序結果。

輸入類型

傳回類型

錯誤

例外狀況

範例

下列程式碼是 Get-DistributionGroup 命令的範例。在此範例中，Get-DistributionGroup 命令會擷取群組 Distribution Group1，並將該物件管線輸出至 Format-List 命令，以顯示通訊群組的相關資訊。

Get-DistributionGroup -Identity "Distribution Group1" | Format-List

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