Get-ExchangeAdministrator
[This is pre-release documentation and subject to change in future releases. This topic's current status is: Writing.]
Applies to: Exchange Server 2010 Beta* *Topic Last Modified: 2008-12-11
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>]
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. |
Detailed Description
The Get-ExchangeAdministrator cmdlet cannot be used to manage Microsoft Exchange Server 2010 permissions. Use the ManagementRole, ManagementRoleAssignment, ManagementRoleEntry and ManagementScope cmdlets to modify Exchange 2010 permissions. While the Get-ExchangeAdministrator cmdlet can currently be used to manage Exchange Server 2007 server permissions, it will be removed from Exchange 2010 in future builds. At that time you will need to install the Exchange Server 2007 administration tools to administer computers that have Exchange Server 2007 installed.
Also, while the Exchange Management Control administrator role wizard remains available, you cannot use it to manage Exchange 2010 management roles. To administer Exchange 2010 management roles, you must use the management role cmdlets specified above. The Exchange Management Console administrator roles wizard will be updated to enable management of management roles in a later milestone.
To run this cmdlet, you must be assigned, either directly or using a universal security group, one of the following management roles:
- Organization Management
- View Only Organization Management
While all parameters for this cmdlet are listed in this topic, you may not have access to some parameters if they are not included in the management roles assigned to you.
To run this cmdlet on the Edge Transport server role, you must log on by using an account that is a member of the local Administrators group on that computer. For more information, see Permissions Information for Cmdlet Help and Procedural Topics.
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