Share via


Get-PublicFolderClientPermission

 

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

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

Syntax

Get-PublicFolderClientPermission -Identity <PublicFolderIdParameter> [-DomainController <Fqdn>] [-Server <ServerIdParameter>] [-User <PublicFolderUserIdParameter>]

Detailed Description

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

Server

Optional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

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

User

Optional

Microsoft.Exchange.Management.Tasks.PublicFolderUserIdParameter

The User parameter specifies the user principal name (UPN), domain\user, or alias of the user.

Input Types

Return Types

Errors

Error Description

 

Exceptions

Exceptions Description

 

Example

In the first example, the Get-PublicFolderClientPermission command is used to retrieve the access rights for all users of \My Public Folder.

In the second example, the Get-PublicFolderClientPermission command is used to retrieve the permissions on 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-PublicFolderClientPermission command is piped to the Format-List command so that all the available information is displayed in the result.

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