Set-MalwareFilteringServer
內部部署 Exchange 才有提供此 Cmdlet。
使用 Set-MalwareFilteringServer 指令程式可以設定信箱伺服器上傳輸服務中的惡意程式碼代理程式設定。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
語法
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>]
Description
您必須已獲指派權限，才能執行此指令程式。 雖然本文列出 Cmdlet 的所有參數，但如果某些參數未包含在指派給您的許可權中，您可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。
範例
範例 1
Set-MalwareFilteringServer Mailbox01 -UpdateFrequency 120 -DeferWaitTime 10
此範例會設定名為 Mailbox01 的 Mailbox server 的下列惡意軟體代理程式設定。
- 將更新頻率間隔設為 2 小時
- 將在重新提交嘗試間的時間設為 10 分鐘
參數
-BypassFiltering
適用：Exchange Server 2013 Exchange Server 2016 Exchange Server 2019
BypassFiltering 參數暫時略過惡意軟體篩選，而不在伺服器上停用惡意軟體代理程式。 惡意軟體代理程式仍在使用中，且代理程式仍被每個郵件呼叫，但是沒有實際執行的惡意軟體篩選。 重新啟動 Microsoft Exchange 傳輸服務可讓您暫時停用，之後再啟用伺服器上的惡意軟體篩選，而不中斷信件往來。 這個參數的有效輸入是 $true 或 $false。 預設值為 $false。
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Confirm
適用：Exchange Server 2013 Exchange Server 2016 Exchange Server 2019
Confirm 參數會指定要顯示或隱藏確認提示。 這個參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續作業。
- 破壞性的 Cmdlet (如 Remove-* cmdlets) 有內建暫停，它會先強迫您確認命令才會繼續作業。 對於這些 Cmdlet，您可以使用以下確切語法來略過確認提示：
-Confirm:$false。 - 其他大部分的 Cmdlet (如 New-* 和 Set-* cmdlets) 則沒有內建暫停。 在使用這些 Cmdlet 時，指定不含任何值的 Confirm 參數會引入強迫您認可命令後才繼續作業的暫停。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | cf |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DeferAttempts
適用：Exchange Server 2013 Exchange Server 2016 Exchange Server 2019
DeferAttempts 參數會指定時間的最高數量，以順延無法以惡意軟體代理程式掃描的訊息。 此參數的有效輸出為介於 1 和 5 之間的整數。 預設值為 3。
在達到順延上限後，惡意程式碼代理程式採取的動作取決於錯誤。 對於掃描逾時和引擎錯誤，其採取的動作是在最後一次順延嘗試後立即拒絕郵件並將未傳遞回報 (NDR) 回傳給寄件者。 對於其他所有錯誤，系統會重試郵件達 48 小時，且每次重試嘗試的間隔都比上一次多一小時。 例如，從上一次延遲嘗試開始，第一次重試嘗試會在 1 小時內發生，下一次重試嘗試會在 2 小時後發生，下一次重試嘗試會在第二次重試嘗試之後 3 小時發生，依此類推，最多 48 小時。 在經過 48 小時後，其採取的動作是拒絕郵件並將未傳遞回報 (NDR) 回傳給寄件者。
參數屬性
| 類型: | Int32 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DeferWaitTime
適用：Exchange Server 2013 Exchange Server 2016 Exchange Server 2019
DeferWaitTime 參數會指定數分鐘內的時間，以增加重新對惡意軟體篩選提交的郵件，已降低伺服器上的工作量。
例如，在第一次失敗的掃描後的第一次重試在由 DeferWaitTime 參數會指定的間隔內發生。 第一次重試後的第二次重試在 DeferWaitTime 參數值後發生兩次。 第二次重試之後的第三次重試發生在DeferWaitTime參數值的三倍之後，依此類推。 重試的最大次數由 DeferAttempts 參數進行控制。
此參數的有效輸入為介於 0 與 15 間的整數。 預設值為 5。 這表示第一次重新提交發生在原始掃描失敗后的 5 分鐘，第二次重試會在第一次重試之後 10 分鐘發生，第三次重試會在第二次重試之後 15 分鐘發生，依此類推。 值 0 代表在任何失敗掃描嘗試後沒有任何延遲即重新提交給惡意軟體的郵件。
參數屬性
| 類型: | Int32 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DomainController
適用：Exchange Server 2013 Exchange Server 2016 Exchange Server 2019
DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如，dc01.contoso.com。
Edge Transport Server 不支援 DomainController 參數。 Edge Transport Server 會使用 Active Directory 輕量型目錄服務 (AD LDS) 的本機執行個體來讀寫資料。
參數屬性
| 類型: | Fqdn |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ForceRescan
適用：Exchange Server 2013 Exchange Server 2016 Exchange Server 2019
ForceRescan 參數會指定惡意代碼代理程式應該掃描訊息，即使訊息已由雲端式保護掃描也一般。 有效值為：
- $true：惡意代碼代理程序會掃描來自雲端式組織的訊息。
- $false：惡意代碼代理程式不會掃描來自雲端式組織的訊息。 此值為預設值。
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Identity
適用：Exchange Server 2013 Exchange Server 2016 Exchange Server 2019
Identity 參數會指定要設定反惡意程式碼設定的伺服器位置。 您可以使用唯一識別伺服器的任何值。 例如：
- Name
- FQDN
- 辨別名稱 (DN)
- Exchange Legacy DN
參數屬性
| 類型: | MalwareFilteringServerIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-MinimumSuccessfulEngineScans
適用：Exchange Server 2013 Exchange Server 2016 Exchange Server 2019
將保留此參數供 Microsoft 內部使用。
參數屬性
| 類型: | Int32 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-PrimaryUpdatePath
適用：Exchange Server 2013 Exchange Server 2016 Exchange Server 2019
PrimaryUpdatePath參數將指定在何處下載惡意軟體掃描引擎更新。 預設值為 http://forefrontdl.microsoft.com/server/scanengineupdate。 由指定的位置PrimaryUpdatePath參數始終為優先嘗試。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ScanErrorAction
適用：Exchange Server 2013 Exchange Server 2016 Exchange Server 2019
ScanErrorAction 參數會指定當郵件無法由惡意軟體篩選器掃描時採取的動作。 這個參數的有效值是 Block 或 Allow。 預設值為 Block。
參數屬性
| 類型: | MalwareScanErrorAction |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ScanTimeout
適用：Exchange Server 2013 Exchange Server 2016 Exchange Server 2019
ScanTimeout 參數會指定當郵件無法由惡意軟體篩選器掃描時的逾時間隔秒數。 此參數的有效輸入是 10 和 900 之間的一個整數。 預設值為 300 （5 分鐘）。
參數屬性
| 類型: | Int32 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SecondaryUpdatePath
適用：Exchange Server 2013 Exchange Server 2016 Exchange Server 2019
SecondaryUpdatePath參數將指定惡意軟體掃描引擎更新的備用下載位置。 預設值為空白 ($null)。 這代表未指定備用下載位置。
當由 PrimaryUpdatePath 參數會指定的位置不可用於 UpdateTimeout 參數會指定的時間長度時，可使用備用下載位置。 在下一個惡意軟體掃描引擎更新中，由 PrimaryUpdate 路徑參數會指定的位置優先嘗試。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-UpdateFrequency
適用：Exchange Server 2013 Exchange Server 2016 Exchange Server 2019
UpdateFrequency 參數會指定頻率間隔分鐘以檢查惡意軟體掃描引擎更新。 此參數的有效輸入為介於 1 與 38880（27 天）的整數。 預設值為 60（一小時）。 檢查更新的位置由 PrimaryUpdatePath 與 SecondaryUpdatePath 參數會指定。
參數屬性
| 類型: | Int32 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-UpdateTimeout
適用：Exchange Server 2013 Exchange Server 2016 Exchange Server 2019
UpdateTimeout 參數會指定檢查惡意軟體掃描引擎更新十的逾時間隔秒數。 此參數的有效輸入是 60 和 300 之間的一個整數。 預設值為 150 秒（2.5分鐘）。
若由 PrimaryUpdatePath 參數會指定的位置不可用於 UpdateTimeout 參數值指定的時間長度時，使用由 SecondaryUpdatePath 參數會指定的位置。
參數屬性
| 類型: | Int32 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WhatIf
適用：Exchange Server 2013 年 Exchange Server 2016 Exchange Server 2019 年
WhatIf 參數會模擬命令的動作。 使用此參數時，您不需要實際套用變更即可檢視可能會發生的變更。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 無線 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。
輸入
Input types
若要查看此指令程式可接受的輸入類型，請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的，表示指令程式不接受輸入資料。
輸出
Output types
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。