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