Add-IPAllowListProvider

リファレンス

モジュール:: ExchangePowerShell

適用対象:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

このコマンドレットは、オンプレミスの Exchange のエッジトランスポートサーバーでのみ使用可能または有効になります。

Add-IPAllowListProvider コマンドレットを使用して、エッジトランスポートサーバー上の接続フィルターエージェントによって使用される IP 許可リストプロバイダーを作成します。

以下の構文セクションのパラメーターセットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

Add-IPAllowListProvider
   [-Name] <String>
   -LookupDomain <SmtpDomain>
   [-AnyMatch <Boolean>]
   [-BitmaskMatch <IPAddress>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Enabled <Boolean>]
   [-IPAddressesMatch <MultiValuedProperty>]
   [-Priority <Int32>]
   [-WhatIf]
   [<CommonParameters>]

説明

エッジトランスポートサーバーで、このコマンドレットを実行するには、ローカルの Administrators グループのメンバーである必要があります。

例

例 1

Add-IPAllowListProvider -Name "Contoso.com Allow List" -LookupDomain allowlist.contoso.com -AnyMatch $true

この例では、新しい IP 許可リストプロバイダーを追加し、IP 許可リストプロバイダーから返されたすべての IP アドレス状態コードを一致として処理し、接続を許可するように接続フィルター処理を構成します。 LookupDomain パラメーターの値は、許可リストプロバイダーから取得します。

例 2

Add-IPAllowListProvider -Name "Fabrikam.com Allow List" -LookupDomain allowlist.fabrikam.com -BitmaskMatch 127.1.0.1

次の使用例は、IP 許可リストプロバイダーを追加し、プロバイダーからのビットマスクの戻り値を構成します。許可リストプロバイダーから LookupDomain パラメーターと BitmaskMatch パラメーターの値を取得します。

パラメーター

-AnyMatch

AnyMatch パラメーターは、許可一覧プロバイダーによる応答を一致として処理するかどうかを指定します。このパラメーターの有効な入力値は、$true または $false です。既定値は $false です。このパラメーターが $true に設定されている場合、接続フィルターが接続元の SMTP サーバーの IP アドレスを許可一覧プロバイダーに送信すると、許可一覧プロバイダーによって返されるどの応答コードによっても、接続フィルターはそのソースからのメッセージを許可します。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-BitmaskMatch

BitmaskMatch パラメーターは、許可一覧プロバイダーによって返されるビットマスクの状態コードを指定します。許可一覧プロバイダーによってビットマスクの応答が返された場合は、このパラメーターを使用します。このパラメーターに対する有効な入力は、127.0.0.1 形式の単一の IP アドレスです。

Type:	IPAddress
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Confirm

Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。

破壊的なコマンドレット (Remove-* コマンドレットなど) には、続行する前にコマンドの確認を強制する組み込みの一時停止があります。これらのコマンドレットでは、正確な構文-Confirm:$falseを使用して、確認プロンプトを省略できます。
他のほとんどのコマンドレット (New-* コマンドレットや Set-* コマンドレットなど) には、一時停止が組み込まれています。これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DomainController

DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメインコントローラーを指定します。ドメインコントローラーは、完全修飾ドメイン名 (FQDN) で識別します。たとえば、dc01.contoso.com です。

DomainController パラメーターは、エッジトランスポートサーバーではサポートされません。エッジトランスポートサーバーは、Active Directory ライトウェイトディレクトリサービス (AD LDS) のローカルインスタンスを使用してデータの読み書きを行います。

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Enabled

Enabled パラメーターは、接続フィルター処理でこの IP 許可リストプロバイダーを使用するかどうかを指定します。このパラメーターの有効な入力値は、$true または $false です。既定値は $true です。既定では、接続フィルター処理では、作成した新しい IP 許可リストプロバイダーが使用されます。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-IPAddressesMatch

IPAddressesMatch パラメーターは、許可一覧プロバイダーによって返される IP アドレスの状態コードを指定します。許可一覧プロバイダーによって IP アドレスまたは A レコードの応答が返された場合は、このパラメーターを使用します。このパラメーターに対する有効な入力は、127.0.0.1 形式の 1 つ以上の IP アドレスです。複数の IP アドレスをコンマで区切って入力できます。

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-LookupDomain

LookupDomain パラメーターは、許可一覧プロバイダーを使用するために必要なホスト名を指定します。接続フィルターは、接続元の SMTP サーバーの IP アドレスを、指定したホスト名の値に送信します。たとえば、allowlist.spamservice.com のような値になります。使用する必要がある実際の値は、許可一覧プロバイダーによって提供されます。

Type:	SmtpDomain
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Name

Name パラメーターは、IP 許可一覧プロバイダーにわかりやすい名前を指定します。

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Priority

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

Priority パラメーターを別の IP 許可リストプロバイダーと同じ値に設定した場合、最初に追加する IP 許可リストプロバイダーの優先順位は 1 ずつ増やされます。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-WhatIf

WhatIf スイッチは、コマンドの操作をシミュレートします。このスイッチを使用すると、実際にその変更内容を適用せずに、発生する変更を確認できます。このスイッチで値を指定する必要はありません。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

入力

Input types

このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。

出力

Output types

このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。

次の方法で共有