Применимо к: 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 равно |
||
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:
комментарий, например: |
||
LocalizedRetentionPolicyTagName |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Параметр LocalizedRetentionPolicyTagName задает
локализованные имена тегов и используемые для них языки. Когда
параметр языка пользователя совпадает с языком, указанным для этого
параметра, то в приложениях Outlook и Outlook Web
App отображается соответствующее локализованное имя тега.
Имена задаются в форме код языка ISO: имя, например:
|
||
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 указывает, можно ли
скрывать комментарии. По умолчанию значение равно
|
||
Organization |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.OrganizationIdParameter |
Этот параметр доступен для развертываний с несколькими клиентами В случае локального развертывания он недоступен. Дополнительные сведения о развертывании с несколькими клиентами см. в разделе Multi-Tenant Support. Параметр Organization указывает организацию, в которой будет выполняться это действие. Этот параметр не допускает ввода подстановочных знаков, поэтому необходимо использовать точное название организации. |
||
RetentionAction |
Необязательный |
Microsoft.Exchange.Data.Directory.SystemConfiguration.RetentionActionType |
Параметр RetentionAction указывает одно из следующих действий:
Если этот параметр не указан, а значение параметра
RetentionEnabled равно |
||
RetentionEnabled |
Необязательный |
System.Boolean |
Параметр RetentionEnabled указывает, включен ли тег. Если
его значение равно
Если задать для параметра RetentionEnabled значение
|
||
RetentionId |
Необязательный |
System.String |
Параметр RetentionId задает идентификатор альтернативного тега, позволяющий гарантировать, что тег хранения на элементах почтового ящика, помеченных в локальном развертывании, будет совпадать с тегом при перемещении почтового ящика в облако; либо что элементы почтового ящика, помеченные в облаке, будут совпадать с тегом при перемещении почтового ящика на локальный сервер Exchange. Параметр используется в случаях нелокального развертывания. Указывать этот параметр в случае исключительно локального развертывания не требуется. |
||
SystemTag |
Необязательный |
System.Guid |
Параметр SystemTag указывает, что тег создается для внутренней функции Exchange. |
||
Type |
Необязательный |
Microsoft.Exchange.Data.Directory.SystemConfiguration.ElcFolderType |
Параметр Type указывает тип создаваемого тега хранения. Допустимыми являются следующие значения:
|
||
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 |