Set-IPBlockListProvider

  • 發行項

 

適用版本： Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

上次修改主題的時間： 2007-06-28

使用 Set-IPBlockListProvider 指令程式，可以修改已安裝 Edge Transport server role 或 Hub Transport server role 之電腦上的特定 IP 封鎖清單提供者組態的組態資訊。

語法

Set-IPBlockListProvider -Identity <IPBlockListProviderIdParameter> [-AnyMatch <$true | $false>] [-BitmaskMatch <IPAddress>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-IPAddressesMatch <MultiValuedProperty>] [-LookupDomain <SmtpDomain>] [-Name <String>] [-Priority <Int32>] [-RejectionResponse <AsciiString>] [-WhatIf [<SwitchParameter>]]

Set-IPBlockListProvider [-AnyMatch <$true | $false>] [-BitmaskMatch <IPAddress>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-Instance <IPBlockListProvider>] [-IPAddressesMatch <MultiValuedProperty>] [-LookupDomain <SmtpDomain>] [-Name <String>] [-Priority <Int32>] [-RejectionResponse <AsciiString>] [-WhatIf [<SwitchParameter>]]

詳細描述

使用 Set-IPBlockListProvider 指令程式，可以修改現有的 IP 封鎖清單提供者組態。此組態是由連線篩選器代理程式使用。必須有 Identity 參數。

若要執行 Set-IPBlockListProvider 指令程式，您使用的帳戶必須已委派下列資格：

  • Exchange Server 系統管理員角色和目標伺服器的本機 Administrators 群組

若要在已安裝 Edge Transport server role 的電腦上執行 Set-IPBlockListProvider 指令程式，則必須使用該電腦之本機 Administrators 群組成員的帳戶進行登入。

如需管理 Microsoft Exchange Server 2007 所需之權限、委派角色以及權利的相關資訊，請參閱權限考量。

參數

參數 必要 類型 描述

Identity

必要

Microsoft.Exchange.Configuration.Tasks.IPBlockListProviderIdParameter

Identity 參數可以是字串值，也就是 Name 值或 GUID。

AnyMatch

選用

System.Boolean

Enabled 參數的有效輸入是 $true 或 $false。預設值是 $false。當 AnyMatch 參數設定為 $true 時，連線篩選器代理程式就會將由 IP 封鎖清單提供者服務傳回的任何 IP 位址狀態碼視為相符。

BitmaskMatch

選用

System.Net.IPAddress

當您設定 BitmaskMatch 參數的 IP 位址時，連線篩選器代理程式作用的範圍，僅限於與 IP 封鎖清單提供者服務傳回之 IP 位址狀態碼相符的郵件。

Confirm

選用

System.Management.Automation.SwitchParameter

Confirm 參數會使得命令暫停處理，並要求確認命令將進行的動作之後才會繼續處理。您不需要為 Confirm 參數指定任何值。

DomainController

選用

Microsoft.Exchange.Data.Fqdn

若要指定將此組態變更寫入至 Active Directory 目錄服務之網域控制站的網域全名，請在命令中加入 DomainController 參數。執行 Edge Transport server role 的電腦不支援 DomainController 參數。Edge Transport server role 只會寫入至本機 ADAM 執行個體。

Enabled

選用

System.Boolean

Enabled 參數的有效輸入是 $true 或 $false。預設值是 $true。當 Enabled 參數設定為 $true 時，連線篩選器代理程式就會依據此 IP 封鎖清單提供者組態所設定的優先順序，查詢 IP 封鎖清單提供者服務。

Instance

選用

Microsoft.Exchange.Data.Directory.SystemConfiguration.IPBlockListProvider

Instance 參數可讓您將整個物件傳送至命令中，以進行處理。它主要是用於必須將整個物件傳遞至該命令的指令碼。

IPAddressesMatch

選用

Microsoft.Exchange.Data.MultiValuedProperty

當您設定 IPAddressesMatch 參數的 IP 位址時，連線篩選器代理程式只會作用於符合由 IP 封鎖清單提供者服務傳回之 IP 位址狀態碼的郵件上。

LookupDomain

選用

Microsoft.Exchange.Data.SmtpDomain

此參數指定連線篩選器代理程式查詢是否有已更新 IP 封鎖清單資料的網域名稱。

Name

選用

System.String

此參數指定 IP 封鎖清單提供者服務的名稱。如果您變更此值，Identity 參數的字串值仍然不會變。

Priority

選用

System.Int32

設定 Priority 參數，以設定連線篩選器代理程式查詢您已設定之 IP 封鎖清單提供者服務的順序。依預設，您每次新增新的 IP 封鎖清單提供者時，就會指定 N+1 的優先順序給該項目。N 即為您先前設定之 IP 封鎖清單提供者服務的數目。

如果您將 Priority 參數設定為與另一個 IP 封鎖清單提供者相同，該 IP 封鎖清單提供者的數值就會自動遞增 1。

RejectionResponse

選用

Microsoft.Exchange.Data.AsciiString

RejectionResponse 參數需要一個字串。輸入您想要在 SMTP 工作階段中傳遞給寄件者的郵件內文，在 IP 封鎖清單提供者服務發現相符的寄件者 IP 位址時，連線篩選器代理程式就會封鎖該寄件者的郵件並寄出這段文字。建議您指定回應中的 IP 封鎖清單提供者服務，讓合法寄件者可以連絡提供者服務。引數不可以超過 240 個字元。傳遞引數時，如果字詞如下所示含有空格，則必須用雙引號括住 RejectionResponse 參數，例如： "Originating IP addresses matched to Example.com's IP Block List Provider service".

WhatIf

選用

System.Management.Automation.SwitchParameter

WhatIf 參數指示命令模擬它將對物件採取的動作。使用 WhatIf 參數，則不需要套用任何變更，就能檢視變更。您不需要為 WhatIf 參數指定任何值。

輸入類型

傳回類型

錯誤

錯誤 描述

 

範例

下列程式碼範例顯示兩個 Set-IPBlockListProvider 命令。

第一個程式碼範例顯示 Set-IPBlockListProvider 命令，用來設定連線篩選器以將所有與 IP 封鎖清單提供者服務相符者視為可執行的事件。

第二個程式碼範例顯示 Set-IPBlockListProvider 命令，會將現有組態的優先順序設為 1。

Set-IPBlockListProvider -Identity Example.com -AnyMatch:$true 
Set-IPBlockListProvider -Identity Example.com -Priority 1

若要確保您目前閱讀的是最新資訊，並尋找其他的 Exchange Server 2007 說明文件，請造訪 Exchange Server 技術資源中心.