Применимо к: Exchange Server 2010 SP1

Последнее изменение раздела: 2011-03-19

Командлет Set-RetentionPolicyTag используется для изменения свойств тега хранения.

Дополнительные сведения о тегах сохранения см. в разделе Общие сведения о тегах и политиках хранения.

Синтаксис

Set-RetentionPolicyTag -Identity <RetentionPolicyTagIdParameter> [-AddressForJournaling <RecipientIdParameter>] [-AgeLimitForRetention <EnhancedTimeSpan>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Force <SwitchParameter>] [-JournalingEnabled <$true | $false>] [-LabelForJournaling <String>] [-LegacyManagedFolder <ELCFolderIdParameter>] [-LocalizedComment <MultiValuedProperty>] [-LocalizedRetentionPolicyTagName <MultiValuedProperty>] [-MessageClass <String>] [-MessageFormatForJournaling <UseMsg | UseTnef>] [-MustDisplayCommentEnabled <$true | $false>] [-Name <String>] [-RetentionAction <MoveToDeletedItems | MoveToFolder | DeleteAndAllowRecovery | PermanentlyDelete | MarkAsPastRetentionLimit | MoveToArchive>] [-RetentionEnabled <$true | $false>] [-RetentionId <Guid>] [-SystemTag <$true | $false>] [-WhatIf [<SwitchParameter>]]
Set-RetentionPolicyTag -Mailbox <MailboxIdParameter> [-Comment <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Force <SwitchParameter>] [-LegacyManagedFolder <ELCFolderIdParameter>] [-LocalizedComment <MultiValuedProperty>] [-LocalizedRetentionPolicyTagName <MultiValuedProperty>] [-MustDisplayCommentEnabled <$true | $false>] [-Name <String>] [-OptionalInMailbox <RetentionPolicyTagIdParameter[]>] [-RetentionId <Guid>] [-SystemTag <$true | $false>] [-WhatIf [<SwitchParameter>]]

Параметры

Параметр Обязательность Тип Описание

Identity

Обязательный

Microsoft.Exchange.Configuration.Tasks.RetentionPolicyTagIdParameter

Параметр Identity указывает имя, различающееся имя или идентификатор GUID тега политики хранения, который необходимо изменить.

Mailbox

Обязательный

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Параметр Mailbox указывает почтовый ящик для назначения принятых тегов.

Важно!
Необходимо использовать этот параметр с параметром OptionalInMailbox.

AddressForJournaling

Необязательный

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter

Данный параметр недоступен в этой версии.

AgeLimitForRetention

Необязательный

Microsoft.Exchange.Data.EnhancedTimeSpan

Параметр AgeLimitForRetention указывает время хранения элемента. Максимальное время хранения соответствует числу дней от даты доставки элемента или его создания, если он не был доставлен. Если этот параметр не указан, а значение параметра RetentionEnabled равно $true, возвращается ошибка.

Comment

Необязательный

System.String

Параметр Comment указывает комментарий для тега политики хранения.

Confirm

Необязательный

System.Management.Automation.SwitchParameter

DomainController

Необязательный

Microsoft.Exchange.Data.Fqdn

Force

Необязательный

System.Management.Automation.SwitchParameter

Параметр Force подавляет отображение запроса на подтверждение при использовании параметра RetentionId.

JournalingEnabled

Необязательный

System.Boolean

Данный параметр недоступен в этой версии.

LabelForJournaling

Необязательный

System.String

Данный параметр недоступен в этой версии.

LegacyManagedFolder

Необязательный

Microsoft.Exchange.Configuration.Tasks.ELCFolderIdParameter

Параметр LegacyManagedFolder указывает имя управляемой папки. Тег сохранения создается на основе параметров сохранения управляемой папки и соответствующих параметров управляемого содержимого. Этот параметр можно использовать для создания тегов сохранения на основе существующих управляемых папок при переносе пользователей из политик почтовых ящиков управляемых папок в политики сохранения.

LocalizedComment

Необязательный

Microsoft.Exchange.Data.MultiValuedProperty

Параметр LocalizedComment указывает локализованный комментарий и язык для тега политики хранения. Этот комментарий отображается в Microsoft Outlook на языке, указанном пользователем.

LocalizedRetentionPolicyTagName

Необязательный

Microsoft.Exchange.Data.MultiValuedProperty

Параметр LocalizedRetentionPolicyTagName указывает локализованное имя для тега политики хранения. Этот имя отображается в Microsoft Outlook на языке, указанном пользователем.

MessageClass

Необязательный

System.String

Параметр MessageClass указывает тип сообщения, к которому применяется тег. Если параметр не задан, то значение по умолчанию устанавливается как *.

Exchange 2010 не поддерживает теги хранения для разных типов сообщений. Поддерживаются только теги со значением параметра MessageClass*, и они применяются ко всем типам сообщений.

