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