Add-IPAllowListProvider

  • [アーティクル]

 

適用先: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

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

エッジ トランスポート サーバーの役割またはハブ トランスポート サーバーの役割がインストールされているコンピュータで新しい IP 許可一覧プロバイダ構成を作成するには、Add-IPAllowListProvider コマンドレットを使用します。

構文

Add-IPAllowListProvider -Name <String> -LookupDomain <SmtpDomain> [-AnyMatch <$true | $false>] [-BitmaskMatch <IPAddress>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-IPAddressesMatch <MultiValuedProperty>] [-Priority <Int32>] [-TemplateInstance <PSObject>] [-WhatIf [<SwitchParameter>]]

解説

IP 許可一覧プロバイダ構成は、接続フィルタ エージェントによって使用されます。

Name パラメータと LookupDomain パラメータは必須です。必須のパラメータを渡さなかった場合は、Exchange 管理シェルによってパラメータの入力を求められます。

Add-IPAllowListProvider コマンドレットを実行するには、使用するアカウントに以下が委任されている必要があります。

  • Exchange サーバー管理者の役割および対象サーバーのローカル Administrators グループ

エッジ トランスポート サーバーの役割がインストールされているコンピュータで Add-IPAllowListProvider コマンドレットを実行するには、そのコンピュータのローカルの Administrators グループのメンバであるアカウントを使用してログオンする必要があります。

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

パラメータ

パラメータ 必須 種類 説明

LookupDomain

必須

Microsoft.Exchange.Data.SmtpDomain

接続フィルタ エージェントが更新された IP 許可一覧の情報に対するクエリを実行するドメイン名です。

Name

必須

System.String

IP 許可一覧プロバイダ サービスの名前です。

AnyMatch

省略可能

System.Boolean

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

BitmaskMatch

省略可能

System.Net.IPAddress

IP アドレスを使用するように BitmaskMatch パラメータを構成すると、接続フィルタ エージェントは、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 許可一覧プロバイダ サービスに対してクエリを実行します。

IPAddressesMatch

省略可能

Microsoft.Exchange.Data.MultiValuedProperty

IPAddressMatch パラメータに対して IP アドレスを構成すると、接続フィルタ エージェントは、IP 許可一覧プロバイダ サービスによって返される IP アドレス状態コードに一致するメッセージに対してのみ処理を実行します。

Priority

省略可能

System.Int32

Priority パラメータは、構成した IP 許可一覧プロバイダ サービスに対して接続フィルタ エージェントがクエリを実行する順序を構成する場合に設定します。既定では、新しい IP 許可一覧プロバイダ サービスを追加するたびに、エントリに優先度 N + 1 が割り当てられます。ここで N は既に構成した IP 許可一覧プロバイダ サービスの数です。

Priority パラメータを別の IP 許可一覧プロバイダ サービスと同じ値に設定すると、最初に追加した IP 許可一覧プロバイダの優先度の値が 1 大きくなります。

TemplateInstance

省略可能

System.Management.Automation.PSObject

このパラメータに既存のオブジェクトを指定した場合、このコマンドはそのオブジェクトの構成を使用して、ローカルまたはターゲット サーバーにそのオブジェクトの完全なコピーを作成します。

WhatIf

省略可能

System.Management.Automation.SwitchParameter

WhatIf パラメータには、オブジェクトに対して行われる操作をシミュレートすることを指定します。WhatIf パラメータを使用することで、実際に変更を加えずに、発生する変更内容を表示することができます。WhatIf パラメータで値を指定する必要はありません。

入力の種類

戻り値の種類

エラー

エラー 説明

 

 

例

次のコード例は、必須パラメータである LookupDomain および Name を指定した Add-IPAllowListProvider コマンドを示しています。

Add-IPAllowListProvider -Name:Example -LookupDomain:Example.com

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