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 パラメータに対する有効な入力は、$true または $false です。既定の設定は $false です。AnyMatch パラメータが $true に設定されている場合、接続フィルタ エージェントは IP 許可一覧プロバイダ サービスによって返される IP アドレス状態コードをすべて一致として扱います。

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 パラメータに対する有効な入力は、$true または $false です。既定の設定は $true です。Enabled パラメータが $true に設定されている場合、接続フィルタ エージェントは、この IP 許可一覧プロバイダ構成に対して設定されている優先度に従って、IP 許可一覧プロバイダ サービスに対してクエリを実行します。

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