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


Get-RetentionCompliancePolicy

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

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

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

Синтаксис

Get-RetentionCompliancePolicy
   [[-Identity] <PolicyIdParameter>]
   [-DistributionDetail]
   [-ErrorPolicyOnly]
   [-ExcludeTeamsPolicy]
   [-IncludeTestModeResults]
   [-PriorityCleanup]
   [-RetentionRuleTypes]
   [-TeamsPolicyOnly]
   [<CommonParameters>]

Описание

Ниже описаны свойства, которые отображаются по умолчанию.

  • Name. Уникальное имя политики.
  • Рабочая нагрузка. На данный момент она будет отображать все рабочие нагрузки (Exchange, SharePoint, OneDriveForBusiness, Skype, ModernGroup) и не будет отображать фактическую рабочую нагрузку, к которой применяется политика.
  • Enabled. Значение True означает, что политика включена.
  • Режим: текущий режим работы политики. Возможные значения: Test (содержимое тестируется, но правила не применяются), AuditAndNotify (если содержимое соответствует условиям, заданным политикой, правило не применяется, но отправляются сообщения электронной почты с уведомлениями) или Принудительно (все аспекты политики включены и применяются).

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

Примеры

Пример 1

Get-RetentionCompliancePolicy

Этот пример кода отображает сводные сведения обо всех политиках хранения в организации.

Пример 2

Get-RetentionCompliancePolicy -Identity "Regulation 123 Compliance" -DistributionDetail | Format-List

В этом примере отображаются подробные сведения о политике с именем Regulation 123 Compliance, в том числе точные значения свойств DistributionStatus и *Location.

Параметры

-DistributionDetail

Параметр DistributionDetail возвращает подробные сведения о распространении политик в свойстве DistributionResults. С этим параметром не нужно указывать значение.

Если не использовать этот параметр, значения DistributionStatus и *Location будут неточными.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False
Применяется к:Security & Compliance

-ErrorPolicyOnly

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

Тип:SwitchParameter
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False
Применяется к:Security & Compliance

-ExcludeTeamsPolicy

Параметр ExcludeTeamsPolicy указывает, следует ли исключать политики Teams из результатов. С этим параметром не нужно указывать значение.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False
Применяется к:Security & Compliance

-Identity

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

  • имя;
  • различающееся имя (DN);
  • GUID
Тип:PolicyIdParameter
Position:1
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False
Применяется к:Security & Compliance

-IncludeTestModeResults

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

Дополнительные сведения о режиме моделирования см. в разделе Сведения о режиме имитации.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False
Применяется к:Security & Compliance

-PriorityCleanup

{{ Fill PriorityCleanup Description }}

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False
Применяется к:Security & Compliance

-RetentionRuleTypes

Параметр RetentionRuleTypes указывает, следует ли возвращать значение свойств RetentionRuleTypes и HasRules в результатах. С этим параметром не нужно указывать значение.

Чтобы отобразилось свойство RetentionRuleTypes, нужно передать команду в командлет форматирования. Например, Get-RetentionCompliancePolicy -RetentionRuleTypes | Format-Table -Auto Name,RetentionRuleTypes. Если параметр RetentionRuleTypes не используется, значения RetentionRuleTypes будут пустыми, а HasRules — False.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False
Применяется к:Security & Compliance

-TeamsPolicyOnly

Параметр TeamsPolicyOnly указывает, следует ли отображать в результатах только политики Teams. С этим параметром не нужно указывать значение.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False
Применяется к:Security & Compliance