Applies to: Exchange Server 2013
Topic Last Modified: 2012-09-17
Managed folders aren’t available in this release. You must use retention policies for messaging records management.
For information about the parameter sets in the Syntax section below, see Syntax.
Syntax
New-ManagedContentSettings -FolderName
<ELCFolderIdParameter> -MessageClass <String> -Name
<String> [-AddressForJournaling <RecipientIdParameter>]
[-AgeLimitForRetention <EnhancedTimeSpan>] [-Confirm
[<SwitchParameter>]] [-DomainController <Fqdn>]
[-JournalingEnabled <$true | $false>] [-LabelForJournaling
<String>] [-MessageFormatForJournaling <UseMsg |
UseTnef>] [-MoveToDestinationFolder
<ELCFolderIdParameter>] [-Organization
<OrganizationIdParameter>] [-RetentionAction
<MoveToDeletedItems | MoveToFolder | DeleteAndAllowRecovery |
PermanentlyDelete | MarkAsPastRetentionLimit | MoveToArchive>]
[-RetentionEnabled <$true | $false>] [-TriggerForRetention
<WhenDelivered | WhenMoved>] [-WhatIf
[<SwitchParameter>]]
|
Detailed Description
You need to be assigned permissions before you can run this cmdlet. Although all parameters for this cmdlet are listed in this topic, you may not have access to some parameters if they're not included in the permissions assigned to you. To see what permissions you need, see the "Messaging records management" entry in the Messaging Policy and Compliance Permissions topic.
Parameters
Parameter | Required | Type | Description | ||||||
---|---|---|---|---|---|---|---|---|---|
FolderName |
Required |
Microsoft.Exchange.Configuration.Tasks.ELCFolderIdParameter |
The FolderName parameter specifies the name or GUID of the managed folder to which the managed content settings apply. |
||||||
MessageClass |
Required |
System.String |
The MessageClass parameter specifies the message type to which any expiration and journaling configuration settings within these content settings apply. The parameter value can be a well-known message type such as Calendar items, a specific message class such as IPM.NOTE.SMIME, or a custom message class. The following well-known message types can be used:
Valid parameter values for custom message classes include:
|
||||||
Name |
Required |
System.String |
The Name parameter specifies a unique name for the managed content settings. |
||||||
AddressForJournaling |
Optional |
Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter |
The AddressForJournaling parameter specifies the journaling recipient to which journaled messages are sent.
|
||||||
AgeLimitForRetention |
Optional |
Microsoft.Exchange.Data.EnhancedTimeSpan |
The AgeLimitForRetention parameter specifies the age at
which retention is enforced on an item. The age limit corresponds
to the number of days from the date the item was delivered, or the
date an item was created if it wasn't delivered. If this parameter
isn't present and the RetentionEnabled parameter is set to
|
||||||
Confirm |
Optional |
System.Management.Automation.SwitchParameter |
The Confirm switch causes the command to pause processing and requires you to acknowledge what the command will do before processing continues. You don't have to specify a value with the Confirm switch. |
||||||
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
The DomainController parameter specifies the fully qualified domain name (FQDN) of the domain controller that writes this configuration change to Active Directory. |
||||||
JournalingEnabled |
Optional |
System.Boolean |
The JournalingEnabled parameter specifies that journaling
is enabled when set to |
||||||
LabelForJournaling |
Optional |
System.String |
The LabelForJournaling parameter specifies a label that's attached to an item. This label is used by the destination store to determine the content of the item and enforce the appropriate policy. |
||||||
MessageFormatForJournaling |
Optional |
Microsoft.Exchange.Data.Directory.SystemConfiguration.JournalingFormat |
The MessageFormatForJournaling parameter specifies the message format that an item should be journaled in. You can use the following values:
|
||||||
MoveToDestinationFolder |
Optional |
Microsoft.Exchange.Configuration.Tasks.ELCFolderIdParameter |
The MoveToDestinationFolder parameter specifies the destination folder for a move action. The destination folder must be an existing managed custom
folder. If it isn't, an error is returned. If the
MoveToDestinationFolder parameter isn't present, and the
value of the RetentionAction parameter is
|
||||||
Organization |
Optional |
Microsoft.Exchange.Configuration.Tasks.OrganizationIdParameter |
The Organization parameter is reserved for internal Microsoft use. |
||||||
RetentionAction |
Optional |
Microsoft.Exchange.Data.Directory.SystemConfiguration.RetentionActionType |
The RetentionAction parameter specifies one of the following actions:
If this parameter isn't present and the RetentionEnabled
parameter is set to |
||||||
RetentionEnabled |
Optional |
System.Boolean |
The RetentionEnabled parameter specifies that retention
is enabled when set to |
||||||
TriggerForRetention |
Optional |
Microsoft.Exchange.Data.Directory.SystemConfiguration.RetentionDateType |
The TriggerForRetention parameter specifies the date that's considered as the start date for the retention period. An item can reach its retention limit a specific number of days after the item was delivered or after it was moved to a folder. Valid values include:
This value corresponds to the 0x4 bit of the
msExchELCFlags attribute in Active Directory. The flag is
set to If this parameter isn't present and the RetentionEnabled
parameter is set to |
||||||
WhatIf |
Optional |
System.Management.Automation.SwitchParameter |
The WhatIf switch instructs the command to simulate the actions that it would take on the object. By using the WhatIf switch, you can view what changes would occur without having to apply any of those changes. You don't have to specify a value with the WhatIf switch. |
Input Types
To see the input types that this cmdlet accepts, see Cmdlet Input and Output Types. If the Input Type field for a cmdlet is blank, the cmdlet doesn’t accept input data.
Return Types
To see the return types, which are also known as output types, that this cmdlet accepts, see Cmdlet Input and Output Types. If the Output Type field is blank, the cmdlet doesn’t return data.