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


New-ManagedContentSettings

 

Применимо к: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Последнее изменение раздела: 2009-09-16

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

Синтаксис

New-ManagedContentSettings -Name <String> -FolderName <ELCFolderIdParameter> -MessageClass <String> [-AddressForJournaling <RecipientIdParameter>] [-AgeLimitForRetention <Nullable>] [-Confirm [<SwitchParameter>]] [-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>] [-WhatIf [<SwitchParameter>]]

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

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

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

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

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

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

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

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

Параметры

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

FolderName

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

Microsoft.Exchange.Configuration.Tasks.ELCFolderIdParameter

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

MessageClass

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

System.String

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

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

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

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

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

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

    Примеры:

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

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

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

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

  • Для типа сообщений Элементы календаря используйте значение 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*.

Name

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

System.String

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

AddressForJournaling

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

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter

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

AgeLimitForRetention

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

System.Nullable

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

Confirm

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

System.Management.Automation.SwitchParameter

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

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, возвращается ошибка.

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

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

Ошибки

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

  

Исключения

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

  

Пример

В первом примере команда 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"