How to Get Information About Public Folders
This topic explains how to use the Exchange Management Shell to get information about public folders.
To perform this procedure, the account you use must be delegated the following:
- Exchange Server Administrator role and local Administrators group for the target server
For more information about permissions, delegating roles, and the rights that are required to administer Exchange Server 2007, see Permission Considerations.
Also, before you perform this procedure, be aware of the following:
- In Microsoft Exchange Server 2007, public folders are managed only in the Exchange Management Shell. You cannot use the Exchange Management Console.
- By default, system folders are not displayed. (For example, they are not displayed when you run the command
Get-PublicFolder -Identity "\" -Recurse | Format-List Name
, which shows the names of all the other public folders.) To view the system folders, you must specify the system folder root, for example,Get-PublicFolder -Identity \NON_IPM_SUBTREE -Recurse | Format-List Name
. - By default, the maximum number of public folders about which information is returned is 10,000. You can change this default number by using the ResultSize parameter. The ResultSize parameter must be used in combination with either the Recurse or the GetChildren parameter. For more information about using the ResultSize parameter, see the examples listed in the following procedure.
Important
You can use the Get-PublicFolder cmdlet to get information about only mail-enabled public folders. You cannot use it to get mail-related information. If you want to get mail-related information about mail-enabled public folders, use the Get-MailPublicFolder cmdlet.
To get information about the root public folder, run one of the following commands:
Get-PublicFolder
-or-
Get-PublicFolder -Identity "\"
To get the names of the root public folder and all the public folders below it in the hierarchy, run the following command:
Get-PublicFolder -Recurse | Format-List Name
Note
By default, system folders are not displayed. (For example, they are not displayed when you run the command
Get-PublicFolder -Recurse | Format-List Name
.) To view the system folders, you must specify the system folder root. For details, see the following example.To get the names of all the system folders (which are not displayed by default), run the following command (starting at the system folder root,
\Non_IPM_SUBTREE
):Get-PublicFolder -Identity \NON_IPM_SUBTREE -Recurse | Format-List Name
To get information about the public folder named "Legal" in the root public folder of the server named "My Server," run the following command:
Get-PublicFolder -Identity "\Legal" -Server "My Server"
To get information about the public folder named "Pending Cases" contained in the "Legal" folder, run the following command:
Get-PublicFolder -Identity "\Legal\Pending Cases"
To get information about the public folder named "Legal" and all the public folders contained within it, run the following command:
Get-PublicFolder -Identity "\Legal" -Recurse
To get information about just the public folders that are contained within the public folder named "Legal" (but not the parent "Legal" folder or children of the children), run the following command:
Get-PublicFolder -Identity "\Legal" -GetChildren
To get just the names of all public folders, run the following command. This command pipes the output of the Get-PublicFolder cmdlet to the Format-List cmdlet.
Get-PublicFolder -Recurse | Format-List Name
To get the names of all public folders in the folder named "Legal," but limit the number of results that are returned to 100, run the following command:
Get-PublicFolder -Identity "Legal" -Recurse -ResultSize 100 | Format-List Name
Note
You can only use the ResultSize parameter in combination with the Recurse or GetChildren parameters.
To get the names of all public folders in the folder named "Legal," with no limit on the number of results that are returned, run the following command:
Get-PublicFolder -Identity "Legal" -Recurse -ResultSize Unlimited | Format-List Name
Note
You can only use the ResultSize parameter in combination with the Recurse or GetChildren parameters.
For detailed syntax and parameter information, see the Get-PublicFolder reference topic.
- For a list of the Exchange Management Shell cmdlets that you can use to manage public folders, see Managing Public Folders.
- For more information about using the Exchange Management Shell, see Using the Exchange Management Shell.
- For more information about managing public folders, see Managing Public Folders.
[Topic Last Modified: 2007-02-21]