Applies to: Exchange Server 2007
Topic Last Modified: 2007-06-05

Use the Get-ManagedFolder cmdlet to retrieve the attributes of one or more managed folders.


Get-ManagedFolder [-Identity <ELCFolderIdParameter>] [-DomainController <Fqdn>]
Get-ManagedFolder [-DomainController <Fqdn>] [-Mailbox <MailboxIdParameter>]


Parameter Required Type Description




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.




The Identity parameter specifies the name, distinguished name, or GUID of the managed folder.




The Mailbox parameter specifies the methods by which to identify a mailbox. These methods include Simple Mail Transfer Protocol (SMTP) addresses, domain name, and alias. The command retrieves all the folders that apply to the specified user.

Detailed Description

Use the Get-ManagedFolder cmdlet to retrieve the specified managed folder attributes:

  • If only an Identity parameter value is present, the command returns the specified folder and all associated attributes.

  • If a Mailbox parameter value is present, the command retrieves all folders that apply to that user by means of a managed folder mailbox policy applied by an administrator.

    Managed folders that users add by means of an organization's managed folder opt-in Web site are not displayed by this command. For more information about creating a managed folder opt-in Web site, see the Microsoft Exchange Server 2007 Software Development Kit.
  • If no parameter values are specified, the command returns all the folder objects and their associated attributes.

The Get-ManagedFolder cmdlet accepts a ManagedFolder object or an identity string as pipelined input.

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


Error Description



Exceptions Description



In this example, the Get-ManagedFolder command retrieves information about the specified managed folder named MyManagedFolder. The output of the Get-ManagedFolder command is piped to the Format-List command so that all the available information is displayed in the result.

Copy Code
Get-ManagedFolder MyManagedFolder | Format-List