Get-TransportServer
Applies to: Exchange Server 2007 SP1, Exchange Server 2007 SP2, Exchange Server 2007 SP3
Use the Get-TransportServer cmdlet to view the transport configuration information for computers that have the Hub Transport server role or the Edge Transport server role installed.
Syntax
Get-TransportServer [-Identity <TransportServerIdParameter>] [-DomainController <Fqdn>]
Detailed Description
Use the Get-TransportServer cmdlet to display configuration information for all transport-related parameters on a Hub Transport server or an Edge Transport server.
When you run this cmdlet on a Hub Transport server, you can specify the server from which you want to retrieve transport configuration information by specifying the name of the server in the Identity parameter. If you do not specify the Identity parameter when you run this cmdlet on a Hub Transport server, the configuration information for all Hub Transport servers is returned.
When you run the Get-TransportServer cmdlet on an Edge Transport server, you cannot specify the Identity parameter. This cmdlet returns only the configuration information for the Edge Transport server on which this cmdlet runs.
The ExchangeVersion attribute that is returned is the minimum version of Microsoft Exchange Server 2007 that you can use to manage the returned object. This attribute is not the same as the version of Microsoft Exchange that is displayed in the Exchange Management Console when you select Server Configuration.
To run the Get-TransportServer cmdlet, the account you use must be delegated the following:
- Exchange View-Only Administrators role
To run the Get-TransportServer 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 Exchange 2007, see Permission Considerations.
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 the Active Directory directory service, include the DomainController parameter on the command. The DomainController parameter is not supported on computers that have the Edge Transport server role installed. The Edge Transport server role writes and reads only to the local Active Directory Application Mode (ADAM) instance. |
Identity |
Optional |
Microsoft.Exchange.Configuration.Tasks.TransportServerIdParameter |
When you use this parameter on a Hub Transport server, the parameter returns the transport configuration of the specified server. You cannot use this parameter when you run the command on an Edge Transport server. You can omit the Identity parameter label. |
Errors
| Error | Description |
|---|---|
|
|
Exceptions
| Exceptions | Description |
|---|---|
|
|
Example
The following code examples shows two commands that use the Get-TransportServer cmdlet.
The first example shows how to retrieve a list that contains a transport configuration summary for all Hub Transport servers in the organization or, if the command runs on an Edge Transport server, the transport configuration summary for the local server.
The second example shows how to retrieve the detailed transport configuration information from a specific Hub Transport server by piping the output of the Get-TransportServer cmdlet to the Format-List cmdlet.
For more information about pipelining, see Pipelining.
For more information about how to work with the output of a command, see Working with Command Output.
Get-TransportServer
Get-TransportServer Hub1 | Format-List