Set-IPAllowListProvider
適用先: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
トピックの最終更新日: 2007-06-28
エッジ トランスポート サーバーの役割またはハブ トランスポート サーバーの役割がインストールされているコンピュータで特定の IP 許可一覧プロバイダ構成の構成情報を変更するには、Set-IPAllowListProvider コマンドレットを使用します。
構文
Set-IPAllowListProvider -Identity <IPAllowListProviderIdParameter> [-AnyMatch <$true | $false>] [-BitmaskMatch <IPAddress>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-IPAddressesMatch <MultiValuedProperty>] [-LookupDomain <SmtpDomain>] [-Name <String>] [-Priority <Int32>] [-WhatIf [<SwitchParameter>]]
Set-IPAllowListProvider [-AnyMatch <$true | $false>] [-BitmaskMatch <IPAddress>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-Instance <IPAllowListProvider>] [-IPAddressesMatch <MultiValuedProperty>] [-LookupDomain <SmtpDomain>] [-Name <String>] [-Priority <Int32>] [-WhatIf [<SwitchParameter>]]
解説
既存の IP 許可一覧プロバイダ構成を変更するには、Set-IPAllowListProvider コマンドレットを使用します。この構成は、接続フィルタ エージェントによって使用されます。Identity パラメータは必須です。
Set-IPAllowListProvider コマンドレットを実行するには、使用するアカウントに次の権限が委任されている必要があります。
- Exchange サーバー管理者の役割および対象サーバーのローカル Administrators グループ
エッジ トランスポート サーバーの役割がインストールされているコンピュータで Set-IPAllowListProvider コマンドレットを実行するには、そのコンピュータのローカルの Administrators グループのメンバであるアカウントを使用してログオンする必要があります。
アクセス許可、役割の委任、および Microsoft Exchange Server 2007 を管理するために必要な権限の詳細については、「アクセス許可に関する考慮事項」を参照してください。
パラメータ
| パラメータ | 必須 | 種類 | 説明 |
|---|---|---|---|
Identity |
必須 |
Microsoft.Exchange.Configuration.Tasks.IPAllowListProviderIdParameter |
Identity パラメータには、Name 値である文字列値、または GUID を指定することができます。 |
AnyMatch |
省略可能 |
System.Boolean |
AnyMatch パラメータに対する有効な入力は、 |
BitmaskMatch |
省略可能 |
System.Net.IPAddress |
BitmaskMatch パラメータに対して IP アドレスを構成すると、接続フィルタ エージェントは、IP 許可一覧プロバイダ サービスによって返される IP アドレス状態コードに一致するメッセージに対してのみ処理を実行します。 |
Confirm |
省略可能 |
System.Management.Automation.SwitchParameter |
Confirm パラメータを指定すると、コマンドの処理が一時停止します。処理を続行するには、コマンドの処理内容を確認する必要があります。Confirm パラメータで値を指定する必要はありません。 |
DomainController |
省略可能 |
Microsoft.Exchange.Data.Fqdn |
接続フィルタの構成データに対するこの構成の変更を Active Directory ディレクトリ サービスに書き込むドメイン コントローラを指定するには、コマンドに DomainController パラメータを含めます。エッジ トランスポート サーバーの役割がインストールされているコンピュータでこのコマンドを実行する場合、DomainController パラメータはサポートされません。エッジ トランスポート サーバーは、ローカルの ADAM インスタンスにのみ書き込みを行います。 |
Enabled |
省略可能 |
System.Boolean |
Enabled パラメータに対する有効な入力は、 |
Instance |
省略可能 |
Microsoft.Exchange.Data.Directory.SystemConfiguration.IPAllowListProvider |
Instance パラメータを使用すると、オブジェクト全体をコマンドに渡して処理することができます。オブジェクト全体をコマンドに渡す必要があるスクリプトで主に使用されます。 |
IPAddressesMatch |
省略可能 |
Microsoft.Exchange.Data.MultiValuedProperty |
IPAddressesMatch パラメータに対して IP アドレスを構成すると、接続フィルタ エージェントは、IP 許可一覧プロバイダ サービスによって返される IP アドレス状態コードに一致するメッセージに対してのみ処理を実行します。 |
LookupDomain |
省略可能 |
Microsoft.Exchange.Data.SmtpDomain |
接続フィルタ エージェントが更新された IP 許可一覧のデータに対するクエリを実行するドメイン名です。 |
Name |
省略可能 |
System.String |
IP 許可一覧プロバイダ サービスの名前です。この値を変更しても、Identity パラメータの文字列値は変更されません。 |
Priority |
省略可能 |
System.Int32 |
Priority パラメータは、構成した IP 許可一覧プロバイダ サービスに対して接続フィルタ エージェントがクエリを実行する順序を構成する場合に設定します。既定では、新しい IP 許可一覧プロバイダ サービスを追加するたびに、エントリに優先度 N + 1 が割り当てられます。ここで N は既に構成した IP 許可一覧プロバイダ サービスの数です。 Priority パラメータを別の IP 許可一覧プロバイダ サービスと同じ値に設定すると、最初に追加した IP 許可一覧プロバイダの優先度の値が 1 大きくなります。 |
WhatIf |
省略可能 |
System.Management.Automation.SwitchParameter |
WhatIf パラメータには、オブジェクトに対して行われる操作をシミュレートすることを指定します。WhatIf パラメータを使用することで、実際に変更を加えずに、発生する変更内容を表示することができます。WhatIf パラメータで値を指定する必要はありません。 |
入力の種類
戻り値の種類
エラー
| エラー | 説明 |
|---|---|
|
例
最初のコード例は、IP 許可一覧プロバイダ サービスによる一致をすべて処理対象イベントとして扱うように接続フィルタを設定する Set-IPAllowListProvider コマンドを示しています。
2 番目のコード例は、既存の構成の優先度を 1 に設定する Set-IPAllowListProvider コマンドを示しています。
Set-IPAllowListProvider -Identity Example.com -AnyMatch:$true
Set-IPAllowListProvider -Identity Example.com -Priority 1
参照している情報が最新であることを確認したり、他の Exchange Server 2007 ドキュメントを見つけたりするには、Exchange Server TechCenter を参照してください。