New-ManagedContentSettings

  • Ссылка
Модуль:
ExchangePowerShell
Применяется к:
Exchange Server 2010

Этот командлет доступен только в Exchange Server 2010 г.

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

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

New-ManagedContentSettings
   [-Name] <String>
   -FolderName <ELCFolderIdParameter>
   -MessageClass <String>
   [-AddressForJournaling <RecipientIdParameter>]
   [-AgeLimitForRetention <EnhancedTimeSpan>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-JournalingEnabled <Boolean>]
   [-LabelForJournaling <String>]
   [-MessageFormatForJournaling <JournalingFormat>]
   [-MoveToDestinationFolder <ELCFolderIdParameter>]
   [-RetentionAction <RetentionAction>]
   [-RetentionEnabled <Boolean>]
   [-TriggerForRetention <RetentionDateType>]
   [-WhatIf]
   [<CommonParameters>]

Описание

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

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

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

Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.

Примеры

Пример 1

New-ManagedContentSettings -Name "CS-Exec-DeletedItems" -FolderName "Exec-DeletedItems" -MessageClass * -RetentionEnabled $true -RetentionAction DeleteAndAllowRecovery -AgeLimitForRetention 30.00:00:00 -TriggerForRetention WhenDelivered

В этом примере создаются параметры управляемого содержимого для управляемой папки по умолчанию Exec-DeletedItems. При добавлении элементов папки «Удаленные» в применяемую к почтовому ящику политику почтовых ящиков управляемых папок данные элементы будут удалены через 30 дней после доставки.

Пример 2

New-ManagedContentSettings -Name CS-Exec-Calendar -FolderName Exec-Calendar -MessageClass Calendar -RetentionEnabled $true -RetentionAction MoveToDeletedItems -AgeLimitForRetention 180

В этом примере параметры управляемого содержимого CS-Exec-Calendar создаются в классе сообщений Calendar. Параметры управляемого содержимого применяются к стандартной папке «Календарь». Сохранение включено, и элементы перемещаются в папку удаленных элементов через 180 дней.

Параметры

-AddressForJournaling

Параметр AddressForJournaling указывает получателя журнала, куда отправляются сообщения журнала. Вы можете использовать любое значение, однозначно определяющее получателя. Например:

  • Имя
  • Псевдоним
  • различающееся имя (DN);
  • различающееся имя (DN);
  • Каноническое краткое имя
  • GUID

Этот параметр требуется, если для параметра JournalingEnabled установлено значение $true.

Type:RecipientIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-AgeLimitForRetention

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

Type:EnhancedTimeSpan
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-Confirm

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

  • Деструктивные командлеты (например, командлеты Remove-*) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис: -Confirm:$false.
  • Большинство других командлетов (например, командлеты New-* и Set-*) не имеют встроенной приостановки. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-DomainController

Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-FolderName

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

Type:ELCFolderIdParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-JournalingEnabled

Параметр JournalingEnabled с установленным значением $true указывает, что функция ведения журнала включена.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-LabelForJournaling

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-MessageClass

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

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

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

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

  • Определенный класс сообщений (например, IPM.NOTE).
  • Подстановочный знак «звездочка» (*) указывает, что параметры содержимого применяются ко всем классам сообщений.
  • Определенный класс сообщений со звездочкой. Подстановочный знак звездочки должен отображаться в качестве последнего символа в классе сообщений. Например, IPM. ПРИМЕЧАНИЕ* (включает IPM. ПРИМЕЧАНИЕ и все подклассы) или IPM. ПРИМЕЧАНИЕ.* (включает подклассы для IPM. ПРИМЕЧАНИЕ, но не IPM. ПРИМЕЧАНИЕ). *. ПРИМЕЧАНИЕ и IPM.*. ПРИМЕЧАНИЕ— недопустимые значения.

Примечания.

  • При использовании подстановочных знаков эти политики применяются только к тем классам сообщений, у которых нет определенного параметра содержимого. Поэтому значение IPM.NOTE.SMIME переопределяет IPM.NOTE.*.
  • Определенные параметры заменяют общие параметры, например голосовая почта заменяет AllMailboxContent.
Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-MessageFormatForJournaling

Параметр MessageFormatForJournaling указывает формат сообщения, в котором элемент должен вноситься в журнал. Можно использовать следующие значения:

  • UseMsg Outlook .msg format
  • UseTnef Outlook MAPI format
Type:JournalingFormat
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-MoveToDestinationFolder

Параметр MoveToDestinationFolder указывает папку назначения для операции перемещения.

Папка назначения должна быть существуемой настраиваемой управляемой папкой. Если она не существует, возвращается ошибка. Если параметр MoveToDestinationFolder не указан, а значение параметра RetentionAction равно MoveToFolder, то возвращается ошибка.

Type:ELCFolderIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-Name

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

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-RetentionAction

Параметр RetentionAction определяет одно из следующих действий:

  • Установить отметку "Срок хранения истек"
  • Перемещение в настраиваемую управляемую папку
  • Перемещение в папку удаленных элементов
  • Удаление и разрешение восстановления
  • Удалить окончательно

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

Type:RetentionAction
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-RetentionEnabled

Параметр RetentionEnabled указывает, что хранение включено, если равен $true.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-TriggerForRetention

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

Допустимыми являются следующие значения:

  • WhenDelivered
  • WhenMoved

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

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

Type:RetentionDateType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

Входные данные

Input types

Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.

Выходные данные

Output types

Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.