New-DistributionGroup

  • [アーティクル]

 

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

トピックの最終更新日: 2009-05-12

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

構文

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

解説

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

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

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

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

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

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

パラメータ

パラメータ 必須 Type 説明

Name

必須

System.String

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

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

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

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

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 の値が使用され、その中にスペースが含まれていればすべてアンダースコアに変換されます。

Confirm

省略可能

System.Management.Automation.SwitchParameter

Confirm パラメータを指定すると、コマンドの処理が一時停止します。処理を続行するには、コマンドの処理内容を確認する必要があります。Confirm パラメータで値を指定する必要はありません。

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
  • Name
  • 表示名
  • 従来の Exchange DN
  • プライマリ SMTP 電子メール アドレス

OrganizationalUnit

省略可能

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

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

TemplateInstance

省略可能

System.Management.Automation.PSObject

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

UseRusServer

省略可能

System.String
note注 :
このパラメータは Exchange Server 2007 SP2 でのみ使用できます。

UseRusServer パラメータを指定すると、このコマンドで、アドレス一覧サービスを実行している指定のメールボックス サーバーを使用してメールボックスと Active Directory ユーザー属性が取得され、それらが設定されるようになります。

アドレス一覧サービスは、Exchange システム アテンダント サービスのコンポーネントです。アドレス一覧サービスは、Active Directory において Exchange 固有の属性値を作成および管理します。アドレス一覧サービスを使用すると、アドレス一覧メンバシップや電子メール アドレスなどの特定の情報を使用して、ドメイン内の受信者オブジェクトを更新できます。

WhatIf

省略可能

System.Management.Automation.SwitchParameter

WhatIf パラメータには、オブジェクトに対して行われる操作をシミュレートすることを指定します。WhatIf パラメータを使用することで、実際に変更を加えずに、発生する変更内容を表示することができます。WhatIf パラメータで値を指定する必要はありません。

入力の種類

戻り値の種類

エラー

エラー 説明

 

 

例外

例外 説明

 

 

例

次のコード例は、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 を参照してください。