Set-RetentionComplianceRule

  • Ссылка
Модуль:
ExchangePowerShell
Применяется к:
Security & Compliance

Этот командлет доступен только в PowerShell для соответствия требованиям безопасности & . Дополнительные сведения см. в разделе Соответствие требованиям безопасности & PowerShell.

Используйте командлет Set-RetentionComplianceRule для изменения существующих правил хранения в Портал соответствия требованиям Microsoft Purview.

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

Синтаксис

Set-RetentionComplianceRule
   [-Identity] <ComplianceRuleIdParameter>
   [-ApplyComplianceTag <String>]
   [-Comment <String>]
   [-Confirm]
   [-ContentContainsSensitiveInformation <PswsHashtable[]>]
   [-ContentDateFrom <DateTime>]
   [-ContentDateTo <DateTime>]
   [-ContentMatchQuery <String>]
   [-ExcludedItemClasses <MultiValuedProperty>]
   [-ExpirationDateOption <String>]
   [-RetentionComplianceAction <String>]
   [-RetentionDuration <Unlimited>]
   [-RetentionDurationDisplayHint <HoldDurationHint>]
   [-WhatIf]
   [<CommonParameters>]

Описание

Чтобы использовать этот командлет в PowerShell для соответствия требованиям безопасности & , необходимо назначить разрешения. Дополнительные сведения см. в статье Разрешения на портале соответствия требованиям Microsoft Purview.

Примеры

Пример 1

Set-RetentionComplianceRule -Identity "Internal Company Rule" -RetentionDuration 180 -RetentionDurationDisplayHint Days

Этот пример кода изменяет срок хранения, указанный в правиле хранения Internal Company Rule.

Параметры

-ApplyComplianceTag

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

Для просмотра и создания меток используются командлеты Get-ComplianceTag и New-ComplianceTag.

Этот параметр невозможно использовать вместе с параметром Name или PublishComplianceTag.

Этот параметр нельзя использовать для правил хранения Teams.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-Comment

Параметр Comment указывает необязательный комментарий. Если вы указываете значение, содержащее пробелы, заключите его в кавычки ("), например:" Это примечание администратора ".

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-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:Security & Compliance

-ContentContainsSensitiveInformation

Параметр ContentContainsSensitiveInformation задает условие для правила, основанного на совпадении типов конфиденциальной информации в содержимом. Правило применяется к содержимому, которое содержит указанный тип конфиденциальной информации.

Этот параметр использует базовый синтаксис @(@{Name="SensitiveInformationType1";[minCount="Value"],@{Name="SensitiveInformationType2";[minCount="Value"],...). Например, @(@{Name="U.S. Social Security Number (SSN)"; minCount="2"},@{Name="Credit Card Number"}).

Используйте командлет Get-DLPSensitiveInformationType, чтобы получить список типов конфиденциальной информации для вашей организации. Дополнительные сведения о типах конфиденциальной информации см. в статье Поиск типов конфиденциальной информации в Exchange.

Этот параметр нельзя использовать для правил хранения Teams.

Type:PswsHashtable[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ContentDateFrom

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

Используйте формат короткой даты, определенный в настройках региональных параметров на компьютере, на котором выполняется команда. Например, если компьютер настроен на использование формата короткой даты мм / дд / гггг, введите 09/01/2018, чтобы указать 1 сентября 2018 года. Допускается ввод только даты или даты и времени. Если вы вводите дату и время дня, заключите это значение в кавычки ("), например," 09/01/2018 5:00 PM ".

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ContentDateTo

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

Используйте формат короткой даты, определенный в настройках региональных параметров на компьютере, на котором выполняется команда. Например, если компьютер настроен на использование формата короткой даты мм / дд / гггг, введите 09/01/2018, чтобы указать 1 сентября 2018 года. Допускается ввод только даты или даты и времени. Если вы вводите дату и время дня, заключите это значение в кавычки ("), например," 09/01/2018 5:00 PM ".

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ContentMatchQuery

Параметр ContentMatchQuery указывает фильтр поиска контента.

Этот параметр использует строку текстового поиска или запрос, созданный с использованием языка запросов по ключевым словам (KQL). Дополнительные сведения см. в статье Справочник по синтаксису языка запросов ключевых слов (KQL) и Запросы ключевых слов и условия поиска для обнаружения электронных данных.

Этот параметр нельзя использовать для правил хранения Teams.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ExcludedItemClasses

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

  • IPM. Примечание. Майкрософт. Разговор
  • IPM. Примечание. Майкрософт. Conversation.Voice
  • IPM. Примечание. Майкрософт. Пропустил
  • IPM. Примечание. Майкрософт. Missed.Voice
  • IPM. Примечание. Майкрософт. Голосовую почту
  • IPM. Примечание. Майкрософт.VoiceMessage.UA
  • IPM. Примечание. Майкрософт. Voicemail.UM
  • IPM. Примечание. Майкрософт.Voicemail.UM.CA

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

Можно указать несколько значений класса элементов с помощью следующего синтаксиса: "Value1","Value2",..."ValueN".

Этот параметр нельзя использовать для правил хранения Teams.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ExpirationDateOption

Параметр ExpirationDateOption указывает, вычисляется ли дата окончания срока действия с даты создания контента или даты последнего изменения. Допустимые значения:

  • CreationAgeInDays
  • ModificationAgeInDays

Этот параметр нельзя использовать для правил хранения Teams.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-Identity

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

  • имя;
  • различающееся имя (DN);
  • GUID
Type:ComplianceRuleIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Security & Compliance

-RetentionComplianceAction

Параметр RetentionComplianceAction указывает действие хранения для правила. Допустимые значения:

  • Удалить
  • Оставить
  • KeepAndDelete
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-RetentionDuration

Параметр RetentionDuration указывает срок хранения для правила хранения. Допустимые значения:

  • Целое число: длительность удержания в днях.
  • Неограниченно: содержимое хранится неограниченное время.
Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-RetentionDurationDisplayHint

Параметр RetentionDurationDisplayHint указывает единицы измерения, используемые для отображения длительности хранения в Портал соответствия требованиям Microsoft Purview. Допустимые значения — Days, Months или Years.

  • Дни
  • Месяцы
  • Годы

Например, если для этого параметра задано значение Years, а параметру RetentionDuration присвоено значение 365, Портал соответствия требованиям Microsoft Purview будет отображаться в качестве длительности хранения содержимого в течение 1 года.

Этот параметр нельзя использовать для правил хранения Teams.

Type:HoldDurationHint
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-WhatIf

Параметр WhatIf не работает в PowerShell для соответствия требованиям безопасности & .

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance