Set-IPAllowListProvider
このコマンドレットは、オンプレミスの Exchange のエッジ トランスポート サーバーでのみ使用可能または有効になります。
エッジ トランスポート サーバーで接続フィルター エージェントが使用する IP 許可一覧プロバイダーを変更するには、Set-IPAllowListProvider コマンドレットを使用します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Default (既定)
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
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
AnyMatch パラメーターは、許可一覧プロバイダーによる応答を一致として処理するかどうかを指定します。 このパラメーターの有効な入力値は、$true または $false です。 既定値は $false です。 このパラメーターが $true に設定されている場合、接続フィルターが接続元の SMTP サーバーの IP アドレスを許可一覧プロバイダーに送信すると、許可一覧プロバイダーによって返されるどの応答コードによっても、接続フィルターはそのソースからのメッセージを許可します。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-BitmaskMatch
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
BitmaskMatch パラメーターは、許可一覧プロバイダーによって返されるビット マスクの状態コードを指定します。 許可一覧プロバイダーによってビット マスクの応答が返された場合は、このパラメーターを使用します。 このパラメーターに対する有効な入力は、127.0.0.1 形式の単一の IP アドレスです。
パラメーターのプロパティ
| 型: | IPAddress |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Confirm
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。
- データを破壊するコマンドレット (たとえば、Remove- コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文
-Confirm:$falseを使用して、確認プロンプトを省略できます。 - 他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DomainController
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。
DomainController パラメーターは、エッジ トランスポート サーバーではサポートされません。 エッジ トランスポート サーバーは、Active Directory ライトウェイト ディレクトリ サービス (AD LDS) のローカル インスタンスを使用してデータの読み書きを行います。
パラメーターのプロパティ
| 型: | Fqdn |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Enabled
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
Enabled パラメーターには、接続フィルター エージェントが IP 許可一覧プロバイダーに対し、この IP 許可一覧プロバイダー構成で設定されている優先度に従ってクエリを実行するかどうかを指定します。 このパラメーターの有効な入力値は、$true または $false です。 既定値は $true です。 既定では、接続フィルター エージェントが IP 許可一覧プロバイダーに対し、この IP 許可一覧プロバイダー構成で設定されている優先度に従ってクエリを実行します。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Identity
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
Identity パラメーターは、変更する IP 許可一覧プロバイダーを指定します。 IP 許可一覧プロバイダーを一意に識別する任意の値を使用できます。 たとえば、
- 名前
- 識別名 (DN)
- GUID
パラメーターのプロパティ
| 型: | IPAllowListProviderIdParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-IPAddressesMatch
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
IPAddressesMatch パラメーターは、許可一覧プロバイダーによって返される IP アドレスの状態コードを指定します。 許可一覧プロバイダーによって IP アドレスまたは A レコードの応答が返された場合は、このパラメーターを使用します。 このパラメーターに対する有効な入力は、127.0.0.1 形式の 1 つ以上の IP アドレスです。
複数の値を入力して既存のエントリをすべて上書きするには、次の構文を使用します: Value1,Value2,...ValueN。 値にスペースを含める、または引用符を必要とする場合は、次の構文を使用します: "Value1","Value2",..."ValueN"。
既存のエントリに影響を及ぼさずに、1 つまたは複数の値を追加または削除するには、次の構文を使用します: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
パラメーターのプロパティ
| 型: | MultiValuedProperty |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-LookupDomain
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
LookupDomain パラメーターは、許可一覧プロバイダーを使用するために必要なホスト名を指定します。 接続フィルターは、接続元の SMTP サーバーの IP アドレスを、指定したホスト名の値に送信します。 たとえば、allowlist.spamservice.com のような値になります。 使用する必要がある実際の値は、許可一覧プロバイダーによって提供されます。
パラメーターのプロパティ
| 型: | SmtpDomain |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Name
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
Name パラメーターは、IP 許可一覧プロバイダーにわかりやすい名前を指定します。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Priority
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
Priority パラメーターは、接続フィルター エージェントが構成した IP 許可リスト プロバイダーに対してクエリを実行する順序を指定します。 既定では、新しい IP 許可リスト プロバイダーを追加するたびに、エントリには優先度 N+1 が割り当てられます。N は、構成した IP 許可リスト プロバイダーの数です。
Priority パラメーターを別の IP 許可一覧プロバイダーと同じ値に設定すると、最初に追加した IP 許可一覧プロバイダーの優先度の値が 1 大きくなります。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WhatIf
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
WhatIf スイッチは、コマンドの操作をシミュレートします。 このスイッチを使用すると、実際にその変更内容を適用せずに、発生する変更を確認できます。 このスイッチで値を指定する必要はありません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | ウィスコンシン |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、「about_CommonParameters」を参照してください。
入力
Input types
このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。
出力
Output types
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。