Add-IPBlockListEntry (RTM)

Microsoft Exchange Server 2007 will reach end of support on April 11, 2017. To stay supported, you will need to upgrade. For more information, see Resources to help you upgrade your Office 2007 servers and clients.

 

Applies to: Exchange Server 2007

Use the Add-IPBlockListEntry cmdlet to add an IP address or IP address range to the IP Block list configuration information for the Connection Filter configuration for the computer on which the command is run. You must have Administrator rights on the computer that has the Hub Transport server role or Edge Transport server role installed.

Syntax

Add-IPBlockListEntry -IPRange <IPRange> [-ExpirationTime <DateTime>]

Add-IPBlockListEntry -IPAddress <IPAddress> [-ExpirationTime <DateTime>]

Detailed Description

If you do not specify the IPAddress parameter when you run the Add-IPBlockListEntry cmdlet, the Exchange Management Shell prompts you for it. Either the IPAddress parameter or the IPRange parameter is required.

To run the Add-IPBlockListEntry cmdlet, the account you use must be delegated the following:

  • Exchange Server Administrator role and local Administrators group for the target server

To run the Add-IPBlockListEntry cmdlet on a computer that has the Edge Transport server role installed, you must log on by using an account that is a member of the local Administrators group on that computer.

For more information about permissions, delegating roles, and the rights that are required to administer Microsoft Exchange Server 2007, see Permission Considerations.

Parameters

Parameter Required Type Description

IPAddress

Required

System.Net.IPAddress

You can specify a single IP address to add to the IP Block list. For example, 192.168.0.1.

IPRange

Required

Microsoft.Exchange.Data.IPRange

You can add IP addresses to the IP Block list in the following formats:

  • CIDR IP    Classless InterDomain Routing. For example, 192.168.0.1/24

  • IP Range   For example, 192.168.0.1-192.168.0.254

ExpirationTime

Optional

System.DateTime

You can specify a day and time when the IP Block list entry that you are creating will expire. If you specify a time only, and you do not specify a date, the current day is assumed. When you enter a specific date, use the short date format that is defined in the Regional Options settings that are configured on the local computer. For example, if your computer is configured to use the short date format mm/dd/yyyy hh:mm:ss, to set the expiration time at 11:00 A.M. January 3, 2007, enter the following information, enclosed in double quotation marks: "1/3/2007 11:00".

Input Types

Return Types

Errors

Error Description

 

Example

The following code example shows how to use the Add-IPBlockListEntry cmdlet to add an IP address range on the IP Block list for the computer on which the command is run. The second example sets the same IP Block list entry to expire at 11:59 P.M. on 1/3/2007.

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