MessageFormatForJournaling

Необязательный

Microsoft.Exchange.Data.Directory.SystemConfiguration.JournalingFormat

Данный параметр недоступен в этой версии.

MustDisplayCommentEnabled

Необязательный

System.Boolean

Параметр MustDisplayCommentEnabled указывает, можно ли скрывать комментарии. Значение по умолчанию: $true.

Name

Необязательный

System.String

Параметр Name указывает имя тега политики хранения.

OptionalInMailbox

Необязательный

Microsoft.Exchange.Configuration.Tasks.RetentionPolicyTagIdParameter[]

Параметр OptionalInMailbox используется с параметром Mailbox для указания принятых тегов хранения, доступных для почтового ящика.

RetentionAction

Необязательный

Microsoft.Exchange.Data.Directory.SystemConfiguration.RetentionActionType

Параметр RetentionAction указывает одно из следующих действий:

  • MarkAsPastRetentionLimit   Это действие недоступно для тегов сохранения. Если указать это действие для тега сохранения, то сообщения, к которым применен этот тег, не удаляются и не помечаются как сообщения с превышением предельного срока сохранения.

  • MoveToFolder   Это действие недоступно для тегов сохранения. Это действие нельзя указать для тега сохранения.

  • MoveToDeletedItems   Это действие недоступно для тегов сохранения. Если указать это действие для тега сохранения, то сообщения, к которым применен этот тег, не удаляются и не помечаются как сообщения с превышением предельного срока сохранения.

  • DeleteAndAllowRecovery   Это действие удаляет сообщение и разрешает восстановление из папки «Элементы для восстановления».

  • PermanentlyDelete   Это действие окончательно удаляет сообщение. Сообщение, которое было окончательно удалено, не может быть восстановлено из папки «Элементы для восстановления». Окончательно удаленные сообщения не возвращаются при поиске на обнаружение, если только для почтового ящика не включено судебное удержание.

  • MoveToArchive   Это действие перемещает сообщение в архивный почтовый ящик пользователя.

Если этот параметр не указан, а значение параметра RetentionEnabled равно $true, возвращается ошибка.

RetentionEnabled

Необязательный

System.Boolean

Параметр RetentionEnabled указывает, включен ли тег. Если его значение равно $false, то тег отключен, и к сообщениям, к которым применен этот тег, не применяются действия сохранения.

Примечание.
Сообщения с отключенным тегом считаются отмеченными, поэтому к таким сообщениям не применяются теги политики по умолчанию из политики сохранения пользователя.

Если задать для параметра RetentionEnabled значение $false, то период сохранения для тега отображается как Никогда. Пользователи могут применять этот тег к элементам, которые они хотят отметить как не подлежащие удалению или перемещению в архив. Последующее включение тега может привести к непреднамеренному удалению или архивации элементов. Во избежание подобной ситуации при временном отключении политики сохранения рекомендуется изменить имя тега, чтобы пользователи не применяли его. Пример: DISABLED_<Original Name>.

RetentionId

Необязательный

System.Guid

Параметр RetentionId задает идентификатор альтернативного тега, позволяющий гарантировать, что тег сохранения на элементах почтового ящика, помеченных в одной организации Exchange, будет совпадать с тегом при перемещении почтового ящика в другую организацию Exchange (например, при развертывании в нескольких лесах или нелокальном развертывании, при перемещении почтового ящика с локального сервера Exchange в облако или наоборот).

Важно!
Обычно указывать или изменять параметр RetentionId для тега сохранения не требуется. Параметр автоматически заполняется сценарием <имя сценария> при импорте тегов сохранения в межлесном или нелокальном развертывании.

SystemTag

Необязательный

System.Boolean

Параметр SystemTag указывает, что тег политики хранения создается для внутренней функции Exchange.

WhatIf

Необязательный

System.Management.Automation.SwitchParameter

Подробное описание

Теги хранения позволяют применять параметры хранения сообщений к папкам и элементам почтового ящика.

Запись «Управление записями сообщений» в разделе Политика обмена сообщениями и соответствие требованиям.

Типы входных данных

Типы возвращаемых данных

Ошибки

Ошибка Описание

 

 

Примеры

ПРИМЕР 1

В этом примере изменяется комментарий для тега политики хранения AllUsers-DeletedItems.

Скопировать код
Set-RetentionPolicyTag "AllUsers-DeletedItems" -Comment "Items in the Deleted Items folder will be automatically deleted in 120 days"

ПРИМЕР 2

В этом примере создаются дополнительные теги хранения, доступные пользователю Сергею Климову посредством параметров Mailbox и OptionalInMailbox.

Скопировать код
Set-RetentionPolicyTag -Mailbox "Terry Adams" -OptionalInMailbox "ProjectA","ProjectB"