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 |