New-DynamicDistributionGroup (RTM)
適用先: Exchange Server 2007
トピックの最終更新日: 2007-10-23
New-DynamicDistributionGroup コマンドレットを使用して、新しい動的配布グループを作成します。
構文
New-DynamicDistributionGroup -Name <String> -IncludedRecipients <Nullable> -OrganizationalUnit <OrganizationalUnitIdParameter> [-Alias <String>] [-ConditionalCompany <MultiValuedProperty>] [-ConditionalCustomAttribute1 <String>] [-ConditionalCustomAttribute10 <String>] [-ConditionalCustomAttribute11 <String>] [-ConditionalCustomAttribute12 <String>] [-ConditionalCustomAttribute13 <String>] [-ConditionalCustomAttribute14 <String>] [-ConditionalCustomAttribute15 <String>] [-ConditionalCustomAttribute2 <String>] [-ConditionalCustomAttribute3 <String>] [-ConditionalCustomAttribute4 <String>] [-ConditionalCustomAttribute5 <String>] [-ConditionalCustomAttribute6 <String>] [-ConditionalCustomAttribute7 <String>] [-ConditionalCustomAttribute8 <String>] [-ConditionalCustomAttribute9 <String>] [-ConditionalDepartment <MultiValuedProperty>] [-ConditionalStateOrProvince <MultiValuedProperty>] [-DisplayName <String>] [-DomainController <Fqdn>] [-RecipientContainer <OrganizationalUnitIdParameter>] [-TemplateInstance <PSObject>]
New-DynamicDistributionGroup -Name <String> -OrganizationalUnit <OrganizationalUnitIdParameter> -RecipientFilter <String> [-Alias <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-RecipientContainer <OrganizationalUnitIdParameter>] [-TemplateInstance <PSObject>]
解説
動的配布グループは、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 文字以下にする必要があります。 Name と DisplayName の値が異なる場合は、次のようにします。
|
OrganizationalUnit |
必須 |
Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter |
OrganizationalUnit パラメータは、Active Directory で動的配布グループを作成する場所を、正規名の構文を使用して指定します。 |
RecipientFilter |
必須 |
System.String |
RecipientFilter パラメータは、動的配布グループを構築するために使用されるメールが有効な受信者にフィルタを適用します。次のいずれかのパラメータを指定している場合、RecipientFilter は使用できません。
RecipientFilter では、 フィルタ可能なプロパティの詳細については、「-RecipientFilter パラメータのフィルタ可能なプロパティ」を参照してください。 |
Alias |
省略可能 |
System.String |
Alias パラメータは、動的配布グループのエイリアスを指定します。Alias の値を使用して、動的配布グループのプライマリ SMTP (簡易メール転送プロトコル) 電子メール アドレスが生成されます。Alias の値にスペースを含めることはできません。Alias パラメータを指定しないと、Name パラメータの値が Alias パラメータの値として使用されます。このとき、Name パラメータにスペースが含まれていれば、アンダースコア (_) に変換して使用されます。 |
ConditionalCompany |
省略可能 |
Microsoft.Exchange.Data.MultiValuedProperty |
ConditionalCompany パラメータは、動的配布グループを構築するために使用されるメールボックス ユーザーまたはメールが有効な連絡先にフィルタを適用します。 ConditionalCompany パラメータに複数の値をコンマで区切って指定すると、OR ブール演算子が適用されます。 |
ConditionalCustomAttribute1 |
省略可能 |
System.String |
ConditionalCustomAttribute1 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。 |
ConditionalCustomAttribute10 |
省略可能 |
System.String |
ConditionalCustomAttribute10 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。 |
ConditionalCustomAttribute11 |
省略可能 |
System.String |
ConditionalCustomAttribute11 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。 |
ConditionalCustomAttribute12 |
省略可能 |
System.String |
ConditionalCustomAttribute12 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。 |
ConditionalCustomAttribute13 |
省略可能 |
System.String |
ConditionalCustomAttribute13 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。 |
ConditionalCustomAttribute14 |
省略可能 |
System.String |
ConditionalCustomAttribute14 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。 |
ConditionalCustomAttribute15 |
省略可能 |
System.String |
ConditionalCustomAttribute15 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。 |
ConditionalCustomAttribute2 |
省略可能 |
System.String |
ConditionalCustomAttribute2 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。 |
ConditionalCustomAttribute3 |
省略可能 |
System.String |
ConditionalCustomAttribute3 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。 |
ConditionalCustomAttribute4 |
省略可能 |
System.String |
ConditionalCustomAttribute4 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。 |
ConditionalCustomAttribute5 |
省略可能 |
System.String |
ConditionalCustomAttribute5 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。 |
ConditionalCustomAttribute6 |
省略可能 |
System.String |
ConditionalCustomAttribute6 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。 |
ConditionalCustomAttribute7 |
省略可能 |
System.String |
ConditionalCustomAttribute7 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。 |
ConditionalCustomAttribute8 |
省略可能 |
System.String |
ConditionalCustomAttribute8 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。 |
ConditionalCustomAttribute9 |
省略可能 |
System.String |
ConditionalCustomAttribute9 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。 |
ConditionalDepartment |
省略可能 |
Microsoft.Exchange.Data.MultiValuedProperty |
ConditionalDepartment パラメータは、動的配布グループを構築するために使用されるメールボックス ユーザーまたはメールが有効な連絡先にフィルタを適用します。RecipientFilter パラメータを指定した場合、ConditionalDepartment は使用できません。 ConditionalDepartment に複数の値をコンマで区切って指定すると、OR ブール演算子が適用されます。 |
ConditionalStateOrProvince |
省略可能 |
Microsoft.Exchange.Data.MultiValuedProperty |
ConditionalStateOrProvince パラメータは、動的配布グループを構築するために使用されるメールボックス ユーザーまたはメールが有効な連絡先にフィルタを適用します。RecipientFilter パラメータを指定した場合、ConditionalStateOrProvince は使用できません。 ConditionalStateOrProvince に複数の値をコンマで区切って指定すると、OR ブール演算子が適用されます。 |
DisplayName |
省略可能 |
System.String |
DisplayName パラメータは、Exchange 管理コンソール内および Exchange グローバル アドレス一覧 (GAL) 内での動的配布グループの名前を指定します。DisplayName パラメータを指定しないと、Name パラメータの値が DisplayName に使用されます。 |
DomainController |
省略可能 |
Microsoft.Exchange.Data.Fqdn |
この構成の変更を Active Directory に書き込むドメイン コントローラの完全修飾ドメイン名 (FQDN) を指定するには、DomainController パラメータを含めます。 |
RecipientContainer |
省略可能 |
Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter |
RecipientContainer パラメータは、Active Directory 内の場所に基づいて動的配布グループを構築するために使用される受信者にフィルタを適用します。RecipientContainer の値は、組織単位 (OU) またはドメインの正規名です。RecipientContainer パラメータに値を指定しない場合、既定の検索フィルタは Active Directory 内での動的配布グループの場所です。この場所は、OrganizationalUnit パラメータを使用して指定します。 |
TemplateInstance |
省略可能 |
System.Management.Automation.PSObject |
TemplateInstance パラメータに既存のオブジェクトを渡すと、コマンドは、そのオブジェクトの構成を使用して、オブジェクトのコピーを作成します。 |
入力の種類
戻り値の種類
エラー
エラー | 説明 |
---|---|
|
|
例外
例外 | 説明 |
---|---|
|
|
例
次のコード例は、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 を参照してください。