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 パラメータには、アドレス一覧に含める受信者用のフィルタを指定します。次のいずれかのフィルタ パラメータを使用する場合は、このパラメータを使用できません。
フィルタ可能なプロパティの詳細については、「-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 を参照してください。