Get-ManagedContentSettings

 

Applies to: Exchange Server 2007 SP1, Exchange Server 2007 SP2, Exchange Server 2007 SP3

Use the Get-ManagedContentSettings cmdlet to retrieve from one to all the managed content settings.

Syntax

Get-ManagedContentSettings [-Identity <ELCContentSettingsIdParameter>] [-DomainController <Fqdn>]

Get-ManagedContentSettings [-DomainController <Fqdn>] [-FolderName <ELCFolderIdParameter>]

Detailed Description

Use the Get-ManagedContentSettings cmdlet to retrieve from one to all the managed content settings. If only the Identity parameter is present, the folder content settings and all associated attributes are returned. If the Identity parameter is not present, the command returns all content settings. If the FolderName parameter is present, the command returns all folder policies contained in the specified folder and all the attributes of each policy.

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

FolderName

Optional

Microsoft.Exchange.Configuration.Tasks.ELCFolderIdParameter

The FolderName parameter specifies the name or the GUID of the managed folder to which the managed content settings apply. When used, this command retrieves all the policies that apply to that folder.

Note

This parameter cannot be used with the Identity parameter.

Identity

Optional

Microsoft.Exchange.Configuration.Tasks.ELCContentSettingsIdParameter

The Identity parameter specifies the name, distinguished name, or the GUID of the set of managed content settings. When used, this command retrieves the folder content settings and all associated attributes.

Note

This parameter cannot be used with the FolderName parameter.

Input Types

Return Types

Errors

Error Description

Exceptions

Exceptions Description

Example

In the first example, the Get-ManagedContentSettings command is used without parameters to obtain all managed content settings. The output of the Get-ManagedContentSettings command is piped to the Format-List command so that all the available information is displayed in the result.

In the second example, the Get-ManagedContentSettings command retrieves the managed content settings named Inbox Settings.

In the third example, the Get-ManagedContentSettings command retrieves the managed content settings for the Inbox folder.

Get-ManagedContentSettings | Format-List
Get-ManagedContentSettings -Identity "Inbox Settings"
Get-ManagedContentSettings -FolderName "Inbox"