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