Applies to: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Topic Last Modified: 2007-06-28

Use the Get-IPBlockListProvider cmdlet to view the configuration for a specific IP Block List provider on a computer that has the Hub Transport server role or Edge Transport server role installed.

Syntax

Get-IPBlockListProvider [-Identity <IPBlockListProviderIdParameter>] [-DomainController <Fqdn>]

Parameters

Parameter Required Type Description

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

To specify the fully qualified domain name (FQDN) of the domain controller that retrieves data from Active Directory directory service, include the DomainController parameter in the command. The DomainController parameter is not supported on computers that run the Edge Transport server role. The Edge Transport server role writes only to the local ADAM instance.

Identity

Optional

Microsoft.Exchange.Configuration.Tasks.IPBlockListProviderIdParameter

The Identity parameter can take either a string value, which is the ProviderName value, or the GUID.

Detailed Description

The IP Block List provider configuration is used by the Connection Filter agent. The Connection Filter agent relies on the IP address of the remote server that is trying to connect to determine what action, if any, to take on an incoming message. The remote IP address is available to the Connection Filter agent as a by-product of the underlying TCP/IP connection that is required for the SMTP session.

To run the Get-IPBlockListProvider cmdlet, the account you use must be delegated the following:

  • Exchange View-Only Administrators role

To run the Get-IPBlockListProvider 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.

Input Types

Return Types

Errors

Error Description

 

 

Example

The following code examples show two Get-IPBlockListProvider commands.

The first code example returns all IP Block List providers configured on the computer.

The second code example returns the configuration for a specific IP Block List provider, Example.com.

Copy Code
Get-IPBlockListProvider
Get-IPBlockListProvider -Identity Example.com