Applies to: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Topic Last Modified: 2007-06-28

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

Syntax

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

Parameters

Parameter Required Type Description

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.

Identity

Optional

Microsoft.Exchange.Configuration.Tasks.ELCFolderIdParameter

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

Mailbox

Optional

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

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.

    Note:
       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

Errors

Error Description

 

Exceptions

Exceptions Description

 

Example

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