Get-AppRetentionCompliancePolicy

此 cmdlet 仅在安全与合规中心 PowerShell 内可用。 有关更多信息,请参见 安全与合规中心 PowerShell

使用 Get-AppRetentionCompliancePolicy 查看应用保留合规性策略。 应用保留 & 标记策略面向范围和管理策略的新方法。

有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法

语法

Default (默认值)

Get-AppRetentionCompliancePolicy
    [[-Identity] <PolicyIdParameter>]
    [-DistributionDetail]
    [-ErrorPolicyOnly]
    [-RetentionRuleTypes]
    [<CommonParameters>]

说明

*-AppRetentionCompliance* cmdlet 用于具有自适应策略范围的策略以及涵盖 Teams 专用频道、Viva Engage聊天和Viva Engage社区消息的所有静态策略。 最终,你将将这些 cmdlet 用于大多数保留位置和策略类型。 *-RetentionCompliance* cmdlet 将继续主要支持 Exchange 和 SharePoint 位置。 对于使用 *-AppRetentionCompliance* cmdlet 创建的策略,只能为所有包含的工作负荷设置包含或排除的范围列表,这意味着可能需要为每个工作负荷创建一个策略。

要在安全与合规中心 PowerShell 中使用此 cmdlet,必须分配权限。 有关详细信息,请参阅 Microsoft Purview 合规门户中的权限

示例

示例 1

Get-AppRetentionCompliancePolicy | Format-Table Name,GUID

此示例返回所有应用保留合规性策略的摘要列表。

示例 1

Get-AppRetentionCompliancePolicy -Identity "Contoso Viva Engage"

此示例返回名为 Contoso Viva Engage 的应用保留合规性策略的详细信息。

参数

-DistributionDetail

适用:安全 & 合规性

DistributionDetail 开关返回 DistributionResults 属性中的详细策略分发信息。 不必为此开关指定值。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ErrorPolicyOnly

适用:安全 & 合规性

{{ Fill ErrorPolicyOnly Description }}

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Identity

适用:安全 & 合规性

Identity 参数指定要查看的应用保留符合性策略。 可以使用任何能够唯一标识该策略的值。 例如:

  • 名称
  • 可分辨名称 (DN)
  • GUID

参数属性

类型:PolicyIdParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:0
必需:False
来自管道的值:True
来自管道的值(按属性名称):True
来自剩余参数的值:False

-RetentionRuleTypes

适用:安全 & 合规性

RetentionRuleTypes 开关指定是否返回结果中的 RetentionRuleTypes 属性的值。 不必为此开关指定值。

若要查看 RetentionRuleTypes 属性,需要通过管道将命令传递给格式设置 cmdlet。 例如,Get-AppRetentionCompliancePolicy -RetentionRuleTypes | Format-Table -Auto Name,RetentionRuleTypes。 如果不使用 RetentionRuleTypes 开关,则该值显示为空白。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters