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