Get-DynamicDistributionGroup

 

適用先: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

トピックの最終更新日: 2010-04-27

Get-DynamicDistributionGroup コマンドレットを使用して、既存の動的配布グループの設定を取得します。

構文

Get-DynamicDistributionGroup [-Identity <DynamicGroupIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-ManagedBy <GeneralRecipientIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]

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

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

解説

配布グループを使用して電子メール配布リストおよびセキュリティ グループを作成し、共有リソースに対するアクセス許可を割り当てることができます。配布グループは、電子メール アプリケーション (Microsoft Exchange など) で電子メール メッセージをユーザーの集合に送信するためだけに使用できます。Get-DynamicDistributionGroup コマンドレットを使用して、Active Directory ディレクトリ サービス内の既存の動的配布グループの設定を取得することができます。

Get-DynamicDistributionGroup コマンドレットを実行するには、使用するアカウントに次の役割が委任されている必要があります。

• Exchange 表示専用管理者の役割

アクセス許可、役割の委任、および 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.DynamicGroupIdParameter	配布グループの Identity パラメータは、次のいずれかの形式で指定します。 GUID 識別名 (DN) ユーザー プリンシパル名 (UPN) LegacyExchangeDN ドメイン\アカウント名 エイリアス プライマリ SMTP (簡易メール転送プロトコル) アドレス
IgnoreDefaultScope	省略可能	System.Management.Automation.SwitchParameter	IgnoreDefaultScope パラメータを指定すると、Exchange 管理シェルの受信者の範囲の既定の設定が無視され、範囲としてフォレスト全体が使用されます。これにより、現在既定の範囲にない Active Directory オブジェクトにアクセスすることができます。IgnoreDefaultScope パラメータを使用すると、次の制限が発生します。 DomainController パラメータは使用できません。このコマンドでは、適切なグローバル カタログ サーバーを自動的に使用します。 Identity パラメータの DN しか使用できません。エイリアスや GUID などの他の形式の ID は使用できません。 OrganizationalUnit パラメータと Identity パラメータは同時に使用できません。 Credential パラメータは使用できません。
ManagedBy	省略可能	Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter	ManagedBy パラメータには、グループを管理するユーザーまたは連絡先の DN を指定します。
OrganizationalUnit	省略可能	Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter	OrganizationalUnit パラメータは、結果を特定の組織単位コンテナに限定します。
ReadFromDomainController	省略可能	System.Management.Automation.SwitchParameter	ReadFromDomainController パラメータには、ユーザー情報がユーザーのドメインのドメイン コントローラから読み取られることを指定します。フォレスト内のすべての受信者を含めるように受信者の範囲を設定した場合、このパラメータを使用しないと、情報が古いグローバル カタログからユーザー情報が読み取られる可能性があります。このパラメータを使用する場合は、情報を取得するために読み取りが数回必要になる場合があります。 注 : 既定では、受信者の範囲は、Exchange サーバーをホストするドメインに設定されています。
ResultSize	省略可能	Microsoft.Exchange.Data.Unlimited	ResultSize パラメータには、返される受信者オブジェクトの最大数を指定します。
SortBy	省略可能	System.String	SortBy 属性は、結果の並べ替えに使用します。

入力の種類

戻り値の種類

エラー

エラー	説明

例外

例外	説明

例

次のコード例は、Get-DynamicDistributionGroup コマンドを示しています。この例では、Get-DistributionGroup コマンドがマーケティングという動的配布グループを取得し、このオブジェクトを Format-List コマンドにパイプ処理して、動的配布グループに関する情報を表示します。

Get-DynamicDistributionGroup -Identity "Marketing" | Format-List

参照している情報が最新であることを確認したり、他の Exchange Server 2007 ドキュメントを見つけたりするには、Exchange Server TechCenter を参照してください。