Set-MalwareFilteringServer

リファレンス

モジュール:: ExchangePowerShell

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

このコマンドレットは、オンプレミスの Exchange でのみ使用可能です。

メールボックスサーバーのトランスポートサービスのマルウェアエージェント設定を構成するには、Set-MalwareFilteringServer コマンドレットを使用します。

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

構文

Set-MalwareFilteringServer
   [-Identity] <MalwareFilteringServerIdParameter>
   [-BypassFiltering <Boolean>]
   [-Confirm]
   [-DeferAttempts <Int32>]
   [-DeferWaitTime <Int32>]
   [-DomainController <Fqdn>]
   [-ForceRescan <Boolean>]
   [-MinimumSuccessfulEngineScans <Int32>]
   [-PrimaryUpdatePath <String>]
   [-ScanErrorAction <MalwareScanErrorAction>]
   [-ScanTimeout <Int32>]
   [-SecondaryUpdatePath <String>]
   [-UpdateFrequency <Int32>]
   [-UpdateTimeout <Int32>]
   [-WhatIf]
   [<CommonParameters>]

説明

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。

例

例 1

Set-MalwareFilteringServer Mailbox01 -UpdateFrequency 120 -DeferWaitTime 10

この例では、Mailbox01 というメールボックスサーバーで次のようなマルウェアエージェント設定を行います。

更新間隔を 2 時間に設定する。
再送信の試行までの待機時間を 10 分に設定する。

パラメーター

-BypassFiltering

BypassFiltering パラメーターは、サーバーでマルウェアエージェントを無効にせずに、マルウェアフィルターを一時的にバイパスします。マルウェアエージェントはアクティブなままで、すべてのメッセージ用に呼び出されますが、マルウェアフィルターは実際には実行されません。これにより、Microsoft Exchange トランスポートサービスを再起動し、メールフローを中断することなく、サーバー上でマルウェアフィルターを一時的に無効にしてから有効にすることができます。このパラメーターの有効な入力値は、$true または $false です。既定値は $false です。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	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 2013, Exchange Server 2016, Exchange Server 2019

-DeferAttempts

DeferAttempts パラメーターで、マルウェアエージェントによってスキャンできないメッセージを保留する最大の回数を指定できます。このパラメーターの有効な入力値は、1 ～ 5 の整数です。既定値は 3 です。

遅延の最大数に達すると、マルウェアエージェントによって実行されるアクションはエラーによって異なります。スキャンタイムアウトとエンジンエラーの場合、アクションはメッセージを失敗させ、最後の延期試行の直後に配信不能レポート (NDR) を送信者に返します。その他のすべてのエラーの場合、メッセージは最大 48 時間再試行され、再試行のたびに最後の再試行よりも 1 時間長くなります。たとえば、前回の延期試行の後から、最初の再試行は 1 時間で行われ、次の再試行は 2 時間後に行われ、次の再試行は 2 回目の再試行の 3 時間後に行われ、最大 48 時間になります。 48 時間が経過すると、メッセージが失敗し、配信不能レポート (NDR) が送信者に返されます。

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

-DeferWaitTime

DeferWaitTime パラメーターは、サーバーのワークロードを軽減するために、メッセージをマルウェアフィルターに再送信する間隔を延長する時間を分単位で指定します。

たとえば、最初のスキャンがエラーになった後の最初の再試行は、DeferWaitTime パラメーターによって指定した間隔の後で実行されます。最初の再試行後の 2 回目の再試行は、DeferWaitTime パラメーターの値を 2 倍した間隔の後で実行されます。 2 回目の再試行後の 3 回目の再試行は、DeferWaitTime パラメーターの値の 3 倍後に行われます。 DeferAttempts パラメーターによって最大の再試行回数を制御できます。

このパラメーターの有効な入力値は 0 から 15 の整数です。既定値は 5 です。つまり、最初の再送信は元の失敗したスキャンの 5 分後に行われ、2 回目の再試行は最初の再試行の 10 分後に行われ、3 回目の再試行は 2 回目の再試行の 15 分後に行われます。値を 0 にすると、メッセージは、スキャンがエラーになった直後に遅延なくマルウェアフィルターに再送信されます。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	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 2013, Exchange Server 2016, Exchange Server 2019

-ForceRescan

ForceRescan パラメーターは、メッセージが既にExchange Online Protectionによってスキャンされている場合でも、マルウェアエージェントによってメッセージをスキャンすることを指定します。このパラメーターの有効な入力値は、$true または $false です。既定値は $false です。

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

-Identity

Identity パラメーターは、マルウェア対策設定を構成するサーバーを指定します。サーバーを一意に識別する任意の値を使用できます。次に例を示します。

名前
FQDN
識別名 (DN)
Exchange の従来の DN

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

-MinimumSuccessfulEngineScans

このパラメーターは、Microsoft の内部使用のために予約されています。

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

-PrimaryUpdatePath

PrimaryUpdatePath パラメーターで、マルウェアスキャンエンジンの更新をダウンロードする場所を指定できます。既定値は http://forefrontdl.microsoft.com/server/scanengineupdate です。 PrimaryUpdatePath パラメーターによって指定した場所が、必ず最初に試行されます。

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

-ScanErrorAction

ScanErrorAction パラメーターで、マルウェアフィルターによってメッセージをスキャンできない場合のアクションを指定できます。このパラメーターの有効な値は、Block または Allow です。既定値は Block です。

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

-ScanTimeout

ScanTimeout パラメーターで、マルウェアフィルターによってスキャンできないメッセージのタイムアウト間隔を秒単位で指定できます。このパラメーターの有効な入力値は、10 ～ 900 の整数です。既定値は 300 (5 分)です。

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

-SecondaryUpdatePath

SecondaryUpdatePath パラメーターで、マルウェアスキャンエンジンの更新をダウンロードする別の場所を指定できます。既定値は空白 ($null) です。別のダウンロード場所は指定されません。

UpdateTimeout パラメーターによって指定した期間中に PrimaryUpdatePath パラメーターによって指定した場所を使用できない場合、別のダウンロード場所が使用されます。次回のマルウェアスキャンエンジンの更新は、PrimaryUpdate パスパラメーターによって指定した場所が最初に試行されます。

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

-UpdateFrequency

UpdateFrequency パラメーターで、マルウェアスキャンエンジンの更新の有無を確認する間隔を分単位で指定できます。このパラメーターの有効な入力値は、1 ～ 38880 (27 日) の整数です。既定値は 60 (1 時間)です。更新の有無を確認する場所は、PrimaryUpdatePath および SecondaryUpdatePath パラメーターによって指定できます。

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

-UpdateTimeout

UpdateTimeout パラメーターで、マルウェアスキャンエンジンの更新の有無を確認する際のタイムアウト間隔を秒単位で指定できます。このパラメーターの有効な入力値は、60 ～ 300 の整数です。既定値は 150 秒 (2.5 分)です。

UpdateTimeout パラメーターによって指定した期間中に PrimaryUpdatePath パラメーターによって指定した場所を使用できない場合、SecondaryUpdatePath パラメーターによって指定した場所が使用されます。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	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 2013, Exchange Server 2016, Exchange Server 2019

入力

Input types

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

出力

Output types

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