Set-GlobalAddressList (RTM)

  • [アーティクル]

 

適用先: Exchange Server 2007

トピックの最終更新日: 2007-06-05

Active Directory ディレクトリ サービスでグローバル アドレス一覧 (GAL) の属性を変更するには、Set-GlobalAddressList コマンドレットを使用します。

構文

Set-GlobalAddressList -Identity <GlobalAddressListIdParameter> [-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>] [-DomainController <Fqdn>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Name <String>] [-RecipientFilter <String>]

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

解説

Set-GlobalAddressList コマンドレットでは、GAL のプロパティを変更できます。

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

  • Exchange 組織管理者の役割

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

パラメータ

パラメータ 必須 種類 説明

Identity

必須

Microsoft.Exchange.Configuration.Tasks.GlobalAddressListIdParameter

特定のグローバル アドレス一覧 (GAL) を表す GUID、識別名、または GAL 名を指定するには、Identity パラメータを使用します。また、Path\GlobalAddressListName という形式を使用してパスを含めることもできます。

パラメータ ラベルの Identity を省略して、GAL 名または GUID のみを指定することもできます。

ConditionalCompany

省略可能

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCompany パラメータは、会社を指定するために使用します。複数の値を指定するには、値をコンマで区切ります。Conditional パラメータを使用する場合は、IncludedRecipients パラメータも使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。

ConditionalCustomAttribute1

省略可能

System.String

このパラメータは、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。Conditional パラメータを使用する場合は、IncludedRecipients パラメータも使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。

ConditionalCustomAttribute10

省略可能

System.String

このパラメータは、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。Conditional パラメータを使用する場合は、IncludedRecipients パラメータも使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。

ConditionalCustomAttribute11

省略可能

System.String

このパラメータは、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。Conditional パラメータを使用する場合は、IncludedRecipients パラメータも使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。

ConditionalCustomAttribute12

省略可能

System.String

このパラメータは、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。Conditional パラメータを使用する場合は、IncludedRecipients パラメータも使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。

ConditionalCustomAttribute13

省略可能

System.String

このパラメータは、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。Conditional パラメータを使用する場合は、IncludedRecipients パラメータも使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。

ConditionalCustomAttribute14

省略可能

System.String

このパラメータは、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。Conditional パラメータを使用する場合は、IncludedRecipients パラメータも使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。

ConditionalCustomAttribute15

省略可能

System.String

このパラメータは、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。Conditional パラメータを使用する場合は、IncludedRecipients パラメータも使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。

ConditionalCustomAttribute2

省略可能

System.String

このパラメータは、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。

ConditionalCustomAttribute3

省略可能

System.String

このパラメータは、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。Conditional パラメータを使用する場合は、IncludedRecipients パラメータも使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。

ConditionalCustomAttribute4

省略可能

System.String

このパラメータは、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。Conditional パラメータを使用する場合は、IncludedRecipients パラメータも使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。

ConditionalCustomAttribute5

省略可能

System.String

このパラメータは、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。Conditional パラメータを使用する場合は、IncludedRecipients パラメータも使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。

ConditionalCustomAttribute6

省略可能

System.String

このパラメータは、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。Conditional パラメータを使用する場合は、IncludedRecipients パラメータも使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。

ConditionalCustomAttribute7

省略可能

System.String

このパラメータは、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。Conditional パラメータを使用する場合は、IncludedRecipients パラメータも使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。

ConditionalCustomAttribute8

省略可能

System.String

このパラメータは、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。Conditional パラメータを使用する場合は、IncludedRecipients パラメータも使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。

ConditionalCustomAttribute9

省略可能

System.String

このパラメータは、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。Conditional パラメータを使用する場合は、IncludedRecipients パラメータも使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。

ConditionalDepartment

省略可能

Microsoft.Exchange.Data.MultiValuedProperty

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

DomainController

省略可能

Microsoft.Exchange.Data.Fqdn

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

ForceUpgrade

省略可能

System.Management.Automation.SwitchParameter

ForceUpgrade パラメータを指定すると、次の確認メッセージは表示されません。"オブジェクトへの変更を保存するには、オブジェクトを現在の Exchange のバージョンへアップグレードする必要があります。アップグレード後に、このオブジェクトは以前のバージョンの Exchange システム マネージャでは管理できなくなります。アップグレードを継続してオブジェクトを保存しますか"この確認メッセージは、Microsoft Exchange Server 2003 または Exchange 2000 Server で作成された GAL をアップグレードするときに表示されます。オブジェクトのバージョンを更新し、RecipientFilter または IncludedRecipients パラメータを使用して受信者フィルタを変更するまで、Exchange 管理コンソールでは Exchange 2003 または Exchange 2000 の GAL を管理できません。

IncludedRecipients

省略可能

System.Nullable

IncludedRecipients パラメータは、GAL を構築するために使用される受信者の種類にフィルタを適用します。IncludedRecipients パラメータで使用できる値は、AllRecipients、MailboxUsers、Resources、Contacts、および MailGroups です。

AllRecipients は単体でのみ使用できます。IncludedRecipients パラメータに複数の値をコンマで区切って指定すると、OR ブール演算子が適用されます。

Conditional パラメータを使用する場合は、このパラメータを使用する必要があります。RecipientFilter パラメータを使用する場合は、このパラメータを使用できません。

Instance

省略可能

Microsoft.Exchange.Data.Directory.Management.GlobalAddressList

Instance パラメータを使用すると、オブジェクト全体をコマンドに渡して処理することができます。オブジェクト全体をコマンドに渡す必要があるスクリプトで主に使用されます。

Name

省略可能

System.String

特にありません。

RecipientFilter

省略可能

System.String

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

  • ConditionalCompany
  • ConditionalDepartment
  • IncludedRecipients
  • ConditionalStateorProvince

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

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

ConditionalStateOrProvince

省略可能

Microsoft.Exchange.Data.MultiValuedProperty

特にありません。

入力の種類

戻り値の種類

エラー

エラー 説明

 

例外

例外 説明

 

例

次の例では、Set-GlobalAddressList コマンドを使用して、GUID が 96d0c505-eba8-4103-ad4f-577a1bf4ad7b の GAL に、GALwithNewName という新しい名前を設定します。

Set-GlobalAddressList 96d0c505-eba8-4103-ad4f-577a1bf4ad7b -Name GALwithNewName

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