Применимо к: 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 указывает почтовый ящик для назначения принятых тегов.
|
||
AddressForJournaling |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter |
Данный параметр недоступен в этой версии. |
||
AgeLimitForRetention |
Необязательный |
Microsoft.Exchange.Data.EnhancedTimeSpan |
Параметр AgeLimitForRetention указывает время хранения
элемента. Максимальное время хранения соответствует числу дней от
даты доставки элемента или его создания, если он не был доставлен.
Если этот параметр не указан, а значение параметра
RetentionEnabled равно |
||
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 указывает, можно ли
скрывать комментарии. Значение по умолчанию:
|
||
Name |
Необязательный |
System.String |
Параметр Name указывает имя тега политики хранения. |
||
OptionalInMailbox |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.RetentionPolicyTagIdParameter[] |
Параметр OptionalInMailbox используется с параметром Mailbox для указания принятых тегов хранения, доступных для почтового ящика. |
||
RetentionAction |
Необязательный |
Microsoft.Exchange.Data.Directory.SystemConfiguration.RetentionActionType |
Параметр RetentionAction указывает одно из следующих действий:
Если этот параметр не указан, а значение параметра
RetentionEnabled равно |
||
RetentionEnabled |
Необязательный |
System.Boolean |
Параметр RetentionEnabled указывает, включен ли тег. Если
его значение равно
Если задать для параметра RetentionEnabled значение
|
||
RetentionId |
Необязательный |
System.Guid |
Параметр RetentionId задает идентификатор альтернативного тега, позволяющий гарантировать, что тег сохранения на элементах почтового ящика, помеченных в одной организации Exchange, будет совпадать с тегом при перемещении почтового ящика в другую организацию Exchange (например, при развертывании в нескольких лесах или нелокальном развертывании, при перемещении почтового ящика с локального сервера Exchange в облако или наоборот).
|
||
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" |