Get-ExchangeServer
Applies to: Exchange Server 2007 SP1, Exchange Server 2007 SP2, Exchange Server 2007 SP3
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>]
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.
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. |
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