Get-ClientAccessServer
Applies to: Exchange Server 2007 SP1, Exchange Server 2007 SP2, Exchange Server 2007 SP3
The Get-ClientAccessServer cmdlet returns information for the Client Access server.
Syntax
Get-ClientAccessServer [-Identity <ClientAccessServerIdParameter>] [-DomainController <Fqdn>]
Detailed Description
The Client Access server role is one of five server roles that can be installed on a computer that is running Microsoft Exchange Server 2007. The Get-ClientAccessServer cmdlet returns information about all Client Access servers.
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-ClientAccessServer cmdlet, the account you use must be delegated the 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 |
This parameter specifies the fully qualified domain name (FQDN) of the domain controller that writes configuration changes to the Active Directory directory service. |
Identity |
Optional |
Microsoft.Exchange.Configuration.Tasks.ClientAccessServerIdParameter |
This parameter specifies the name of the Exchange Server computer that has the Client Access server role installed. |
Input Types
Return Types
Errors
| Error | Description |
|---|---|
|
|
Exceptions
| Exceptions | Description |
|---|---|
|
|
Example
The following code example returns the names of all Exchange Server computers that have the Client Access Server role installed.
Get-ClientAccessServer