Add-IPAllowListEntry

  • 發行項

 

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

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

使用 Add-IPAllowListEntry 指令程式可以在已安裝 Hub Transport server role 或 Edge Transport server role 的電腦上，將 IP 位址或 IP 位址範圍新增至連線篩選器代理程式的 IP 允許清單組態資訊。

語法

Add-IPAllowListEntry -IPRange <IPRange> [-Comment <String>] [-Confirm [<SwitchParameter>]] [-ExpirationTime <DateTime>] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]

Add-IPAllowListEntry -IPAddress <IPAddress> [-Comment <String>] [-Confirm [<SwitchParameter>]] [-ExpirationTime <DateTime>] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]

詳細描述

如果執行 Add-IPAllowListEntry 指令程式時未指定 IPAddress 參數，則 Exchange 管理命令介面會提示您進行指定。IPAddress 或 IPRange 是必要參數。

note附註：
如果 Microsoft Exchange Server 2007 Service Pack 1 (SP1) 是部署在執行 Windows Server 2008 的電腦上，則可以使用網際網路通訊協定第 4 版 (IPv4) 格式及 (或) 網際網路通訊協定第 6 版 (IPv6) 格式，來輸入 IP 位址及 IP 位址範圍。Windows Server 2008 的預設安裝會支援 IPv4 及 IPv6。如需針對 IPv6 位址之 Exchange 2007 SP1 支援的相關資訊，請參閱 Exchange 2007 SP1 和 SP2 中的 IPv6 支援。

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

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

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

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

參數

參數 必要 類型 描述

IPAddress

必要

System.Net.IPAddress

您可以指定要新增至 IP 允許清單的單一 IP 位址，如下所示： 192.168.0.1.

IPRange

必要

Microsoft.Exchange.Data.IPRange

您可以用下列格式將 IP 位址範圍新增至 IP 允許清單中：

  • CIDR IP    無類別網域間路由傳送。例如，192.168.0.1/24

  • IP 範圍   例如，192.168.0.1-192.168.0.254

Comment

選用

System.String

使用此參數，可以加上此特定項目的管理備註事項或提醒。您必須用雙引號括住 Comment 參數，如下所示："這是管理的備註事項"。

Confirm

選用

System.Management.Automation.SwitchParameter

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

ExpirationTime

選用

System.DateTime

您可以指定要建立之 IP 允許清單項目的到期日期及時間。如果只指定時間，而未指定日期，則會假設是當天。輸入特定日期時，請使用本機電腦上設定之 [地區選項] 設定中所定義的簡短日期格式。例如，如果電腦是設定成使用簡短日期格式 mm/dd/yyyy hh:mm:ss，則若要將到期時間設在 2007 年 1 月 3 日早上 11:00，請輸入下列資訊，並用雙引號括住： "1/3/2007 11:00".

Server

選用

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

若要指定要執行 Add-IPAllowListEntry 指令程式的不同伺服器，請在命令中加入 Server 參數。如果未使用 Server 參數，則會在執行命令的本機伺服器上執行命令。

您不能使用此指令程式自遠端設定其他 Edge Transport Server。

WhatIf

選用

System.Management.Automation.SwitchParameter

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

輸入類型

傳回類型

錯誤

錯誤 描述

 

範例

第一個程式碼範例會顯示 Add-IPAllowListEntry 命令，此命令會在執行此命令之電腦的 IP 允許清單上新增 IP 位址範圍。第二個程式碼範例會將相同 IP 允許清單項目設為在 2007 年 1 月 3 日晚上 11:59 到期。

Add-IPAllowListEntry -IPRange:192.168.0.1/24 
Add-IPAllowListEntry -IPRange:192.168.0.1/24 -ExpirationTime "1/3/2007 23:59"