Get-ManagedFolder
Applies to: Exchange Server 2007 SP1, Exchange Server 2007 SP2, Exchange Server 2007 SP3
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>]
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.
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. |
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.
Get-ManagedFolder MyManagedFolder | Format-List