Applies to: Exchange Server 2007 SP3, Exchange Server
2007 SP2, Exchange Server 2007 SP1
Topic Last Modified: 2007-06-28
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>]
|
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. |
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.
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.
 Copy Code |
|
|---|---|
Get-EdgeSubscription -DomainController dc.domain.com -Identity EdgeServerName Get-EdgeSubscription | format-list |
|