Applies to: Exchange Server 2007 SP3, Exchange Server
2007 SP2, Exchange Server 2007 SP1
Topic Last Modified: 2007-06-28
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>]
|
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. |
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.
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.
 Copy Code |
|
|---|---|
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.