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

Последнее изменение раздела: 2011-04-24

Используйте командлет New-ManagedContentSettings для создания параметров управляемого содержимого управляемых папок.

Синтаксис

New-ManagedContentSettings -Name <String> -FolderName <ELCFolderIdParameter> -MessageClass <String> [-AddressForJournaling <RecipientIdParameter>] [-AgeLimitForRetention <EnhancedTimeSpan>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-JournalingEnabled <$true | $false>] [-LabelForJournaling <String>] [-MessageFormatForJournaling <UseMsg | UseTnef>] [-MoveToDestinationFolder <ELCFolderIdParameter>] [-Organization <OrganizationIdParameter>] [-RetentionAction <MoveToDeletedItems | MoveToFolder | DeleteAndAllowRecovery | PermanentlyDelete | MarkAsPastRetentionLimit | MoveToArchive>] [-RetentionEnabled <$true | $false>] [-TriggerForRetention <WhenDelivered | WhenMoved>] [-WhatIf [<SwitchParameter>]]

Параметры

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

FolderName

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

Microsoft.Exchange.Configuration.Tasks.ELCFolderIdParameter

Параметр FolderName определяет имя или значение GUID управляемой папки, к которой применяются параметры управляемого содержимого.

MessageClass

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

System.String

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

Значение параметра может быть известным типом сообщений (например, элементами календаря), определенным классом сообщений (например IPM.NOTE.SMIME) или пользовательским классом сообщений. Ниже приведены известные типы сообщений, которые можно использовать.

  • Для типа сообщений Все содержимое почтового ящика используйте значение *.

  • Для типа сообщений Элементы календаря используйте значение IPM.Appointment*.

  • Для типа сообщений контактов используйте значение IPM.Contact*.

  • Для типа сообщений Документы используйте значение IPM.Document*.

  • Для типа сообщений Факсы используйте значение IPM.Note.Microsoft.Fax.

  • Для типа сообщений Элементы журнала используйте значение IPM.Activity.

  • Для типа сообщений Приглашения на собрания, ответы и отмены используйте значение IPM.Schedule*.

  • Для типа сообщений Заметки используйте значение IPM.StickyNote.

  • Для типа сообщений Отправки используйте значение IPM.Post.

  • Для типа сообщений Элементы RSS используйте значение IPM.Post.RSS.

  • Для типа сообщений Задачи используйте значение IPM.Task*.

  • Для типа сообщений Голосовая почта используйте значение IPM.Note.Microsoft.Voicemail*.

Допустимыми значениями параметра для пользовательских классов сообщений являются:

  • Определенный класс сообщений (например, IPM.NOTE).

  • Подстановочный знак «звездочка» (*) указывает, что параметры содержимого применяются ко всем классам сообщений.

  • Определенный класс сообщений со звездочкой. Звездочка как подстановочный знак должна быть последним символом в классе сообщений, например:

    IPM.NOTE*   Включается элемент IPM.NOTE и все подчиненные классы.

    IPM.NOTE.*   Включает подклассы IPM.NOTE, но не само значение IPM.NOTE.

Примечание.
Значения *.NOTE и IPM.*.NOTE недопустимы.
Примечание.
При использовании подстановочных знаков эти политики применяются только к тем классам сообщений, у которых нет определенного параметра содержимого. Поэтому значение IPM.NOTE.SMIME переопределяет IPM.NOTE.*.
Примечание.
Специальные параметры замещают общие настройки. Например, значение Voicemail замещает значение AllMailboxContent.

Name

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

System.String

С помощью параметра Name можно указать уникальное имя для параметров управляемого содержимого.

AddressForJournaling

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

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter

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

Примечание.
Этот параметр требуется, если для параметра JournalingEnabled установлено значение $true.

AgeLimitForRetention

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

Microsoft.Exchange.Data.EnhancedTimeSpan

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

Confirm

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

System.Management.Automation.SwitchParameter

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

DomainController

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

Microsoft.Exchange.Data.Fqdn

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

JournalingEnabled

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

System.Boolean

Параметр JournalingEnabled с установленным значением $true указывает, что функция ведения журнала включена.

LabelForJournaling

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

System.String

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

MessageFormatForJournaling

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

Microsoft.Exchange.Data.Directory.SystemConfiguration.JournalingFormat

Параметр MessageFormatForJournaling указывает формат сообщения, в котором элемент должен вноситься в журнал. Можно использовать следующие значения:

  • UseMsg   Формат MSG в приложении Outlook

  • UseTnef   Формат MAPI в приложении Outlook

MoveToDestinationFolder

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

Microsoft.Exchange.Configuration.Tasks.ELCFolderIdParameter

Параметр MoveToDestinationFolder указывает папку назначения для операции перемещения.

Папка назначения должна быть существуемой настраиваемой управляемой папкой. Если она не существует, возвращается ошибка. Если параметр MoveToDestinationFolder не указан, а значение параметра RetentionAction равно MoveToFolder, то возвращается ошибка.

Organization

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

Microsoft.Exchange.Configuration.Tasks.OrganizationIdParameter

Параметр Organization зарезервирован для внутреннего использования корпорацией Майкрософт.

RetentionAction

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

Microsoft.Exchange.Data.Directory.SystemConfiguration.RetentionActionType

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

  • Отметка срока хранения как прошедшего

  • Перемещение в настраиваемую управляемую папку

  • Перемещение в папку удаленных элементов

  • Удаление и разрешение восстановления

  • Непрерывное удаление

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

RetentionEnabled

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

System.Boolean

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

TriggerForRetention

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

Microsoft.Exchange.Data.Directory.SystemConfiguration.RetentionDateType

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

Допустимыми являются следующие значения:

  • WhenDelivered

  • WhenMoved

Это значение соответствует биту 0x4 атрибута msExchELCFlags в Служба каталогов Active Directory. Значение равно $true, если срок действия элемента зависит от даты перемещения. Значение $false устанавливается, если срок действия элемента зависит от даты доставки.

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

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

  • С помощью управления хранением содержимого и удаления ненужного содержимого.

  • С помощью автоматического журналирования важного содержимого в отдельную папку хранилища вне почтового ящика.

Дополнительные сведения о параметрах управляемого содержимого см. в разделе Управление записями сообщений.

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

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

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

Ошибки

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

  

  

Исключения

Исключения Описание

  

  

Примеры

ПРИМЕР 1

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

Скопировать код
New-ManagedContentSettings -Name "CS-Exec-DeletedItems" -FolderName "Exec-DeletedItems" -MessageClass * -RetentionEnabled $true -RetentionAction DeleteAndAllowRecovery -AgeLimitForRetention 30.00:00:00 -TriggerForRetention WhenDelivered

ПРИМЕР 2

В этом примере параметры управляемого содержимого CS-Exec-Calendar создаются в классе сообщений Calendar. Параметры управляемого содержимого применяются к стандартной папке «Календарь». Сохранение включено, и элементы перемещаются в папку удаленных элементов через 180 дней.

Скопировать код
New-ManagedContentSettings -Name CS-Exec-Calendar -FolderName Exec-Calendar -MessageClass Calendar -RetentionEnabled $true -RetentionAction MoveToDeletedItems -AgeLimitForRetention 180