Applies to: Exchange Server 2007
Topic Last Modified: 2007-06-11

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 <String> [-DomainController <Fqdn>] [-Status <SwitchParameter>]

Parameters

Parameter Required Type Description

Domain

Required

System.String

The Domain parameter specifies the name of the domain.

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.

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.

Copy Code
Get-ExchangeServer | Format-List