Get-ExchangeAdministrator
Applies to: Exchange Server 2007 SP1, Exchange Server 2007 SP2, Exchange Server 2007 SP3
Use the Get-ExchangeAdministrator cmdlet to retrieve information about the users or groups that have a particular Microsoft Exchange Server 2007 role.
Syntax
Get-ExchangeAdministrator [-Identity <SecurityPrincipalIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>]
Detailed Description
To run the Get-ExchangeAdministrator 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 |
|---|---|---|---|
Credential |
Optional |
System.Management.Automation.PSCredential |
The Credential parameter specifies the user name and password to use to retrieve the user or group role information. |
Identity |
Optional |
Microsoft.Exchange.Configuration.Tasks.SecurityPrincipalIdParameter |
The Identity parameter specifies the user or group about which you want to retrieve information. |
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. |
Input Types
Return Types
Errors
| Error | Description |
|---|---|
Exceptions
| Exceptions | Description |
|---|---|
Example
The following code is an example of the Get-ExchangeAdministrator command. This command retrieves the Exchange role information for user Ted Bremer.
Get-ExchangeAdministrator -Identity Contoso\TedBremer