Get-PublicFolderAdministrativePermission

 

Applies to: Exchange Server 2007 SP1, Exchange Server 2007 SP2, Exchange Server 2007 SP3

Use the Get-PublicFolderAdministrativePermission cmdlet to get the administrative permissions for a public folder or a public folder hierarchy.

Syntax

Get-PublicFolderAdministrativePermission -Identity <PublicFolderIdParameter> [-DomainController <Fqdn>] [-Server <ServerIdParameter>] [-User <SecurityPrincipalIdParameter>]

Get-PublicFolderAdministrativePermission -Identity <PublicFolderIdParameter> [-DomainController <Fqdn>] [-Owner <SwitchParameter>] [-Server <ServerIdParameter>]

Detailed Description

To run the Get-PublicFolderAdministrativePermission 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

Identity

Required

Microsoft.Exchange.Configuration.Tasks.PublicFolderIdParameter

Use the Identity parameter to specify the GUID or public folder name that represents a specific public folder. You can also include the path using the format TopLevelPublicFolder\PublicFolder.

You can omit the parameter label Identity so that only the public folder name or GUID is supplied.

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.

Owner

Optional

System.Management.Automation.SwitchParameter

The Owner parameter specifies that the command should return only the owner of the public folder.

Server

Optional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

The Server parameter specifies the server on which to perform the selected operations.

User

Optional

Microsoft.Exchange.Configuration.Tasks.SecurityPrincipalIdParameter

The User parameter specifies the user principal name (UPN), domain\user, or alias of the user for whom administrative permissions are sought.

Input Types

Return Types

Errors

Error Description

Exceptions

Exceptions Description

Example

In the first example, the Get-PublicFolderAdministrativePermission command is used to retrieve the access rights for all users of the public folder named My Public Folder.

In the second example, the Get-PublicFolderAdministrativePermission command is used to retrieve the administrative permissions for the public folder named My Public Folder, for the user named Chris, on the server named My Server. In this example, the output of the Get-PublicFolderAdministrativePermission command is piped to the Format-List command so that all the available information is displayed in the result.

In the third example, the Get-PublicFolderAdministrativePermission command is used to determine the owner of the public folder named My Public Folder.

Get-PublicFolderAdministrativePermission -Identity "\My Public Folder"

Get-PublicFolderAdministrativePermission -Identity "\My Public Folder" -User Chris -Server "My Server" | Format-List

Get-PublicFolderAdministrativePermission -Identity "\My Public Folder" -Owner

Use the Get-PublicFolderClientPermission cmdlet to retrieve the user permissions for a public folder.