Поделиться через


Командлет New-ManagedContentSettings (окончательная первоначальная версия)

 

Применимо к: Exchange Server 2007

Последнее изменение раздела: 2007-11-01

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

Синтаксис

New-ManagedContentSettings -Name <String> -FolderName <ELCFolderIdParameter> -MessageClass <String> [-AddressForJournaling <RecipientIdParameter>] [-AgeLimitForRetention <Nullable>] [-DomainController <Fqdn>] [-JournalingEnabled <$true | $false>] [-LabelForJournaling <String>] [-MessageFormatForJournaling <UseMsg | UseTnef>] [-MoveToDestinationFolder <ELCFolderIdParameter>] [-RetentionAction <MoveToDeletedItems | MoveToFolder | DeleteAndAllowRecovery | PermanentlyDelete | MarkAsPastRetentionLimit>] [-RetentionEnabled <$true | $false>] [-TemplateInstance <PSObject>] [-TriggerForRetention <WhenDelivered | WhenMoved>]

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

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

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

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

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

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

  • роль администратора организации Exchange.

Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.

Параметры

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

FolderName

Обязательность

Microsoft.Exchange.Configuration.Tasks.ELCFolderIdParameter

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

MessageClass

Обязательность

System.String

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

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

  • Все содержимое почтовых ящиков

  • Элементы календаря

  • контакты;

  • Документы

  • Факсы

  • элементы журнала;

  • Приглашения на собрание, ответы и отмены

  • Notes

  • Почта

  • Элементы RSS

  • Задачи

  • Голосовая почта

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

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

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

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

    Примеры:

    • IPM.NOTE* (IPM.NOTE и все подклассы).

    • IPM.NOTE* (все подклассы IPM.NOTE, но не IPM.NOTE).

    • Значения *.NOTE и IPM.*.NOTE недопустимы.

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

Имя

Обязательность

System.String

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

AddressForJournaling

Дополнительно

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter

Параметр AddressForJournaling определяет адрес репозитория, который будет назначением операции журналирования. Если этот параметр отсутствует, а параметр JournalingEnabled установлен равным $true, возвращается ошибка.

AgeLimitForRetention

Дополнительно

System.Nullable

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

DomainController

Дополнительно

Microsoft.Exchange.Data.Fqdn

Чтобы указать полное доменное имя контроллера домена, записывающего это изменение конфигурации в службу каталогов Active Directory, включите в команду параметр DomainController.

JournalingEnabled

Дополнительно

System.Boolean

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

LabelForJournaling

Дополнительно

System.String

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

MessageFormatForJournaling

Дополнительно

Microsoft.Exchange.Data.Directory.SystemConfiguration.JournalingFormat

Параметр MessageFormatForJournaling разрешает администратору определить, что для элемента будет вестись журнал в формате Microsoft Outlook (MSG) или в традиционном формате Outlook MAPI.

MoveToDestinationFolder

Дополнительно

Microsoft.Exchange.Configuration.Tasks.ELCFolderIdParameter

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

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

RetentionAction

Дополнительно

Microsoft.Exchange.Data.Directory.SystemConfiguration.RetentionActionType

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

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

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

  • переместить в папку «Удаленные»;

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

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

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

RetentionEnabled

Дополнительно

System.Boolean

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

TemplateInstance

Дополнительно

System.Management.Automation.PSObject

Когда в качестве значения параметра TemplateInstance указывается существующий объект, команда использует конфигурацию этого объекта для создания точной копии объекта на локальном или целевом сервере.

TriggerForRetention

Дополнительно

Microsoft.Exchange.Data.Directory.SystemConfiguration.RetentionDateType

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

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

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

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

Ошибки

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

  

Исключения

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

  

Пример

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

Во втором примере заглушки архивного содержимого в почтовых ящиках пользователей (которые имеют пользовательский класс сообщений IPM.Note.Archive.Shortcut) удаляются с помощью параметра управляемого содержимого RemoveArchiveStubs.

Дополнительные сведения о пользовательских классах сообщений см. в описании параметра «MessageClass» в этом разделе, а также в разделе «О классах сообщений» в статье 241235 базы знаний Майкрософт, Глобальное изменение форм, используемых в Outlook по умолчанию, с помощью средства Forms Administrator (на английском языке).

New-ManagedContentSettings -FolderName Calendar -MessageClass Calendar -Name MyCalendarContentSettings -RetentionEnabled $true -RetentionAction MoveToDeletedItems -AgeLimitForRetention "30"
New-ManagedContentSettings -FolderName Inbox -MessageClass IPM.Note.Archive.Shortcut -Name RemoveArchiveStubs -RetentionEnabled $true -RetentionAction MoveToDeletedItems -AgeLimitForRetention "1"