Get-RetentionCompliancePolicy
此 cmdlet 仅在安全性 & 合规性 PowerShell 中可用。 有关详细信息,请参阅 安全性 & 合规性 PowerShell。
使用Get-RetentionCompliancePolicy查看Microsoft Purview 合规门户中的现有保留策略。
有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法。
语法
Get-RetentionCompliancePolicy
[[-Identity] <PolicyIdParameter>]
[-DistributionDetail]
[-ErrorPolicyOnly]
[-ExcludeTeamsPolicy]
[-IncludeTestModeResults]
[-RetentionRuleTypes]
[-TeamsPolicyOnly]
[<CommonParameters>]
说明
此列表描述默认显示的属性。
- 名称:策略的唯一名称。
- 工作负载:目前,它将显示 (Exchange、SharePoint、OneDriveForBusiness、Skype、ModernGroup) 的所有工作负载,并且不会显示应用策略的实际工作负载。
- Enabled:值 True 表示已启用策略。
- 模式:策略的当前操作模式。 可能的值是测试内容 (测试,但不) 强制实施任何规则,当内容与策略指定的条件匹配时,AuditAndNotify (,不强制实施规则,但发送通知电子邮件) 或强制 () 启用和强制实施策略的所有方面。
若要在安全性 & 合规性 PowerShell 中使用此 cmdlet,需要分配权限。 有关详细信息,请参阅 Microsoft Purview 合规门户中的权限。
示例
示例 1
Get-RetentionCompliancePolicy
本示例显示组织中的所有保留策略的摘要信息。
示例 2
Get-RetentionCompliancePolicy -Identity "Regulation 123 Compliance" -DistributionDetail | Format-List
此示例显示名为“法规 123 符合性”的策略的详细信息,包括 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 属性,需要通过管道将命令传递给格式设置 cmdlet。 例如,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 |