Add-IPAllowListProvider
適用版本: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
上次修改主題的時間: 2007-06-22
使用 Add-IPAllowListProvider 指令程式,在已安裝 Edge Transport server role 或 Hub Transport server role 的電腦上,建立新的 IP 允許清單提供者組態。
語法
Add-IPAllowListProvider -Name <String> -LookupDomain <SmtpDomain> [-AnyMatch <$true | $false>] [-BitmaskMatch <IPAddress>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-IPAddressesMatch <MultiValuedProperty>] [-Priority <Int32>] [-TemplateInstance <PSObject>] [-WhatIf [<SwitchParameter>]]
詳細描述
IP 允許清單提供者組態是由連線篩選器代理程式使用。
必須有 Name 參數及 LookupDomain 參數。如果您沒有傳遞必要的參數,Exchange 管理命令介面就會提示您提供。
若要執行 Add-IPAllowListProvider 指令程式,您使用的帳戶必須已委派下列資格:
- Exchange Server 系統管理員角色和目標伺服器的本機 Administrators 群組
若要在已安裝 Edge Transport server role 的電腦上執行 Add-IPAllowListProvider 指令程式,則必須使用該電腦之本機 Administrators 群組成員的帳戶進行登入。
如需管理 Microsoft Exchange Server 2007 所需之權限、委派角色以及權利的相關資訊,請參閱權限考量。
參數
參數 | 必要 | 類型 | 描述 |
---|---|---|---|
LookupDomain |
必要 |
Microsoft.Exchange.Data.SmtpDomain |
連線篩選器代理程式所查詢之更新 IP 允許清單資訊的網域名稱 |
Name |
必要 |
System.String |
IP 允許清單提供者服務的名稱 |
AnyMatch |
選用 |
System.Boolean |
AnyMatch 參數的有效輸入是 |
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 只會寫入至本機 ADAM 執行個體。 |
Enabled |
選用 |
System.Boolean |
Enabled 參數的有效輸入是 |
IPAddressesMatch |
選用 |
Microsoft.Exchange.Data.MultiValuedProperty |
當您設定 IPAddressMatch 參數的 IP 位址時,連線篩選器代理程式只會作用於符合由 IP 允許清單提供者服務傳回之 IP 位址狀態碼的郵件上。 |
Priority |
選用 |
System.Int32 |
設定 Priority 參數,以設定連線篩選器代理程式查詢您已設定之 IP 允許清單提供者服務的順序。根據預設,您每次新增新的 IP 允許清單提供者服務時,就會指定 N+1 的優先順序給該項目,N 即為您先前設定之 IP 允許清單提供者服務的編號。 如果您將 Priority 參數設定為與另一個 IP 允許清單提供者服務相同的值,則您第一個新增之 IP 允許清單提供者服務的優先順序會以 1 遞增。 |
TemplateInstance |
選用 |
System.Management.Automation.PSObject |
將現有的物件提供給此參數時,命令會使用該物件的組態在本機或目標伺服器上建立該物件的相同複本。 |
WhatIf |
選用 |
System.Management.Automation.SwitchParameter |
WhatIf 參數指示命令模擬它將對物件採取的動作。使用 WhatIf 參數,則不需要套用任何變更,就能檢視變更。您不需要為 WhatIf 參數指定任何值。 |
輸入類型
傳回類型
錯誤
錯誤 | 描述 |
---|---|
|
|
範例
下列程式碼範例會顯示含有必要參數的 Add-IPAllowListProvider 命令:LookupDomain 及 Name。
Add-IPAllowListProvider -Name:Example -LookupDomain:Example.com
若要確保您目前閱讀的是最新資訊,並尋找其他的 Exchange Server 2007 說明文件,請造訪 Exchange Server 技術資源中心.