New-DynamicDistributionGroup

 

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

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

New-DynamicDistributionGroup コマンドレットを使用して、新しい動的配布グループを作成します。

構文

New-DynamicDistributionGroup -Name <String> -IncludedRecipients <Nullable> [-Alias <String>] [-ConditionalCompany <MultiValuedProperty>] [-ConditionalCustomAttribute1 <MultiValuedProperty>] [-ConditionalCustomAttribute10 <MultiValuedProperty>] [-ConditionalCustomAttribute11 <MultiValuedProperty>] [-ConditionalCustomAttribute12 <MultiValuedProperty>] [-ConditionalCustomAttribute13 <MultiValuedProperty>] [-ConditionalCustomAttribute14 <MultiValuedProperty>] [-ConditionalCustomAttribute15 <MultiValuedProperty>] [-ConditionalCustomAttribute2 <MultiValuedProperty>] [-ConditionalCustomAttribute3 <MultiValuedProperty>] [-ConditionalCustomAttribute4 <MultiValuedProperty>] [-ConditionalCustomAttribute5 <MultiValuedProperty>] [-ConditionalCustomAttribute6 <MultiValuedProperty>] [-ConditionalCustomAttribute7 <MultiValuedProperty>] [-ConditionalCustomAttribute8 <MultiValuedProperty>] [-ConditionalCustomAttribute9 <MultiValuedProperty>] [-ConditionalDepartment <MultiValuedProperty>] [-ConditionalStateOrProvince <MultiValuedProperty>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-RecipientContainer <OrganizationalUnitIdParameter>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

New-DynamicDistributionGroup -Name <String> -RecipientFilter <String> [-Alias <String>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-RecipientContainer <OrganizationalUnitIdParameter>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

解説

動的配布グループは、Active Directory ディレクトリ サービスにメールが有効なオブジェクトを照会し、その結果に基づいてグループ メンバシップを構築します。グループ メンバシップは、グループに電子メール メッセージが送信されるたびに再計算されます。Exchange で用意されているクエリ フィルタは、以下のパラメータの組み合わせに制限されます。

  • ConditionalCompany
  • ConditionalCustomAttribute N (N は 1 から 15 の値です)
  • ConditionalDepartment
  • ConditionalStateOrProvince
  • IncludedRecipients

また、RecipientFilter パラメータを使用して、カスタム クエリを作成することもできます。

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

  • Exchange 受信者管理者の役割

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

パラメータ

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

IncludedRecipients

必須

System.Nullable

IncludedRecipients パラメータは、動的配布グループを構築するために使用される受信者の種類にフィルタを適用します。RecipientFilter パラメータを指定した場合、IncludedRecipients パラメータは使用できません。

IncludedRecipients パラメータに指定できる値は、AllRecipients、MailboxUsers、Resources、MailContacts、MailGroups、Mail Users、および None です。

AllRecipients は単体でのみ使用できます。IncludedRecipients に複数の値をコンマで区切って指定すると、OR ブール演算子が適用されます。

Name

必須

System.String

Name パラメータには、動的配布グループの名前を指定します。DisplayName パラメータを指定しないと、Name の値が DisplayName にも使用されます。

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

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

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

RecipientFilter

必須

System.String

RecipientFilter パラメータは、動的配布グループを構築するために使用されるメールが有効な受信者にフィルタを適用します。次のいずれかのパラメータを指定している場合、RecipientFilter は使用できません。

  • IncludedRecipients
  • ConditionalCompany
  • ConditionalCustomAttribute N (N は 1 から 15 の値です)
  • ConditionalDepartment
  • ConditionalStateOrProvince

RecipientFilter では、OPath 構文を使用して Active Directory に照会し、受信者にフィルタを適用します。

フィルタ可能なプロパティの詳細については、「-RecipientFilter パラメータのフィルタ可能なプロパティ」を参照してください。

Alias

省略可能

System.String

Alias パラメータは、動的配布グループのエイリアスを指定します。Alias の値を使用して、動的配布グループのプライマリ SMTP (簡易メール転送プロトコル) 電子メール アドレスが生成されます。Alias の値にスペースを含めることはできません。Alias パラメータを指定しないと、Name パラメータの値が Alias パラメータの値として使用されます。このとき、Name パラメータにスペースが含まれていれば、アンダースコア (_) に変換して使用されます。

ConditionalCompany

省略可能

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCompany パラメータは、動的配布グループを構築するために使用されるメールボックス ユーザーまたはメールが有効な連絡先にフィルタを適用します。

ConditionalCompany パラメータに複数の値をコンマで区切って指定すると、OR ブール演算子が適用されます。

ConditionalCustomAttribute1

省略可能

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute1 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。

ConditionalCustomAttribute10

省略可能

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute10 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。

ConditionalCustomAttribute11

省略可能

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute11 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。

ConditionalCustomAttribute12

省略可能

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute12 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。

ConditionalCustomAttribute13

省略可能

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute13 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。

ConditionalCustomAttribute14

省略可能

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute14 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。

ConditionalCustomAttribute15

省略可能

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute15 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。

ConditionalCustomAttribute2

省略可能

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute2 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。

ConditionalCustomAttribute3

省略可能

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute3 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。

ConditionalCustomAttribute4

省略可能

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute4 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。

ConditionalCustomAttribute5

省略可能

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute5 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。

ConditionalCustomAttribute6

省略可能

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute6 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。

ConditionalCustomAttribute7

省略可能

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute7 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。

ConditionalCustomAttribute8

省略可能

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute8 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。

ConditionalCustomAttribute9

省略可能

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute9 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。

ConditionalDepartment

省略可能

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalDepartment パラメータは、動的配布グループを構築するために使用されるメールボックス ユーザーまたはメールが有効な連絡先にフィルタを適用します。RecipientFilter パラメータを指定した場合、ConditionalDepartment は使用できません。

ConditionalDepartment に複数の値をコンマで区切って指定すると、OR ブール演算子が適用されます。

ConditionalStateOrProvince

省略可能

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalStateOrProvince パラメータは、動的配布グループを構築するために使用されるメールボックス ユーザーまたはメールが有効な連絡先にフィルタを適用します。RecipientFilter パラメータを指定した場合、ConditionalStateOrProvince は使用できません。

ConditionalStateOrProvince に複数の値をコンマで区切って指定すると、OR ブール演算子が適用されます。

Confirm

省略可能

System.Management.Automation.SwitchParameter

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

DisplayName

省略可能

System.String

DisplayName パラメータは、Exchange 管理コンソール内および Exchange グローバル アドレス一覧 (GAL) 内での動的配布グループの名前を指定します。DisplayName パラメータを指定しないと、Name パラメータの値が DisplayName に使用されます。

DomainController

省略可能

Microsoft.Exchange.Data.Fqdn

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

OrganizationalUnit

省略可能

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

OrganizationalUnit パラメータは、Active Directory で動的配布グループを作成する場所を、正規名の構文を使用して指定します。

RecipientContainer

省略可能

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

RecipientContainer パラメータは、Active Directory 内の場所に基づいて動的配布グループを構築するために使用される受信者にフィルタを適用します。RecipientContainer の値は、組織単位 (OU) またはドメインの正規名です。RecipientContainer パラメータに値を指定しない場合、既定の検索フィルタは Active Directory 内での動的配布グループの場所です。この場所は、OrganizationalUnit パラメータを使用して指定します。

TemplateInstance

省略可能

System.Management.Automation.PSObject

TemplateInstance パラメータに既存のオブジェクトを渡すと、コマンドは、そのオブジェクトの構成を使用して、オブジェクトのコピーを作成します。

UseRusServer

省略可能

System.String

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

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

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

WhatIf

省略可能

System.Management.Automation.SwitchParameter

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

入力の種類

戻り値の種類

エラー

エラー 説明

 

 

例外

例外 説明

  

 

次のコード例は、New-DynamicDistributionGroup コマンドの使用方法を示しています。

最初の例では、Marketing Group という名前の新しい動的配布グループを、Contoso.com ドメインの Users コンテナに作成しています。動的配布グループ Marketing Group には、Contoso.com ドメイン内のすべての場所にあるメールボックス ユーザーまたはメールが有効な連絡先のうち、"部署" フィールドが "Marketing" または "Sales" になっているものがすべて含まれます。

2 番目の例では、RecipientFilter パラメータを使用して、Pacific Northwest という名前の動的配布グループを、Contoso.com ドメインの Users コンテナに作成しています。動的配布グループ Pacific Northwest には、Contoso.com ドメイン内のすべての場所にあるメールボックスのうち、"都道府県" フィールドが "Washington" または "Oregon" になっているものがすべて含まれます。

New-DynamicDistributionGroup -Name "Marketing Group" -Alias "Marketing_Group" -IncludedRecipients "MailboxUsers,MailContacts" -OrganizationalUnit "Contoso.com/Users" -ConditionalDepartment "Marketing","Sales" -RecipientContainer "Contoso.com"
New-DynamicDistributionGroup -Name "Pacific Northwest" -Alias "Pacific_Northwest" -OrganizationalUnit "Contoso.com/Users" -RecipientFilter {((RecipientType -eq 'UserMailbox') -and ((StateOrProvince -eq 'Washington' -or StateOrProvince -eq 'Oregon')))} -RecipientContainer "Contoso.com"

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