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 に含めるためのフィルタを指定します。次のいずれかのフィルタ パラメータを使用する場合は、このパラメータを使用できません。
このパラメータか、上に示したフィルタ パラメータのいずれかを使用する必要があります。 フィルタ可能なプロパティの詳細については、「-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 を参照してください。