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


Set-ManagedContentSettings

 

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

Последнее изменение раздела: 2007-10-08

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

Синтаксис

Set-ManagedContentSettings -Identity <ELCContentSettingsIdParameter> [-AddressForJournaling <RecipientIdParameter>] [-AgeLimitForRetention <Nullable>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-JournalingEnabled <$true | $false>] [-LabelForJournaling <String>] [-MessageFormatForJournaling <UseMsg | UseTnef>] [-MoveToDestinationFolder <ELCFolderIdParameter>] [-Name <String>] [-RetentionAction <MoveToDeletedItems | MoveToFolder | DeleteAndAllowRecovery | PermanentlyDelete | MarkAsPastRetentionLimit>] [-RetentionEnabled <$true | $false>] [-TriggerForRetention <WhenDelivered | WhenMoved>] [-WhatIf [<SwitchParameter>]]

Set-ManagedContentSettings [-AddressForJournaling <RecipientIdParameter>] [-AgeLimitForRetention <Nullable>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Instance <ElcContentSettings>] [-JournalingEnabled <$true | $false>] [-LabelForJournaling <String>] [-MessageFormatForJournaling <UseMsg | UseTnef>] [-MoveToDestinationFolder <ELCFolderIdParameter>] [-Name <String>] [-RetentionAction <MoveToDeletedItems | MoveToFolder | DeleteAndAllowRecovery | PermanentlyDelete | MarkAsPastRetentionLimit>] [-RetentionEnabled <$true | $false>] [-TriggerForRetention <WhenDelivered | WhenMoved>] [-WhatIf [<SwitchParameter>]]

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

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

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

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

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

noteПримечание.
Хотя командлет New-ManagedContentSettings имеет параметр MessageClass, у команды Set-ManagedContentSettings он отсутствует. Если требуется изменить тип сообщений, к которому применяются параметры содержимого, необходимо удалить и повторно создать параметры содержимого. Дополнительные сведения о параметре MessageClass см. в разделе New-ManagedContentSettings.

Параметры

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

Identity

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

Microsoft.Exchange.Configuration.Tasks.ELCContentSettingsIdParameter

Параметр Identity определяет имя, различающееся имя или идентификатор GUID политики почтовых ящиков управляемых папок.

AddressForJournaling

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

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter

С помощью параметра AddressForJournaling можно указать адрес хранилища, которое будет являться объектом операций ведения журналов.

AgeLimitForRetention

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

System.Nullable

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

Confirm

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

System.Management.Automation.SwitchParameter

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

DomainController

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

Microsoft.Exchange.Data.Fqdn

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

Instance

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

Microsoft.Exchange.Data.Directory.SystemConfiguration.ElcContentSettings

Параметр Instance указывает идентификатор параметров управляемого содержимого.

JournalingEnabled

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

System.Boolean

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

LabelForJournaling

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

System.String

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

MessageFormatForJournaling

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

Microsoft.Exchange.Data.Directory.SystemConfiguration.JournalingFormat

С помощью параметра MessageFormatForJournaling можно разрешить администратору указывать, следует ли вести журнал для определенного элемента в формате Microsoft Outlook MSG или в обычном формате Outlook MAPI.

MoveToDestinationFolder

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

Microsoft.Exchange.Configuration.Tasks.ELCFolderIdParameter

С помощью параметра MoveToDestinationFolder можно указать имя целевой папки для действий сохранения.

Name

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

System.String

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

RetentionAction

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

Microsoft.Exchange.Data.Directory.SystemConfiguration.RetentionActionType

С помощью параметра RetentionAction можно указать одно из следующих действий:

  • пометить как прошедший период хранения;

  • переместить в особую управляемую папку;

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

  • удалить и разрешить восстановление;

  • удалить окончательно.

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

RetentionEnabled

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

System.Boolean

С помощью параметра RetentionEnabled со значением, равным $true, можно разрешить хранение.

TriggerForRetention

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

Microsoft.Exchange.Data.Directory.SystemConfiguration.RetentionDateType

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

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

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

Ошибки

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

Исключения

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

Пример

В этом примере команда Set-ManagedContentSettings используется для определения адреса хранилища, которое будет объектом операций ведения журнала.

Set-ManagedContentSettings -Identity MyManagedContentSettings -AddressForJournaling MySmtpAddress@contoso.com