Set-IPAllowListProvider

リファレンス

モジュール:: ExchangePowerShell

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

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

エッジトランスポートサーバーで接続フィルターエージェントが使用する IP 許可一覧プロバイダーを変更するには、Set-IPAllowListProvider コマンドレットを使用します。

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

構文

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

説明

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

例

例 1

Set-IPAllowListProvider Contoso.com -AnyMatch $true

次の例では、IP アドレス状態コードが返される場合に、この IP アドレスからの接続を許可するよう Contoso.com という IP 許可一覧プロバイダーを構成しています。

例 2

Set-IPAllowListProvider Contoso.com -Priority 1

次の例では、Contoso.com という既存の IP 許可一覧プロバイダーの優先度を 1 に設定しています。

パラメーター

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

-Identity

Identity パラメーターは、変更する IP 許可一覧プロバイダーを指定します。 IP 許可一覧プロバイダーを一意に識別する任意の値を使用できます。たとえば、

名前
識別名 (DN)
GUID

Type:	IPAllowListProviderIdParameter
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
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 アドレスです。

複数の値を入力し、既存のエントリを上書きするには、次の構文を使用します。 Value1,Value2,...ValueN 値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "Value1","Value2",..."ValueN"

既存のエントリに影響を与えずに 1 つ以上の値を追加または削除するには、次の構文を使用します。 @{Add="Value1","Value2"...; Remove="Value3","Value4"...}

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:	False
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:	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

-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

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