Set-IPBlockListProvider

參考

模組:: ExchangePowerShell

適用於:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

此 Cmdlet 只能在內部部署 Exchange 的 Edge Transport Server 上使用或生效。

使用 Set-IPBlockListProvider Cmdlet 來修改 Edge Transport Server 上的連線篩選代理程式所使用的 IP 封鎖清單提供者。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

Syntax

Set-IPBlockListProvider
   [-Identity] <IPBlockListProviderIdParameter>
   [-AnyMatch <Boolean>]
   [-BitmaskMatch <IPAddress>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Enabled <Boolean>]
   [-IPAddressesMatch <MultiValuedProperty>]
   [-LookupDomain <SmtpDomain>]
   [-Name <String>]
   [-Priority <Int32>]
   [-RejectionResponse <AsciiString>]
   [-WhatIf]
   [<CommonParameters>]

Description

在 Edge Transport Server 上，您必須是本機系統管理員群組的成員才能執行此 Cmdlet。

範例

範例 1

Set-IPBlockListProvider Contoso.com -AnyMatch $true

此範例會設定連線篩選，以在名為 Contoso.com 的 IP 封鎖清單提供者傳回任何 IP 位址狀態碼時封鎖 IP 位址。

範例 2

Set-IPBlockListProvider Contoso.com -Priority 1

本範例會將名為 Contoso.com 之 IP 封鎖清單提供者的優先順序值設定為 1。

參數

-AnyMatch

AnyMatch 參數會指定區塊清單提供者是否將任何回應視為相符專案。這個參數的有效輸入是 $true 或 $false。預設值為 $false。當此參數設定為 $true且連線篩選會將連線 SMTP 伺服器的 IP 位址傳送至封鎖清單提供者時，封鎖清單提供者傳回的任何回應碼都會造成連線篩選封鎖來自該來源的訊息。

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

-BitmaskMatch

BitmaskMatch 參數會指定區塊清單提供者所傳回的位元遮罩狀態碼。如果區塊清單提供者傳回位元遮罩回應，請使用此參數。此參數的有效輸入是格式為 127.0.0.1 的單一 IP 位址。

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

-Enabled

Enabled 參數會指定連線篩選是否使用此 IP 封鎖清單提供者。這個參數的有效輸入是 $true 或 $false。預設值為 $true。根據預設，連線篩選會使用您建立的新 IP 封鎖清單提供者。

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

-Identity

Identity 參數會指定您要修改的 IP 封鎖清單提供者。您可以使用唯一識別 IP 封鎖清單提供者的任何值。例如：

名稱
辨別名稱 (DN)
GUID

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

-IPAddressesMatch

IPAddressesMatch 參數會指定封鎖清單提供者所傳回的 IP 位址狀態碼。如果封鎖清單提供者傳回 IP 位址或 A 記錄回應，請使用此參數。此參數的有效輸入格式為 127.0.0.1 的一或多個 IP 位址。

若要輸入多個值並覆寫任何現有的專案，請使用下列語法： Value1,Value2,...ValueN 。如果值包含空格或需要引號，請使用下列語法： "Value1","Value2",..."ValueN" 。

若要新增或移除一或多個值而不影響任何現有的專案，請使用下列語法： @{Add="Value1","Value2"...; Remove="Value3","Value4"...} 。

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

-LookupDomain

LookupDomain 參數會指定使用封鎖清單提供者所需的主機名稱。連線篩選會將連線 SMTP 伺服器的 IP 位址傳送至您指定的主機名稱值。範例值為 blocklist.spamservice.com。您需要使用的實際值是由封鎖清單提供者提供。

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

-Name

Name 參數會指定 IP 封鎖清單提供者的描述性名稱。

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

-Priority

Priority 參數會指定連線篩選代理程式查詢 IP 封鎖清單提供者的順序。較低優先順序的整數值表示較高的優先順序。根據預設，每次您新增 IP 封鎖清單提供者時，都會將專案指派為 N+1 的優先順序，其中 N 是您已設定的 IP 封鎖清單提供者服務數目。

如果您將 Priority 參數設定為與另一個 IP 封鎖清單提供者服務相同的值，則您先新增的 IP 封鎖清單提供者的優先順序會遞增 1。

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

-RejectionResponse

當連線篩選封鎖訊息時，RejectionResponse 參數會指定您想要包含在 SMTP 拒絕回應中的文字。引數不能超過 240 個字元。如果值包含空格，請使用引號 (") 括住值。

您應該一律在回應中指定封鎖清單提供者，讓合法的寄件者可以連絡封鎖清單提供者以取得移除指示。例如，「來源 IP 位址列在 Contoso.com 區塊清單提供者」。

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

輸入

Input types

若要查看此指令程式可接受的輸入類型，請參閱指令程式輸入和輸出類型。如果指令程式的 [輸入類型] 欄位是空的，表示指令程式不接受輸入資料。

輸出

Output types

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