Поделиться через


New-AppRetentionComplianceRule

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

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

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

Синтаксис

New-AppRetentionComplianceRule
   [-Name] <String>
   -Policy <PolicyIdParameter>
   [-Comment <String>]
   [-Confirm]
   [-ContentMatchQuery <String>]
   [-ExcludedItemClasses <MultiValuedProperty>]
   [-ExpirationDateOption <String>]
   [-RetentionComplianceAction <String>]
   [-RetentionDuration <Unlimited>]
   [-RetentionDurationDisplayHint <HoldDurationHint>]
   [-WhatIf]
   [<CommonParameters>]
New-AppRetentionComplianceRule
   -Policy <PolicyIdParameter>
   [-Confirm]
   [-ContentContainsSensitiveInformation <PswsHashtable[]>]
   [-ContentMatchQuery <String>]
   [-ExpirationDateOption <String>]
   [-MachineLearningModelIDs <MultiValuedProperty>]
   [-RetentionComplianceAction <String>]
   [-WhatIf]
   [<CommonParameters>]

Описание

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

Примеры

Пример 1

New-AppRetentionComplianceRule -Name RetUnlimited -Policy "Regulation 567 Compliance" -RetentionDuration Unlimited

В этом примере создается новое правило хранения с именем RetUnlimited и добавляется в политику хранения с именем Соответствие нормативным требованиям 567.

Параметры

-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.

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

-ContentMatchQuery

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

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

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".

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
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-MachineLearningModelIDs

{{ Fill MachineLearningModelIDs Description }}

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

-Name

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

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

-Policy

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

  • имя;
  • различающееся имя (DN);
  • GUID
Type:PolicyIdParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
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 года.

Type:HoldDurationHint
Accepted values:Days, Months, Years
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