Set-MalwareFilteringServer

內部部署 Exchange 才有提供此 Cmdlet。

使用 Set-MalwareFilteringServer 指令程式可以設定信箱伺服器上傳輸服務中的惡意程式碼代理程式設定。

如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法

Syntax

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>]

Description

您必須已獲指派權限,才能執行此指令程式。 雖然本主題已列出這個指令程式的所有參數,不過,如果某些參數並未包含在指派給您的權限中,您可能就無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限,請參閱 Find the permissions required to run any Exchange cmdlet

範例

範例 1

Set-MalwareFilteringServer Mailbox01 -UpdateFrequency 120 -DeferWaitTime 10

此範例會設定名為 Mailbox01 的 Mailbox server 的下列惡意軟體代理程式設定。

  • 將更新頻率間隔設為 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 參數會指定要顯示或隱藏確認提示。 這個參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續作業。

  • 例如,具破壞性的 Cmdlet (例如 Remove-* Cmdlet) 內建暫停,可強制您在繼續之前確認命令。 對於這些 Cmdlet,您可以使用以下確切語法來略過確認提示:-Confirm:$false
  • 其他大部分的 Cmdlet (例如,New-* 和 Set-* Cmdlet) 沒有內建暫停。 在使用這些 Cmdlet 時,指定不含任何值的 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 小時後發生,下一次重試嘗試將於第一次重試嘗試後 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 參數會指定的間隔內發生。 第一次重試後的第二次重試在 DeferWaitTime 參數值後發生兩次。 第二次重試之後的第三次重試發生在 DeferWaitTime 參數值的三倍之後,依此類推。 重試的最大次數由 DeferAttempts 參數進行控制。

此參數的有效輸入為介於 0 與 15 間的整數。 預設值為 5。 這表示第一次重新提交發生在原始掃描失敗後的 5 分鐘,第二次重試會在第一次重試之後 10 分鐘發生,第三次重試會在第二次重試之後 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 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如,dc01.contoso.com。

Edge Transport Server 不支援 DomainController 參數。 Edge Transport Server 會使用 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 參數會指定要設定反惡意程式碼設定的伺服器位置。 您可以使用唯一識別伺服器的任何值。 例如:

  • Name
  • FQDN
  • 辨別名稱 (DN)
  • Exchange Legacy 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)。 這代表未指定備用下載位置。

當由 PrimaryUpdatePath 參數會指定的位置不可用於 UpdateTimeout 參數會指定的時間長度時,可使用備用下載位置。 在下一個惡意軟體掃描引擎更新中,由 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(一小時)。 檢查更新的位置由 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分鐘)。

若由 PrimaryUpdatePath 參數會指定的位置不可用於 UpdateTimeout 參數值指定的時間長度時,使用由 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

若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型),請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的,表示指令程式不會傳回資料。