Командлет 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>]] |
Параметры
Параметр | Обязательный | Тип | Описание | ||||
---|---|---|---|---|---|---|---|
FolderName |
Обязательный |
Microsoft.Exchange.Configuration.Tasks.ELCFolderIdParameter |
Параметр FolderName определяет имя или значение GUID управляемой папки, к которой применяются параметры управляемого содержимого. |
||||
MessageClass |
Обязательный |
System.String |
Параметр MessageClass определяет тип сообщений, к которому применяются любые параметры конфигурации управления сроком жизни и журналирования из числа этих параметров содержимого. Значение параметра может быть известным типом сообщений, таким как элементы календаря, определенным классом сообщений, например IPM.NOTE.SMIME, или пользовательским классом сообщений. Известными типами сообщений являются следующие:
Допустимыми значениями параметра для пользовательских классов сообщений являются:
|
||||
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 используемой учетной записи необходимо делегировать следующую роль:
- роль администратора организации Exchange.
Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.
Типы входных данных
Типы возвращаемых данных
Ошибки
Ошибка | Описание |
---|---|
|
Исключения
Исключения | Описание |
---|---|
|
Пример
В первом примере команда 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" |