Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

Get-ADPermission

 

Applies to: Exchange Server 2013

Topic Last Modified: 2012-06-25

Use the Get-ADPermission cmdlet to get permissions on an Active Directory object.

For information about the parameter sets in the Syntax section below, see Syntax.

Get-ADPermission [-User <SecurityPrincipalIdParameter>] <COMMON PARAMETERS>
Get-ADPermission [-Owner <SwitchParameter>] <COMMON PARAMETERS>
COMMON PARAMETERS: -Identity <ADRawEntryIdParameter> [-DomainController <Fqdn>]

This example returns the permissions that have been applied to the user Ed.

Get-ADPermission -Identity Ed

This example returns the permissions that have been granted to the user Chris on the Contoso.com Receive connector.

Get-ADPermission "Contoso.com" -User Chris

The ADPermission cmdlets can be used to directly modify Active Directory access control lists (ACLs). Although some Microsoft Exchange Server 2013 features may continue to use the ADPermission cmdlets to manage permissions, for example transport Send and Receive connectors, Exchange 2013 no longer uses customized ACLs to manage administrative permissions. If you want to grant or deny administrative permissions in Exchange 2013, you must use Role Based Access Control (RBAC). For more information about RBAC, see Permissions.

You need to be assigned permissions before you can run this cmdlet. Although all parameters for this cmdlet are listed in this topic, you may not have access to some parameters if they're not included in the permissions assigned to you. To see what permissions you need, see the "Legacy permissions" entry in the Role Management Permissions topic.

 

Parameter Required Type Description

Identity

Required

Microsoft.Exchange.Configuration.Tasks.ADRawEntryIdParameter

The Identity parameter specifies the identity of the object for which you're retrieving permissions. You can retrieve the permissions for any Active Directory object using its distinguished name (DN). If the object is an Exchange object, you might be able to use the object's name. If the DN or the object's name contains spaces, enclose the value in quotation marks (").

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

The DomainController parameter specifies the fully qualified domain name (FQDN) of the domain controller that retrieves data from Active Directory.

Owner

Optional

System.Management.Automation.SwitchParameter

The Owner switch specifies that the owner of the object specified in the Identity parameter should be returned. If the Owner switch is used, the User parameter can't be used.

User

Optional

Microsoft.Exchange.Configuration.Tasks.SecurityPrincipalIdParameter

The User parameter specifies that only the access control entries (ACEs) granted to the specified user on the object specified in the Identity parameter should be returned. If the User parameter is used, the Owner switch can't be used.

If the name of the user contains spaces, enclose the name in quotation marks (").

To see the input types that this cmdlet accepts, see Cmdlet Input and Output Types. If the Input Type field for a cmdlet is blank, the cmdlet doesn’t accept input data.

To see the return types, which are also known as output types, that this cmdlet accepts, see Cmdlet Input and Output Types. If the Output Type field is blank, the cmdlet doesn’t return data.

 
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.