Get-ExchangeServer

Get-ExchangeServer

Get-ExchangeServer

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

Use the Get-ExchangeServer cmdlet to obtain the attributes of a specified server. If a server is not specified, the cmdlet obtains the attributes of all of the servers in the Exchange organization.

Note:
When you run the Get-ExchangeServer cmdlet with no parameters, it will return the attributes of all of the servers in the Exchange organization. To return specific server properties (including domain controller information) where the Get-ExchangeServer cmdlet has to contact servers directly or perform a complex or slow calculation, make sure you use the –Status parameter.

Syntax


Get-ExchangeServer [-Identity <ServerIdParameter>] [-DomainController <Fqdn>] [-Status <SwitchParameter>]


Get-ExchangeServer -Domain <Fqdn> [-DomainController <Fqdn>] [-Status <SwitchParameter>]

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 in the command.
Identity	Optional	Microsoft.Exchange.Configuration.Tasks.ServerIdParameter	The Identity parameter specifies the identity of the server.
Status	Optional	System.Management.Automation.SwitchParameter	The Status parameter specifies the status of the server.
Domain	Required	Microsoft.Exchange.Data.Fqdn	The Domain parameter specifies the name of the domain.

Detailed Description

To view all the Exchange server attributes that this cmdlet returns, you must pipe the command to the Format-List cmdlet.

The ExchangeVersion attribute that is returned is the minimum version of Microsoft Exchange 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-ExchangeServer cmdlet, the account you use must be delegated the following:

Exchange View-Only 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

In this example, the Get-ExchangeServer cmdlet is used without parameters to obtain the attributes of all of the servers in the Exchange organization.

Get-ExchangeServer | Format-List