New-DistributionGroup (RTM)

  • [アーティクル]

 

適用先: Exchange Server 2007

トピックの最終更新日: 2007-06-05

新しい配布グループを作成するには、New-DistributionGroup コマンドレットを使用します。

構文

New-DistributionGroup -Name <String> -OrganizationalUnit <OrganizationalUnitIdParameter> -SamAccountName <String> -Type <Distribution | Security> [-Alias <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-ManagedBy <GeneralRecipientIdParameter>] [-TemplateInstance <PSObject>]

解説

New-DistributionGroup コマンドレットを使用すると、次の種類の Active Directory グループ オブジェクトを新規に作成できます。

  • メールが有効なユニバーサル セキュリティ グループ
  • ユニバーサル配布グループ

配布グループは、受信者のグループを電子メール メッセージの単一窓口に統合する場合に使用します。配布グループを使用して、Active Directory ディレクトリ サービス内のネットワーク リソースにアクセス許可を割り当てることはできません。

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

  • Exchange 受信者管理者の役割
  • 該当する Active Directory コンテナに対する Account Operator の役割

Exchange Server 2007 を管理するために必要なアクセス許可、役割の委任、および権限の詳細については、「アクセス許可に関する考慮事項」を参照してください。

パラメータ

パラメータ 必須かどうか 種類 説明

Name

必須

System.String

このパラメータには、新しい配布グループの名前を指定します。DisplayName パラメータを指定していない場合は、Name パラメータに指定した値が DisplayName にも使用されます。

Name の値は、64 文字以下にする必要があります。

Name と DisplayName の値が異なる場合は、次のようにします。

  • Name には、[Active Directory ユーザーとコンピュータ] および Exchange 管理コンソールの "グループ名" フィールドに表示される配布グループ名を指定します。
  • DisplayName には、Exchange 管理コンソールおよび Exchange グローバル アドレス一覧 (GAL) に表示される配布グループ名を指定します。

OrganizationalUnit

必須

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

このパラメータには、正規の名前構文を使用して Active Directory のどこに配布グループを作成するかを指定します。

SamAccountName

必須

System.String

このパラメータには、古いオペレーティング システムを実行しているオブジェクトのクライアントに対する名前を指定します。SamAccountName パラメータは、Active Directory および Exchange 管理コンソールの "グループ名 (Windows 2000 以前)" フィールドに表示されます。Alias パラメータを使用しないと、次の条件が満たされることになります。

  • Alias パラメータの値の代わりに SAMAccountName の値が使用され、その中にスペースが含まれていればすべてアンダースコアに変換されます。
  • オブジェクトのプライマリ SMTP (簡易メール転送プロトコル) 電子メール アドレスを生成するのに SAMAccountName が使用され、その中にスペースが含まれていればすべてアンダースコアに変換されます。

Type

必須

Microsoft.Exchange.Management.RecipientTasks.GroupType

このパラメータには、Active Directory に作成されるグループの種類を指定します。グループのスコープは常にユニバーサルです。有効な値は、Distribution または Security です。

Alias

省略可能

System.String

このパラメータを使用すると、配布グループのエイリアスを指定できます。Alias パラメータは、オブジェクトのプライマリ SMTP 電子メール アドレスを生成するのに使用されます。Alias の値にスペースを含めることはできません。Alias を指定しないと、プライマリ SMTP 電子メール アドレスを生成するのに SAMAccountName の値が使用され、その中にスペースが含まれていればすべてアンダースコアに変換されます。

DisplayName

省略可能

System.String

このパラメータを使用すると、Exchange 管理コンソールおよび Exchange GAL に表示される配布グループの名前を指定できます。DisplayName パラメータを指定しないと、DisplayName の代わりに Name パラメータの値が使用されます。

DomainController

省略可能

Microsoft.Exchange.Data.Fqdn

この構成の変更を Active Directory に書き込むドメイン コントローラの完全修飾ドメイン名 (FQDN) を指定するには、DomainController パラメータを含めます。

ManagedBy

省略可能

Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter

このパラメータを使用すると、Active Directory オブジェクトの [管理] タブに表示されるメールボックス ユーザーの名前、メールが有効なグループの名前、またはメールが有効な連絡先の名前を指定できます。このパラメータには次のいずれかの値を使用できます。

  • 識別名 (DN)
  • 正規名
  • GUID
  • 名前
  • 表示名
  • 従来の Exchange DN
  • プライマリ SMTP 電子メール アドレス

TemplateInstance

省略可能

System.Management.Automation.PSObject

このパラメータに既存のオブジェクトを指定すると、そのオブジェクトのコピーが作成されます。

入力の種類

戻り値の種類

エラー

エラー 説明

 

 

例外

例外 説明

 

 

例

次のコード例は、New-DistributionGroup コマンドレットを使用して、以下のパラメータを備えるメールが有効なユニバーサル セキュリティ グループを新規に作成する方法を示しています。

  • グループの名前は "Managers" です。
  • グループは、Contoso.com ドメインの Users コンテナに作成します。
  • グループの SAM アカウント名は "Managers" です。
  • グループの種類は Security です。
New-DistributionGroup -Name "Managers" -OrganizationalUnit "contoso.com/Users" -SAMAccountName "Managers" -Type "Security"

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