New-AddressList

[アーティクル]
07/29/2013

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

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

新しいアドレス一覧を作成して受信者に適用するには、New-AddressList コマンドレットを使用します。

構文

New-AddressList -Name <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>]] [-Container <AddressListIdParameter>] [-DisplayName <String>] [-DomainController <Fqdn>] [-IncludedRecipients <Nullable>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

New-AddressList -Name <String> [-Confirm [<SwitchParameter>]] [-Container <AddressListIdParameter>] [-DisplayName <String>] [-DomainController <Fqdn>] [-RecipientFilter <String>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

解説

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

Exchange 組織管理者の役割

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

パラメータ

Name

必須

System.String

Name パラメータには、新しいアドレス一覧に付ける名前を指定します。名前は 64 文字以内で、改行文字と円記号 (\) を含めることはできません。

ConditionalCompany

省略可能

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCompany パラメータは、会社を指定するためのフィルタです。このパラメータに入力した値と一致する会社属性を持つすべての受信者が、アドレス一覧に含められます。複数の値を指定するには、値をコンマで区切ります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。RecipientFilter パラメータか、または次のフィルタパラメータのいずれかを使用する必要があります。

ConditionalCompany
ConditionalDepartment
ConditionalStateOrProvince
IncludedRecipients

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 パラメータを使用する場合は、このパラメータを使用できません。RecipientFilter パラメータか、または次のフィルタパラメータのいずれかを使用する必要があります。

ConditionalCompany
ConditionalDepartment
ConditionalStateOrProvince
IncludedRecipients

ConditionalStateOrProvince

省略可能

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalStateOrProvince パラメータは、都道府県を指定するためのフィルタです。このパラメータに入力した値と一致する ConditionalStateOrProvince 属性を持つすべての受信者が、アドレス一覧に含められます。複数の値を指定するには、値をコンマで区切ります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。RecipientFilter パラメータか、または次のフィルタパラメータのいずれかを使用する必要があります。

ConditionalCompany
ConditionalDepartment
ConditionalStateOrProvince
IncludedRecipients

Confirm

省略可能

System.Management.Automation.SwitchParameter

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

Container

省略可能

Microsoft.Exchange.Configuration.Tasks.AddressListIdParameter

Container パラメータには、新しく作成されるアドレス一覧の親アドレス一覧の ID を指定します。親アドレス一覧を指定しない場合、アドレス一覧はルートの "すべてのアドレス一覧" の下に作成されます。

DisplayName

省略可能

System.String

DisplayName パラメータには、アドレス一覧の表示名を指定します。表示名を指定しない場合は、アドレス一覧の名前が表示名にも使用されます。

DomainController

省略可能

Microsoft.Exchange.Data.Fqdn

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

IncludedRecipients

省略可能

System.Nullable

IncludedRecipients パラメータは、アドレス一覧に含める受信者の種類を指定するためのフィルタです。以下の種類から 1 つ以上を使用できます。

None
UserMail
Resources
MailGroups
MailContacts
AllRecipients

RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。RecipientFilter パラメータか、または次のフィルタパラメータのいずれかを使用する必要があります。

ConditionalCompany
ConditionalDepartment
ConditionalStateOrProvince
IncludedRecipients

RecipientFilter

省略可能

System.String

RecipientFilter パラメータには、アドレス一覧に含める受信者用のフィルタを指定します。次のいずれかのフィルタパラメータを使用する場合は、このパラメータを使用できません。

ConditionalCompany
ConditionalDepartment
ConditionalStateOrProvince
IncludedRecipients

このパラメータか、または上に示したフィルタパラメータのいずれかを使用する必要があります。

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

TemplateInstance

省略可能

System.Management.Automation.PSObject

TemplateInstance パラメータに既存のオブジェクトを指定した場合、このコマンドはオブジェクトの構成を使用して、ローカルまたはターゲットサーバーにそのオブジェクトの完全なコピーを作成します。

UseRusServer

省略可能

System.String

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

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

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

WhatIf

省略可能

System.Management.Automation.SwitchParameter

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

入力の種類

戻り値の種類

エラー

エラー	説明

例外

例外	説明

例

最初の例は、MyAddressList という名前の新しいアドレス一覧の作成方法を示しています。このアドレス一覧には、メールボックスユーザーであり、StateOrProvince が "Washington" または "Oregon" に設定されている受信者が含まれています。

2 番目の例は、ConditionalStateOrProvince パラメータが "Washington" に設定されているメールボックスを含む新しいアドレス一覧を、MyAddressList2 という名前で作成する方法を示しています。

New-AddressList -Name MyAddressList -RecipientFilter {((RecipientType -eq 'UserMailbox') -and ((StateOrProvince -eq 'Washington') -or (StateOrProvince -eq 'Oregon')))}
New-AddressList -Name MyAddressList2 -ConditionalStateOrProvince Washington -IncludedRecipients MailboxUsers

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