Set-AddressList

 

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

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

既存のアドレス一覧を変更するには、Set-AddressList コマンドレットを使用します。

構文

Set-AddressList -Identity <AddressListIdParameter> [-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>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Name <String>] [-RecipientFilter <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

Set-AddressList [-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>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Instance <AddressList>] [-Name <String>] [-RecipientFilter <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

解説

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

• Exchange 組織管理者の役割

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

Exchange 管理コンソールを使用して、Exchange Server 2003 または Exchange 2000 Server に作成したアドレス一覧を管理する場合は、次の操作を行う必要があります。

• ForceUpgrade パラメータを使用して、アドレス一覧のバージョン属性を更新します。
• RecipientFilter パラメータまたは次のいずれかのフィルタ パラメータを使用して、受信者フィルタを変更します。
  • ConditionalCompany
  • ConditionalDepartment
  • ConditionalStateOrProvince
  • IncludedRecipients

パラメータ

パラメータ	必須かどうか	種類	説明
Identity	必須	Microsoft.Exchange.Configuration.Tasks.AddressListIdParameter	Identity パラメータを使用して、特定のアドレス一覧を表す識別名またはアドレス一覧名の GUID を指定します。パス\アドレス一覧名の形式を使用してパスを含めることもできます。 パラメータ ラベルの Identity を省略して、アドレス一覧名または GUID のみを指定することもできます。
ConditionalCompany	省略可能	Microsoft.Exchange.Data.MultiValuedProperty	ConditionalCompany パラメータは、会社を指定するためのフィルタです。会社属性がこのパラメータに入力した値と一致する受信者全員が、変更対象のアドレス一覧に掲載されます。複数の値を指定するには、値をコンマで区切ります。Conditional パラメータを使用する場合は、IncludedRecipients パラメータを使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。
ConditionalCustomAttribute1	省略可能	Microsoft.Exchange.Data.MultiValuedProperty	ConditionalCustomAttribute1 パラメータには、カスタム属性を指定します。カスタム属性を使用すると、アドレス一覧に情報を追加して、その情報によってアドレス一覧を並べ替えたりグループ化したりすることができます。Conditional パラメータを使用する場合は、IncludedRecipients パラメータを使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。
ConditionalCustomAttribute10	省略可能	Microsoft.Exchange.Data.MultiValuedProperty	ConditionalCustomAttribute10 パラメータには、カスタム属性を指定します。カスタム属性を使用すると、アドレス一覧に情報を追加して、その情報によってアドレス一覧を並べ替えたりグループ化したりすることができます。Conditional パラメータを使用する場合は、IncludedRecipients パラメータを使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。
ConditionalCustomAttribute11	省略可能	Microsoft.Exchange.Data.MultiValuedProperty	ConditionalCustomAttribute11 パラメータには、カスタム属性を指定します。カスタム属性を使用すると、アドレス一覧に情報を追加して、その情報によってアドレス一覧を並べ替えたりグループ化したりすることができます。Conditional パラメータを使用する場合は、IncludedRecipients パラメータを使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。
ConditionalCustomAttribute12	省略可能	Microsoft.Exchange.Data.MultiValuedProperty	ConditionalCustomAttribute12 パラメータには、カスタム属性を指定します。カスタム属性を使用すると、アドレス一覧に情報を追加して、その情報によってアドレス一覧を並べ替えたりグループ化したりすることができます。Conditional パラメータを使用する場合は、IncludedRecipients パラメータを使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。
ConditionalCustomAttribute13	省略可能	Microsoft.Exchange.Data.MultiValuedProperty	ConditionalCustomAttribute13 パラメータには、カスタム属性を指定します。カスタム属性を使用すると、アドレス一覧に情報を追加して、その情報によってアドレス一覧を並べ替えたりグループ化したりすることができます。Conditional パラメータを使用する場合は、IncludedRecipients パラメータを使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。
ConditionalCustomAttribute14	省略可能	Microsoft.Exchange.Data.MultiValuedProperty	ConditionalCustomAttribute14 パラメータには、カスタム属性を指定します。カスタム属性を使用すると、アドレス一覧に情報を追加して、その情報によってアドレス一覧を並べ替えたりグループ化したりすることができます。Conditional パラメータを使用する場合は、IncludedRecipients パラメータを使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。
ConditionalCustomAttribute15	省略可能	Microsoft.Exchange.Data.MultiValuedProperty	ConditionalCustomAttribute15 パラメータには、カスタム属性を指定します。カスタム属性を使用すると、アドレス一覧に情報を追加して、その情報によってアドレス一覧を並べ替えたりグループ化したりすることができます。Conditional パラメータを使用する場合は、IncludedRecipients パラメータを使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。
ConditionalCustomAttribute2	省略可能	Microsoft.Exchange.Data.MultiValuedProperty	ConditionalCustomAttribute2 パラメータには、カスタム属性を指定します。カスタム属性を使用すると、アドレス一覧に情報を追加して、その情報によってアドレス一覧を並べ替えたりグループ化したりすることができます。Conditional パラメータを使用する場合は、IncludedRecipients パラメータを使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。
ConditionalCustomAttribute3	省略可能	Microsoft.Exchange.Data.MultiValuedProperty	ConditionalCustomAttribute3 パラメータには、カスタム属性を指定します。カスタム属性を使用すると、アドレス一覧に情報を追加して、その情報によってアドレス一覧を並べ替えたりグループ化したりすることができます。Conditional パラメータを使用する場合は、IncludedRecipients パラメータを使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。
ConditionalCustomAttribute4	省略可能	Microsoft.Exchange.Data.MultiValuedProperty	ConditionalCustomAttribute4 パラメータには、カスタム属性を指定します。カスタム属性を使用すると、アドレス一覧に情報を追加して、その情報によってアドレス一覧を並べ替えたりグループ化したりすることができます。Conditional パラメータを使用する場合は、IncludedRecipients パラメータを使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。
ConditionalCustomAttribute5	省略可能	Microsoft.Exchange.Data.MultiValuedProperty	ConditionalCustomAttribute5 パラメータには、カスタム属性を指定します。カスタム属性を使用すると、アドレス一覧に情報を追加して、その情報によってアドレス一覧を並べ替えたりグループ化したりすることができます。Conditional パラメータを使用する場合は、IncludedRecipients パラメータを使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。
ConditionalCustomAttribute6	省略可能	Microsoft.Exchange.Data.MultiValuedProperty	ConditionalCustomAttribute6 パラメータには、カスタム属性を指定します。カスタム属性を使用すると、アドレス一覧に情報を追加して、その情報によってアドレス一覧を並べ替えたりグループ化したりすることができます。Conditional パラメータを使用する場合は、IncludedRecipients パラメータを使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。
ConditionalCustomAttribute7	省略可能	Microsoft.Exchange.Data.MultiValuedProperty	ConditionalCustomAttribute7 パラメータには、カスタム属性を指定します。カスタム属性を使用すると、アドレス一覧に情報を追加して、その情報によってアドレス一覧を並べ替えたりグループ化したりすることができます。Conditional パラメータを使用する場合は、IncludedRecipients パラメータを使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。
ConditionalCustomAttribute8	省略可能	Microsoft.Exchange.Data.MultiValuedProperty	ConditionalCustomAttribute8 パラメータには、カスタム属性を指定します。カスタム属性を使用すると、アドレス一覧に情報を追加して、その情報によってアドレス一覧を並べ替えたりグループ化したりすることができます。Conditional パラメータを使用する場合は、IncludedRecipients パラメータを使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。
ConditionalCustomAttribute9	省略可能	Microsoft.Exchange.Data.MultiValuedProperty	ConditionalCustomAttribute9 パラメータには、カスタム属性を指定します。カスタム属性を使用すると、アドレス一覧に情報を追加して、その情報によってアドレス一覧を並べ替えたりグループ化したりすることができます。Conditional パラメータを使用する場合は、IncludedRecipients パラメータを使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。
ConditionalDepartment	省略可能	Microsoft.Exchange.Data.MultiValuedProperty	ConditionalDepartment パラメータは、部門を指定するためのフィルタです。このパラメータに入力した値と一致する部門属性を持つすべての受信者が、アドレス一覧に含められます。複数の値を指定するには、値をコンマで区切ります。Conditional パラメータを使用する場合は、IncludedRecipients パラメータを使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。
ConditionalStateOrProvince	省略可能	Microsoft.Exchange.Data.MultiValuedProperty	ConditionalStateOrProvince パラメータは、都道府県を指定するためのフィルタです。このパラメータに入力した値と一致する ConditionalStateOrProvince 属性を持つすべての受信者が、アドレス一覧に含められます。複数の値を指定するには、値をコンマで区切ります。Conditional パラメータを使用する場合は、IncludedRecipients パラメータを使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。
Confirm	省略可能	System.Management.Automation.SwitchParameter	Confirm パラメータを指定すると、コマンドの処理が一時停止します。処理を続行するには、コマンドの処理内容を確認する必要があります。Confirm パラメータで値を指定する必要はありません。
DisplayName	省略可能	System.String	DisplayName パラメータには、アドレス一覧の表示名を指定します。
DomainController	省略可能	Microsoft.Exchange.Data.Fqdn	この構成の変更を Active Directory ディレクトリ サービスに書き込むドメイン コントローラの完全修飾ドメイン名 (FQDN) を指定するには、コマンドに DomainController パラメータを含めます。
ForceUpgrade	省略可能	System.Management.Automation.SwitchParameter	ForceUpgrade パラメータを指定すると、次の確認メッセージは表示されません。"オブジェクトへの変更を保存するには、オブジェクトを現在の Exchange のバージョンへアップグレードする必要があります。アップグレード後に、このオブジェクトは以前のバージョンの Exchange システム マネージャでは管理できなくなります。アップグレードを継続してオブジェクトを保存しますか"この確認メッセージは、Microsoft Exchange Server 2003 または Exchange 2000 Server で作成したアドレス一覧をアップグレードするときに表示されます。Exchange 2003 または Exchange 2000 のアドレス一覧は、オブジェクトのバージョンを更新し、RecipientFilter または IncludedRecipients パラメータを使用して受信者フィルタを変更するまで、Exchange 管理コンソールを使用して管理することはできません。
IncludedRecipients	省略可能	System.Nullable	IncludedRecipients パラメータは、グローバル アドレス一覧 (GAL) を構築するために使用される受信者の種類にフィルタを適用します。IncludedRecipients パラメータで使用できる値は、AllRecipients、MailboxUsers、Resources、Contacts、および MailGroups です。 AllRecipients は単体でのみ使用できます。IncludedRecipients パラメータに複数の値をコンマで区切って指定すると、OR ブール演算子が適用されます。 Conditional パラメータを使用する場合は、このパラメータを使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。
Instance	省略可能	Microsoft.Exchange.Data.Directory.Management.AddressList	管理者が実際にコマンド ラインで Instance パラメータを使用する必要はほとんどありません。これは開発者の参照用としてパラメータ テーブルに含まれます。
Name	省略可能	System.String	Name パラメータには、アドレス一覧の新しい名前を指定します。名前は 64 文字以内で、改行文字と円記号 (\) を含めることはできません。
RecipientFilter	省略可能	System.String	RecipientFilter パラメータには、アドレス一覧に含める受信者用のフィルタを指定します。次のいずれかのフィルタ パラメータを使用する場合は、このパラメータを使用できません。 ConditionalCompany ConditionalDepartment ConditionalStateOrProvince IncludedRecipients RecipientContainer フィルタ可能なプロパティの詳細については、「-RecipientFilter パラメータのフィルタ可能なプロパティ」を参照してください。
UseRusServer	省略可能	System.String	注 : このパラメータは Exchange 2007 SP2 でのみ使用できます。 UseRusServer パラメータを指定すると、このコマンドで、アドレス一覧サービスを実行している指定のメールボックス サーバーを使用してメールボックスと Active Directory ユーザー属性が取得され、それらが設定されるようになります。 アドレス一覧サービスは、Exchange システム アテンダント サービスのコンポーネントです。アドレス一覧サービスは、Active Directory において Exchange 固有の属性値を作成および管理します。アドレス一覧サービスを使用すると、アドレス一覧メンバシップや電子メール アドレスなどの特定の情報を使用して、ドメイン内の受信者オブジェクトを更新できます。
WhatIf	省略可能	System.Management.Automation.SwitchParameter	WhatIf パラメータには、オブジェクトに対して行われる操作をシミュレートすることを指定します。WhatIf パラメータを使用することで、実際に変更を加えずに、発生する変更内容を表示することができます。WhatIf パラメータで値を指定する必要はありません。

入力の種類

戻り値の種類

エラー

エラー	説明

例外

例外	説明

例

最初の例は、既存のアドレス一覧の名前を変更する方法を示しています。

2 つ目の例は、MyAddressList2 という既存のアドレス一覧に含まれる受信者の種類および部門を変更する方法を示しています。MyAddressList2 は Exchange 2003 のアドレス一覧であるため、このコマンドによってこのアドレス一覧もアップグレードされます。

Set-AddressList -Identity "All Users\Sales\building4" -Name building9
Set-Addresslist -Identity c3fffd8e-026b-41b9-88c4-8c21697ac8ac -IncludedRecipients UserMailbox -ConditionalDepartment Sales -ForceUpgrade:$true

Get-AddressList コマンドを使用して既存のアドレス一覧の GUID、識別名、またはパスと名前を取得し、Format-List にパイプ処理します。または、Get-AddressList を使用して特定の既存のアドレス一覧を取得し、その出力を Set-AddressList に直接パイプ処理します。

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