Get-EdgeSubscription

 

Applies to: Exchange Server 2007 SP1, Exchange Server 2007 SP2, Exchange Server 2007 SP3

Use the Get-EdgeSubscription cmdlet to retrieve information about Edge Subscriptions in a Microsoft Exchange Server 2007 organization.

Syntax

Get-EdgeSubscription [-Identity <TransportServerIdParameter>] [-DomainController <Fqdn>]

Detailed Description

Run the Get-EdgeSubscription cmdlet on an Exchange 2007 server in the organization. This cmdlet retrieves the list of Edge Subscriptions. Each computer that has the Edge Transport server role installed and that is subscribed to the Exchange organization has a separate Edge Subscription. You can use this cmdlet to view the Edge Subscription information for a specific Edge Transport server. You can also use this cmdlet to view the Edge Subscription information for all Edge Transport servers that are subscribed to Active Directory sites.

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

  • Exchange Organization Administrator role

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

Parameters

Parameter Required Type Description

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

Use the DomainController parameter to specify the host name or fully qualified domain name (FQDN) of the domain controller that processes this query.

Identity

Optional

Microsoft.Exchange.Configuration.Tasks.TransportServerIdParameter

Use the Identity parameter to specify the name of the Edge Transport server for which you want to retrieve Edge Subscription information. The identity is expressed as the host name of the Edge Transport server. If no identity is specified, all Edge Subscriptions are returned.

Input Types

Return Types

Errors

Error Description

 

 

Exceptions

Exceptions Description

 

 

Example

The following code examples show how to use the Get-EdgeSubscription cmdlet to retrieve Edge Subscription information. The first example binds to the specified domain controller and retrieves the Edge Subscription information for the specified Edge Transport server. The second example retrieves Edge Subscription information for all Edge Transport servers that are subscribed to the Exchange organization. The command is piped to the Format-List command to format the results as a detailed list.

Get-EdgeSubscription -DomainController dc.domain.com -Identity EdgeServerName
Get-EdgeSubscription | format-list