Get-RetentionCompliancePolicy
Этот командлет доступен только в PowerShell безопасности и соответствия требованиям. Дополнительные сведения см. в статье PowerShell безопасности и соответствия требованиям.
Используйте Get-RetentionCompliancePolicy для просмотра существующих политик хранения в Портал соответствия требованиям Microsoft Purview.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Default (По умолчанию)
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 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ErrorPolicyOnly
Применимо: соответствие требованиям & безопасности
Параметр ErrorPolicyOnly указывает, должны ли отображаться только политики с ошибками распределения в результатах. С этим параметром не нужно указывать значение.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ExcludeTeamsPolicy
Применимо: соответствие требованиям & безопасности
Параметр ExcludeTeamsPolicy указывает, следует ли исключать политики Teams из результатов. С этим параметром не нужно указывать значение.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Identity
Применимо: соответствие требованиям & безопасности
Параметр Identity определяет политику хранения, которую требуется просмотреть. Вы можете использовать любое уникальное значение, определяющее политику. Например:
- имя;
- различающееся имя (DN);
- GUID
Внимание! Значение $null или несуществующее значение для параметра Identity возвращает все объекты, как если бы вы выполнили команду Get- без параметра Identity. Убедитесь, что все списки значений для параметра Identity являются точными и не содержат несуществующих $null значений.
Свойства параметров
| Тип: | PolicyIdParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 1 |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-IncludeTestModeResults
Применимо: соответствие требованиям & безопасности
Параметр IncludeTestModeResults указывает, следует ли включать состояние тестового режима в сведения о политике. С этим параметром не нужно указывать значение.
Дополнительные сведения о режиме моделирования см. в разделе Сведения о режиме имитации.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-PriorityCleanup
Применимо: соответствие требованиям & безопасности
{{ Fill PriorityCleanup Description }}
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-RetentionRuleTypes
Применимо: соответствие требованиям & безопасности
Параметр RetentionRuleTypes указывает, следует ли возвращать значение свойств RetentionRuleTypes и HasRules в результатах. С этим параметром не нужно указывать значение.
Чтобы отобразилось свойство RetentionRuleTypes, нужно передать команду в командлет форматирования. Например, Get-RetentionCompliancePolicy -RetentionRuleTypes | Format-Table -Auto Name,RetentionRuleTypes. Если параметр RetentionRuleTypes не используется, значения RetentionRuleTypes будут пустыми, а HasRules — False.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-TeamsPolicyOnly
Применимо: соответствие требованиям & безопасности
Параметр TeamsPolicyOnly указывает, следует ли отображать в результатах только политики Teams. С этим параметром не нужно указывать значение.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.