Применимо к: Exchange Server 2010 SP1
Последнее изменение раздела: 2011-04-24
Используйте командлет New-ManagedContentSettings для создания параметров управляемого содержимого управляемых папок.
Синтаксис
New-ManagedContentSettings -Name <String>
-FolderName <ELCFolderIdParameter> -MessageClass
<String> [-AddressForJournaling <RecipientIdParameter>]
[-AgeLimitForRetention <EnhancedTimeSpan>] [-Confirm
[<SwitchParameter>]] [-DomainController <Fqdn>]
[-JournalingEnabled <$true | $false>] [-LabelForJournaling
<String>] [-MessageFormatForJournaling <UseMsg |
UseTnef>] [-MoveToDestinationFolder
<ELCFolderIdParameter>] [-Organization
<OrganizationIdParameter>] [-RetentionAction
<MoveToDeletedItems | MoveToFolder | DeleteAndAllowRecovery |
PermanentlyDelete | MarkAsPastRetentionLimit | MoveToArchive>]
[-RetentionEnabled <$true | $false>] [-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 указывает получателя, для которого ведется журнал, которому отправляются сообщения, заносимые в журнал.
|
||||||
AgeLimitForRetention |
Необязательный |
Microsoft.Exchange.Data.EnhancedTimeSpan |
Параметр AgeLimitForRetention определяет возраст, при
котором для элемента включается сохранение. Максимальное время
хранения соответствует числу дней от даты доставки элемента или его
создания, если он не был доставлен. Если этот параметр не указан, а
значение параметра RetentionEnabled равно
|
||||||
Confirm |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр Confirm приостанавливает обработку и требует указать действие, которое будет выполнено командой перед ее возобновлением. Указывать значение параметра Confirm не обязательно. |
||||||
DomainController |
Необязательный |
Microsoft.Exchange.Data.Fqdn |
Параметр DomainController указывает имя FQDN контроллера домена, который записывает это изменение конфигурации в Служба каталогов Active Directory. |
||||||
JournalingEnabled |
Необязательный |
System.Boolean |
Параметр JournalingEnabled с установленным значением
|
||||||
LabelForJournaling |
Необязательный |
System.String |
Параметр LabelForJournaling указывает метку, которая связана с элементом. Эта метка используется хранилищем назначения для определения содержимого элемента и применения соответствующей политики. |
||||||
MessageFormatForJournaling |
Необязательный |
Microsoft.Exchange.Data.Directory.SystemConfiguration.JournalingFormat |
Параметр MessageFormatForJournaling указывает формат сообщения, в котором элемент должен вноситься в журнал. Можно использовать следующие значения:
|
||||||
MoveToDestinationFolder |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.ELCFolderIdParameter |
Параметр MoveToDestinationFolder указывает папку назначения для операции перемещения. Папка назначения должна быть существуемой настраиваемой
управляемой папкой. Если она не существует, возвращается ошибка.
Если параметр MoveToDestinationFolder не указан, а значение
параметра RetentionAction равно |
||||||
Organization |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.OrganizationIdParameter |
Параметр Organization зарезервирован для внутреннего использования корпорацией Майкрософт. |
||||||
RetentionAction |
Необязательный |
Microsoft.Exchange.Data.Directory.SystemConfiguration.RetentionActionType |
Параметр RetentionAction определяет одно из следующих действий:
Если этот параметр не указан, а значение параметра
RetentionEnabled равно |
||||||
RetentionEnabled |
Необязательный |
System.Boolean |
Параметр RetentionEnabled указывает, что хранение
включено, если равен |
||||||
TriggerForRetention |
Необязательный |
Microsoft.Exchange.Data.Directory.SystemConfiguration.RetentionDateType |
Параметр TriggerForRetention указывает дату, которая считается начальной датой периода хранения. Срок хранения элементов завершается через определенное количество дней после того, как элемент был доставлен или перемещен в папку. Допустимыми являются следующие значения:
Это значение соответствует биту 0x4 атрибута
msExchELCFlags в Служба каталогов Active Directory. Значение
равно Если этот параметр не указан, а значение параметра
RetentionEnabled равно |
||||||
WhatIf |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр WhatIf заставляет команду имитировать действия, которые она будет выполнять с объектом. С помощью параметра WhatIf можно просмотреть изменения, которые могут произойти, не применяя эти изменения. Указывать значение параметра WhatIf не обязательно. |
Подробное описание
Параметры управляемого содержимого — это параметры, связанные с управляемыми папками для контроля над продолжительностью хранения элементов в почтовых ящиках пользователей. Управление продолжительностью хранения осуществляется следующими способами.
- С помощью управления хранением содержимого и удаления ненужного
содержимого.
- С помощью автоматического журналирования важного
содержимого в отдельную папку хранилища вне почтового ящика.
Дополнительные сведения о параметрах управляемого содержимого см. в разделе Управление записями сообщений.
Для запуска этого командлета необходимы соответствующие разрешения. В этом разделе перечислены все параметры командлета, однако некоторые из них могут быть недоступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях см. в разделе Запись «Управление записями сообщений» в разделе Политика обмена сообщениями и соответствие требованиям.
Типы входных данных
Типы возвращаемых данных
Ошибки
Ошибка | Описание |
---|---|
|
|
Исключения
Исключения | Описание |
---|---|
|
|
Примеры
ПРИМЕР 1
В этом примере создаются параметры управляемого содержимого для управляемой папки по умолчанию Exec-DeletedItems. При добавлении элементов папки «Удаленные» в применяемую к почтовому ящику политику почтовых ящиков управляемых папок данные элементы будут удалены через 30 дней после доставки.
Скопировать код | |
---|---|
New-ManagedContentSettings -Name "CS-Exec-DeletedItems" -FolderName "Exec-DeletedItems" -MessageClass * -RetentionEnabled $true -RetentionAction DeleteAndAllowRecovery -AgeLimitForRetention 30.00:00:00 -TriggerForRetention WhenDelivered |
ПРИМЕР 2
В этом примере параметры управляемого содержимого CS-Exec-Calendar создаются в классе сообщений Calendar. Параметры управляемого содержимого применяются к стандартной папке «Календарь». Сохранение включено, и элементы перемещаются в папку удаленных элементов через 180 дней.
Скопировать код | |
---|---|
New-ManagedContentSettings -Name CS-Exec-Calendar -FolderName Exec-Calendar -MessageClass Calendar -RetentionEnabled $true -RetentionAction MoveToDeletedItems -AgeLimitForRetention 180 |