Set-IPBlockListProvidersConfig

  • リファレンス
モジュール:
ExchangePowerShell
適用対象:
Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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

Set-IPBlockListProvidersConfig コマンドレットを使って、エッジ トランスポート サーバーに構成されたすべての IP 禁止一覧プロバイダーに影響する設定を変更します。

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

構文

Set-IPBlockListProvidersConfig
   [-BypassedRecipients <MultiValuedProperty>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Enabled <Boolean>]
   [-ExternalMailEnabled <Boolean>]
   [-InternalMailEnabled <Boolean>]
   [-WhatIf]
   [<CommonParameters>]

説明

エッジ トランスポート サーバー上では、IP 禁止一覧プロバイダーは接続フィルター エージェントによって使用されます。 接続フィルター エージェントは受信 SMTP 接続の IP アドレスを基に、受信メッセージに対して行う処理がある場合にどの処理を行うかを判断します。

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

例

例 1

Set-IPBlockListProvidersConfig -InternalMailEnabled $true -BypassedRecipients kweku@contoso.com

この例では、内部接続から送信されるが、 に送信される電子メール メッセージのフィルター処理をバイパスするメッセージで IP ブロック リスト プロバイダーを使用するように接続フィルター処理を kweku@contoso.com構成します。

例 2

Set-IPBlockListProvidersConfig -BypassedRecipients @{Add="chris@contoso.com","michelle@contoso.com"; Remove="laura@contoso.com","julia@contoso.com"}

この例では、バイパスする受信者の一覧を次のように変更します。

  • 値 chris@contoso.com を追加し、 michelle@contoso.com
  • 値 laura@contoso.com を削除し、 julia@contoso.com

パラメーター

-BypassedRecipients

BypassedRecipients パラメーターは、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

-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 です。 既定値は $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

-ExternalMailEnabled

ExternalMailEnabled パラメーターは、Exchange 組織外の接続からのメッセージを 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

-InternalMailEnabled

InternalMailEnabled パラメーターは、Exchange 組織内の接続からのメッセージを IP ブロック リスト プロバイダーによって評価するかどうかを指定します。 このパラメーターの有効な入力値は、$true または $false です。 既定値は $false です。 既定では、内部接続からのメッセージは 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

-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

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