通过

Add-IPBlockListEntry

  • 项目

 

适用于： Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

上一次修改主题： 2007-07-06

使用 Add-IPBlockListEntry cmdlet 可以在运行该命令的计算机上为连接筛选器配置的 IP 阻止列表配置信息添加 IP 地址或 IP 地址范围。必须在安装了集线器传输服务器角色或边缘传输服务器角色的计算机上拥有管理员权限。

语法

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

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

详细说明

如果在运行 Add-IPBlockListEntry cmdlet 时没有指定 IPAddress 参数，则 Exchange 命令行管理程序会提示您指定该参数。必须指定 IPAddress 参数或 IPRange 参数。

note注意：
如果在运行 Windows Server 2008 的计算机上部署 Microsoft Exchange Server 2007 Service Pack 1 (SP1)，可以以 Internet 协议版本 4 (IPv4) 格式、Internet 协议版本 6 (IPv6) 格式或两种格式输入 IP 地址和 IP 地址范围。Windows Server 2008 的默认安装支持 IPv4 和 IPv6。有关 Exchange 2007 SP1 对 IPv6 地址支持的详细信息，请参阅 Exchange 2007 SP1 和 SP2 中的 IPv6 支持。

若要运行 Add-IPBlockListEntry cmdlet，必须为您使用的帐户委派以下角色：

  • Exchange Server 管理员角色和目标服务器的本地 Administrators 组

若要在安装了边缘传输服务器角色的计算机上运行 Add-IPBlockListEntry cmdlet，必须使用作为该计算机上的本地 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 参数的值加上双引号，例如："this is an admin note"。

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-IPBlockListEntry cmdlet，请在命令中包含 Server 参数。如果不使用 Server 参数，该命令将在运行命令的本地服务器上运行。

不能使用此 cmdlet 远程配置其他边缘传输服务器。

WhatIf

可选

System.Management.Automation.SwitchParameter

WhatIf 参数指示命令模拟对对象执行的操作。通过使用 WhatIf 参数，您可以查看要发生的更改，而不必应用任何这些更改。不必为 WhatIf 参数指定值。

输入类型

返回类型

错误

错误 说明

 

示例

以下代码示例显示如何使用 Add-IPBlockListEntry cmdlet 为运行该命令的计算机上的 IP 阻止列表添加 IP 地址范围。第二个示例将这个 IP 阻止列表条目设置为在 2007 年 1 月 3 日晚上 11:59 过期。

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