Get-RetentionCompliancePolicy

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

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

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

Синтаксис

Get-RetentionCompliancePolicy
   [[-Identity] <PolicyIdParameter>]
   [-DistributionDetail]
   [-ErrorPolicyOnly]
   [-ExcludeTeamsPolicy]
   [-IncludeTestModeResults]
   [-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 будут неточными.

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

-ErrorPolicyOnly

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

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

-ExcludeTeamsPolicy

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

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

-Identity

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

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

-IncludeTestModeResults

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

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

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

-RetentionRuleTypes

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

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

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

-TeamsPolicyOnly

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

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