次の方法で共有

Set-AddressList (RTM)

  • [アーティクル]

 

適用先: Exchange Server 2007

トピックの最終更新日: 2007-10-23

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

構文

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

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

解説

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

省略可能

System.String

ConditionalCustomAttribute1 パラメータには、カスタム属性を指定します。カスタム属性を使用すると、アドレス一覧に情報を追加して、その情報によってアドレス一覧を並べ替えたりグループ化したりすることができます。Conditional パラメータを使用する場合は、IncludedRecipients パラメータを使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。

ConditionalCustomAttribute10

省略可能

System.String

ConditionalCustomAttribute10 パラメータには、カスタム属性を指定します。カスタム属性を使用すると、アドレス一覧に情報を追加して、その情報によってアドレス一覧を並べ替えたりグループ化したりすることができます。Conditional パラメータを使用する場合は、IncludedRecipients パラメータを使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。

ConditionalCustomAttribute11

省略可能

System.String

ConditionalCustomAttribute11 パラメータには、カスタム属性を指定します。カスタム属性を使用すると、アドレス一覧に情報を追加して、その情報によってアドレス一覧を並べ替えたりグループ化したりすることができます。Conditional パラメータを使用する場合は、IncludedRecipients パラメータを使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。

ConditionalCustomAttribute12

省略可能

System.String

ConditionalCustomAttribute12 パラメータには、カスタム属性を指定します。カスタム属性を使用すると、アドレス一覧に情報を追加して、その情報によってアドレス一覧を並べ替えたりグループ化したりすることができます。Conditional パラメータを使用する場合は、IncludedRecipients パラメータを使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。

ConditionalCustomAttribute13

省略可能

System.String

ConditionalCustomAttribute13 パラメータには、カスタム属性を指定します。カスタム属性を使用すると、アドレス一覧に情報を追加して、その情報によってアドレス一覧を並べ替えたりグループ化したりすることができます。Conditional パラメータを使用する場合は、IncludedRecipients パラメータを使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。

ConditionalCustomAttribute14

省略可能

System.String

ConditionalCustomAttribute14 パラメータには、カスタム属性を指定します。カスタム属性を使用すると、アドレス一覧に情報を追加して、その情報によってアドレス一覧を並べ替えたりグループ化したりすることができます。Conditional パラメータを使用する場合は、IncludedRecipients パラメータを使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。

ConditionalCustomAttribute15

省略可能

System.String

ConditionalCustomAttribute15 パラメータには、カスタム属性を指定します。カスタム属性を使用すると、アドレス一覧に情報を追加して、その情報によってアドレス一覧を並べ替えたりグループ化したりすることができます。Conditional パラメータを使用する場合は、IncludedRecipients パラメータを使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。

ConditionalCustomAttribute2

省略可能

System.String

ConditionalCustomAttribute2 パラメータには、カスタム属性を指定します。カスタム属性を使用すると、アドレス一覧に情報を追加して、その情報によってアドレス一覧を並べ替えたりグループ化したりすることができます。Conditional パラメータを使用する場合は、IncludedRecipients パラメータを使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。

ConditionalCustomAttribute3

省略可能

System.String

ConditionalCustomAttribute3 パラメータには、カスタム属性を指定します。カスタム属性を使用すると、アドレス一覧に情報を追加して、その情報によってアドレス一覧を並べ替えたりグループ化したりすることができます。Conditional パラメータを使用する場合は、IncludedRecipients パラメータを使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。

ConditionalCustomAttribute4

省略可能

System.String

ConditionalCustomAttribute4 パラメータには、カスタム属性を指定します。カスタム属性を使用すると、アドレス一覧に情報を追加して、その情報によってアドレス一覧を並べ替えたりグループ化したりすることができます。Conditional パラメータを使用する場合は、IncludedRecipients パラメータを使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。

ConditionalCustomAttribute5

省略可能

System.String

ConditionalCustomAttribute5 パラメータには、カスタム属性を指定します。カスタム属性を使用すると、アドレス一覧に情報を追加して、その情報によってアドレス一覧を並べ替えたりグループ化したりすることができます。Conditional パラメータを使用する場合は、IncludedRecipients パラメータを使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。

ConditionalCustomAttribute6

省略可能

System.String

ConditionalCustomAttribute6 パラメータには、カスタム属性を指定します。カスタム属性を使用すると、アドレス一覧に情報を追加して、その情報によってアドレス一覧を並べ替えたりグループ化したりすることができます。Conditional パラメータを使用する場合は、IncludedRecipients パラメータを使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。

ConditionalCustomAttribute7

省略可能

System.String

ConditionalCustomAttribute7 パラメータには、カスタム属性を指定します。カスタム属性を使用すると、アドレス一覧に情報を追加して、その情報によってアドレス一覧を並べ替えたりグループ化したりすることができます。Conditional パラメータを使用する場合は、IncludedRecipients パラメータを使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。

ConditionalCustomAttribute8

省略可能

System.String

ConditionalCustomAttribute8 パラメータには、カスタム属性を指定します。カスタム属性を使用すると、アドレス一覧に情報を追加して、その情報によってアドレス一覧を並べ替えたりグループ化したりすることができます。Conditional パラメータを使用する場合は、IncludedRecipients パラメータを使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。

ConditionalCustomAttribute9

省略可能

System.String

ConditionalCustomAttribute9 パラメータには、カスタム属性を指定します。カスタム属性を使用すると、アドレス一覧に情報を追加して、その情報によってアドレス一覧を並べ替えたりグループ化したりすることができます。Conditional パラメータを使用する場合は、IncludedRecipients パラメータを使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。

ConditionalDepartment

省略可能

Microsoft.Exchange.Data.MultiValuedProperty

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

ConditionalStateOrProvince

省略可能

Microsoft.Exchange.Data.MultiValuedProperty

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

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 で作成したアドレス一覧をアップグレードするときに表示されます。オブジェクトのバージョンを更新し、RecipientFilter パラメータまたは IncludedRecipients パラメータを使用して受信者フィルタを変更するまで、Exchange 管理コンソールでは Exchange 2003 または Exchange 2000 のアドレス一覧を管理できません。

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 パラメータのフィルタ可能なプロパティ」を参照してください。

入力の種類

戻り値の種類

エラー

エラー 説明

 

 

例外

例外 説明

 

 

例

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

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 を参照してください。