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

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

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

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

Синтаксис

New-RetentionPolicyTag -Name <String> [-AddressForJournaling <RecipientIdParameter>] [-AgeLimitForRetention <EnhancedTimeSpan>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-JournalingEnabled <$true | $false>] [-LabelForJournaling <String>] [-LocalizedComment <MultiValuedProperty>] [-LocalizedRetentionPolicyTagName <MultiValuedProperty>] [-MessageClass <String>] [-MessageFormatForJournaling <UseMsg | UseTnef>] [-MustDisplayCommentEnabled <$true | $false>] [-Organization <OrganizationIdParameter>] [-RetentionAction <MoveToDeletedItems | MoveToFolder | DeleteAndAllowRecovery | PermanentlyDelete | MarkAsPastRetentionLimit | MoveToArchive>] [-RetentionEnabled <$true | $false>] [-RetentionId <Guid>] [-SystemTag <$true | $false>] [-Type <Calendar | Contacts | DeletedItems | Drafts | Inbox | JunkEmail | Journal | Notes | Outbox | SentItems | Tasks | All | ManagedCustomFolder | RssSubscriptions | SyncIssues | ConversationHistory | Personal | RecoverableItems>] [-WhatIf [<SwitchParameter>]]
New-RetentionPolicyTag -Name <String> [-Comment <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-LocalizedComment <MultiValuedProperty>] [-LocalizedRetentionPolicyTagName <MultiValuedProperty>] [-ManagedFolderToUpgrade <ELCFolderIdParameter>] [-MustDisplayCommentEnabled <$true | $false>] [-Organization <OrganizationIdParameter>] [-SystemTag <$true | $false>] [-Type <Calendar | Contacts | DeletedItems | Drafts | Inbox | JunkEmail | Journal | Notes | Outbox | SentItems | Tasks | All | ManagedCustomFolder | RssSubscriptions | SyncIssues | ConversationHistory | Personal | RecoverableItems>] [-WhatIf [<SwitchParameter>]]

Параметры

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

Name

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

System.String

Параметр Name указывает имя тега.

AddressForJournaling

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

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter

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

AgeLimitForRetention

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

Microsoft.Exchange.Data.EnhancedTimeSpan

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

Comment

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

System.String

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

Confirm

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

System.Management.Automation.SwitchParameter

Параметр Confirm приостанавливает обработку и требует указать действие, которое будет выполнено командой перед ее возобновлением. Указывать значение параметра Confirm не обязательно.

DomainController

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

Microsoft.Exchange.Data.Fqdn

Параметр DomainController указывает имя FQDN контроллера домена, который записывает это изменение конфигурации в Служба каталогов Active Directory.

JournalingEnabled

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

System.Boolean

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

LabelForJournaling

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

System.String

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

LocalizedComment

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

Microsoft.Exchange.Data.MultiValuedProperty

Параметр LocalizedComment задает локализованные комментарии и используемые для них языки. Если выбранный язык пользователя совпадает с языком, указанным в этом параметре, то в приложениях Microsoft Outlook и Microsoft Office Outlook Web App отображается соответствующий локализованный комментарий. Комментарии задаются в форме код языка ISO: комментарий, например: LocalizedComment EN-US:"This is a localized comment in U.S. English".

LocalizedRetentionPolicyTagName

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

Microsoft.Exchange.Data.MultiValuedProperty

Параметр LocalizedRetentionPolicyTagName задает локализованные имена тегов и используемые для них языки. Когда параметр языка пользователя совпадает с языком, указанным для этого параметра, то в приложениях Outlook и Outlook Web App отображается соответствующее локализованное имя тега. Имена задаются в форме код языка ISO: имя, например: LocalizedRetentionPolicyTagName EN-US:"Business Critical".

ManagedFolderToUpgrade

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

Microsoft.Exchange.Configuration.Tasks.ELCFolderIdParameter

Параметр ManagedFolderToUpgrade указывает имя управляемой папки для использования в качестве шаблона для тега хранения.

MessageClass

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

System.String

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

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

MessageFormatForJournaling

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

Microsoft.Exchange.Data.Directory.SystemConfiguration.JournalingFormat

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

MustDisplayCommentEnabled

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

System.Boolean

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

Organization

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

Microsoft.Exchange.Configuration.Tasks.OrganizationIdParameter

Этот параметр доступен для развертываний с несколькими клиентами В случае локального развертывания он недоступен. Дополнительные сведения о развертывании с несколькими клиентами см. в разделе Multi-Tenant Support.

Параметр Organization указывает организацию, в которой будет выполняться это действие. Этот параметр не допускает ввода подстановочных знаков, поэтому необходимо использовать точное название организации.

RetentionAction

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

Microsoft.Exchange.Data.Directory.SystemConfiguration.RetentionActionType

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

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

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

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

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

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

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

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

RetentionEnabled

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

System.Boolean

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

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

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

RetentionId

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

System.String

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

SystemTag

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

System.Guid

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

Type

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

Microsoft.Exchange.Data.Directory.SystemConfiguration.ElcFolderType

Параметр Type указывает тип создаваемого тега хранения. Допустимыми являются следующие значения:

  • Contacts

  • DeletedItems

  • Drafts

  • Inbox

  • JunkEmail

  • Journal

  • Notes

  • Outbox

  • SentItems

  • All

  • RecoverableItems

  • RssSubscriptions

  • SyncIssues

  • ConversationHistory

  • Personal

Примечание.
Чтобы создать тег политики по умолчанию (DPT), укажите тип All. Теги хранения для папок Calendar и Tasks не поддерживаются. Для тегов типа RecoverableItems единственным допустимым действием хранения являетсяMoveToArchive.

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

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

Теги хранения поддерживают отображение имени тега и дополнительного комментария на языках локализации. Для этой цели используются коды языковых культур из класса CultureInfo.

Для запуска этого командлета необходимы соответствующие разрешения. В этом разделе перечислены все параметры командлета, однако некоторые из них могут быть недоступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях см. в разделе Запись «Управление записями сообщений» в разделе Политика обмена сообщениями и соответствие требованиям.

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

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

Ошибки

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

 

 

Примеры

ПРИМЕР 1

В этом примере создается тег политики хранения Finance-DeletedItems для папки по умолчанию «Удаленные». Когда тег применяется к почтовому ящику как часть политики хранения, происходит окончательное удаление элементов всех типов в папке «Удаленные» за 30 дней.

Скопировать код
New-RetentionPolicyTag "Finance-DeletedItems" -Type DeletedItems -RetentionEnabled $true -AgeLimitForRetention 30 -RetentionAction PermanentlyDelete

ПРИМЕР 2

В этом примере создается тег политики по умолчанию Finance-Default. Когда тег применяется к почтовому ящику как часть политики хранения, происходит окончательное удаление всех элементов без тега хранения за 365 дней. Не оказывается никакого воздействия на те элементы отдельного класса сообщений, например Voicemail, для которых существует тег по умолчанию (тег хранения типа All).

Скопировать код
New-RetentionPolicyTag "Finance-Default" -Type All -RetentionEnabled $true -AgeLimitForRetention 365 -RetentionAction PermanentlyDelete

ПРИМЕР 3

В этом примере создается тег хранения «Критические для предприятия» типа Personal. Когда тег применяется к элементам почтового ящика в рамках политики сохранения, окончательное удаление элементов происходит приблизительно за 7 лет.

Скопировать код
New-RetentionPolicyTag "Business Critical" -Type Personal -Comment "Use this tag for all business critical mail" -RetentionEnabled $true -AgeLimitForRetention 2556 -RetentionAction PermanentlyDelete