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