Petelgeuse Romanee-Conti

We would like to show you a description here but the site won’t allow us.

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.

Secondary Navigation

Retention tags are used to apply message retention settings to folders and items in a mailbox. You need to be assigned permissions before you can run this cmdlet. Although this topic lists all parame.

For more information about positional parameters, see Parameters https: The Confirm switch specifies whether to show or hide the confirmation prompt. How this switch affects the cmdlet depends on if the cmdlet requires confirmation before proceeding. For these cmdlets, you can skip the confirmation prompt by using this exact syntax: For these cmdlets, specifying the Confirm switch without a value introduces a pause that forces you acknowledge the command before proceeding.

The DomainController parameter specifies the domain controller that's used by this cmdlet to read data from or write data to Active Directory.

You identify the domain controller by its fully qualified domain name FQDN. The Force switch overrides the confirmation prompt displayed by the cmdlet when you use the RetentionId parameter. To set the default retention policy for new mailboxes, use the RetentionPolicy parameter on the Set-MailboxPlan cmdlet.

The IsDefaultArbitrationMailbox switch configures this policy as the default retention policy for arbitration mailboxes in your Exchange Online organization.

The RetentionId parameter specifies the identity of the retention policy to make sure mailboxes moved between two Exchange organizations continue to have the same retention policy applied to them. For example, in a cross-forest deployment or in a cross-premises deployment, when a mailbox is moved from an on-premises Exchange server to the cloud, or a cloud-based mailbox is moved to an on-premises Exchange server, this parameter is used to make sure the same retention policy is applied to the mailbox.

It's not normally required to specify or modify the RetentionId parameter for a retention tag. The parameter is populated automatically when importing retention tags using the Import-RetentionTags. The RetentionPolicyTagLinks parameter specifies the identity of retention policy tags to associate with the retention policy. Mailboxes that get a retention policy applied have retention tags linked with that retention policy.

The WhatIf switch simulates the actions of the command. You can use this switch to view the changes that would occur without actually applying those changes. You don't need to specify a value with this switch. To see the input types that this cmdlet accepts, see Cmdlet Input and Output Types https: If the Input Type field for a cmdlet is blank, the cmdlet doesn't accept input data.

To see the return types, which are also known as output types, that this cmdlet accepts, see Cmdlet Input and Output Types https: If the Output Type field is blank, the cmdlet doesn't return data.

The LocalizedComment parameter specifies the localized comment and language for the retention policy tag. This comment is displayed in Microsoft Outlook based on the user's locale. The LocalizedRetentionPolicyTagName parameter specifies a localized name for the retention policy tag. This name is displayed in Outlook based on the user's locale. The MessageClass parameter specifies the message type to which the tag applies. With the exception of a default policy tag DPT for voicemail, Exchange doesn't support retention tags for different message types.

The MustDisplayCommentEnabled parameter specifies whether the comment can be hidden. The OptionalInMailbox parameter is used with the Mailbox parameter to specify opt-in retention tags available to the mailbox. Moves a message to the user's archive mailbox. You can use this action for retention tags of type All, Personal, and RecoverableItems.

Permanently deletes a message. A message that has been permanently deleted can't be recovered using the Recoverable Items folder. Permanently deleted messages aren't returned in a Discovery search, unless litigation hold is enabled for the mailbox.

These actions are available for upgrades from messaging records management MRM 1. The RetentionEnabled parameter specifies whether the tag is enabled. Messages with a disabled tag are still considered tagged, so any default policy tags in the user's retention policy aren't applied to such messages. Users may apply this tag to items that they want to indicate should never be deleted or should never be moved to the archive.

Enabling the tag later may result in unintentional deletion or archiving of items. The RetentionId parameter specifies an alternate tag ID to ensure the retention tag found on mailbox items tagged in one Exchange organization matches the tag when the mailbox is moved to another Exchange organization for example, in a cross-forest deployment or in a cross-premises deployment, when a mailbox is moved from an on-premises Exchange server to the cloud, or a cloud-based mailbox is moved to an on-premises Exchange server.

It's not ordinarily required to specify or modify the RetentionId parameter for a retention tag. The SystemTag parameter specifies whether the retention policy tag is created for internal Exchange functionality. The WhatIf switch simulates the actions of the command. You can use this switch to view the changes that would occur without actually applying those changes. You don't need to specify a value with this switch.

To see the input types that this cmdlet accepts, see Cmdlet Input and Output Types https: If the Input Type field for a cmdlet is blank, the cmdlet doesn't accept input data. To see the return types, which are also known as output types, that this cmdlet accepts, see Cmdlet Input and Output Types https: If the Output Type field is blank, the cmdlet doesn't return data.

Our new feedback system is built on GitHub Issues. Read about this change in our blog post. Set-Retention Policy Tag Module: This cmdlet is available in on-premises Exchange and in the cloud-based service. Some parameters and settings may be exclusive to one environment or the other. Use the Set-RetentionPolicyTag cmdlet to modify the properties of a retention tag. For more information about retention tags, see Retention tags and retention policies https: