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 |
|