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。