Set-MalwareFilteringServer
このコマンドレットは、オンプレミスの Exchange でのみ使用可能です。
メールボックス サーバーのトランスポート サービスのマルウェア エージェント設定を構成するには、Set-MalwareFilteringServer コマンドレットを使用します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Default (既定)
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
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
BypassFiltering パラメーターは、サーバーでマルウェア エージェントを無効にせずに、マルウェア フィルターを一時的にバイパスします。 マルウェア エージェントはアクティブなままで、すべてのメッセージ用に呼び出されますが、マルウェア フィルターは実際には実行されません。 これにより、Microsoft Exchange トランスポート サービスを再起動し、メール フローを中断することなく、サーバー上でマルウェア フィルターを一時的に無効にしてから有効にすることができます。 このパラメーターの有効な入力値は、$true または $false です。 既定値は $false です。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Confirm
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットに与える影響は、コマンドレットが続行する前に確認を必要とするかどうかによって異なります。
- データを破壊するコマンドレット (たとえば、Remove- コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文
-Confirm:$falseを使用して、確認プロンプトを省略できます。 - 他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットの場合、値を指定せずに Confirm スイッチを指定すると、一時停止が発生し、続行する前にコマンドの確認を強制されます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | Cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DeferAttempts
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
DeferAttempts パラメーターで、マルウェア エージェントによってスキャンできないメッセージを保留する最大の回数を指定できます。 このパラメーターの有効な入力値は、1 ～ 5 の整数です。 既定値は 3 です。
延期の最大数に達した後、マルウェア エージェントによって実行されるアクションはエラーによって異なります。 スキャン タイムアウトやエンジン エラーの場合、アクションはメッセージに失敗し、最後の延期試行の直後に配信不能レポート (NDR) を送信者に返すことです。 その他のすべてのエラーについては、メッセージは最大 48 時間再試行され、各再試行は前回の再試行よりも 1 時間長くなります。 たとえば、最後の延期試行から開始すると、最初の再試行は 1 時間後に発生し、次の再試行はその 2 時間後に発生し、次の再試行は 2 回目の再試行の 3 時間後に発生し、以下同様に最大 48 時間続きます。 48 時間が経過すると、アクションはメッセージに失敗し、配信不能レポート (NDR) を送信者に返します。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DeferWaitTime
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
DeferWaitTime パラメーターは、サーバーのワークロードを軽減するために、メッセージをマルウェア フィルターに再送信する間隔を延長する時間を分単位で指定します。
たとえば、最初のスキャンがエラーになった後の最初の再試行は、DeferWaitTime パラメーターによって指定した間隔の後で実行されます。 最初の再試行後の 2 回目の再試行は、DeferWaitTime パラメーターの値を 2 倍した間隔の後で実行されます。 2 回目の再試行後に 3 回目の再試行は、DeferWaitTime パラメーターの値の 3 倍の後に発生します(以下同様です)。 DeferAttempts パラメーターによって最大の再試行回数を制御できます。
このパラメーターの有効な入力値は 0 から 15 の整数です。 既定値は 5 です。 つまり、最初の再実行は最初に失敗したスキャンの 5 分後に発生し、2 回目の再試行は最初の再試行の 10 分後に発生し、3 回目の再試行は 2 回目の再試行の 15 分後に実行されます。 値を 0 にすると、メッセージは、スキャンがエラーになった直後に遅延なくマルウェア フィルターに再送信されます。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DomainController
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
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 |
-ForceRescan
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
ForceRescan パラメーターは、メッセージが既にクラウドベースの保護によってスキャンされている場合でも、マルウェア エージェントによってメッセージをスキャンするように指定します。 有効な値は次のとおりです。
- $true: クラウドベースの組織からのメッセージは、マルウェア エージェントによってスキャンされます。
- $false: クラウドベースの組織からのメッセージは、マルウェア エージェントによってスキャンされません。 この値が既定値です。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Identity
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Identity パラメーターは、マルウェア対策設定を構成するサーバーを指定します。 サーバーを一意に識別する任意の値を使用できます。 次に例を示します。
- 名前
- FQDN
- 識別名 (DN)
- Exchange の従来の DN
パラメーターのプロパティ
| 型: | MalwareFilteringServerIdParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-MinimumSuccessfulEngineScans
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
このパラメーターは、Microsoft の内部使用のために予約されています。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PrimaryUpdatePath
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
PrimaryUpdatePath パラメーターで、マルウェア スキャン エンジンの更新をダウンロードする場所を指定できます。 既定値は http://forefrontdl.microsoft.com/server/scanengineupdate です。 PrimaryUpdatePath パラメーターによって指定した場所が、必ず最初に試行されます。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ScanErrorAction
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
ScanErrorAction パラメーターで、マルウェア フィルターによってメッセージをスキャンできない場合のアクションを指定できます。 このパラメーターの有効な値は、Block または Allow です。 既定値は Block です。
パラメーターのプロパティ
| 型: | MalwareScanErrorAction |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ScanTimeout
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
ScanTimeout パラメーターで、マルウェア フィルターによってスキャンできないメッセージのタイムアウト間隔を秒単位で指定できます。 このパラメーターの有効な入力値は、10 ～ 900 の整数です。 既定値は 300 (5 分)です。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SecondaryUpdatePath
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
SecondaryUpdatePath パラメーターで、マルウェア スキャン エンジンの更新をダウンロードする別の場所を指定できます。 既定値は空白 ($null) です。 別のダウンロード場所は指定されません。
UpdateTimeout パラメーターによって指定した期間中に PrimaryUpdatePath パラメーターによって指定した場所を使用できない場合、別のダウンロード場所が使用されます。 次回のマルウェア スキャン エンジンの更新は、PrimaryUpdate パス パラメーターによって指定した場所が最初に試行されます。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-UpdateFrequency
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
UpdateFrequency パラメーターで、マルウェア スキャン エンジンの更新の有無を確認する間隔を分単位で指定できます。 このパラメーターの有効な入力値は、1 ～ 38880 (27 日) の整数です。 既定値は 60 (1 時間)です。 更新の有無を確認する場所は、PrimaryUpdatePath および SecondaryUpdatePath パラメーターによって指定できます。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-UpdateTimeout
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
UpdateTimeout パラメーターで、マルウェア スキャン エンジンの更新の有無を確認する際のタイムアウト間隔を秒単位で指定できます。 このパラメーターの有効な入力値は、60 ～ 300 の整数です。 既定値は 150 秒 (2.5 分)です。
UpdateTimeout パラメーターによって指定した期間中に PrimaryUpdatePath パラメーターによって指定した場所を使用できない場合、SecondaryUpdatePath パラメーターによって指定した場所が使用されます。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WhatIf
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
[WhatIf] スイッチは、何も変更を加えずにコマンドが実行する内容を表示します。 このスイッチで値を指定する必要はありません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | wi |
パラメーター セット
(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
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。