用于保留策略和保留标签的 PowerShell cmdlet

Microsoft 365 安全性与合规性许可指南。

使用以下部分来确定可用于大规模配置、自动化脚本或高级配置方案所需的保留策略和保留标签的main PowerShell cmdlet。 有关 cmdlet 的完整列表，请参阅 PowerShell 文档中 的策略和合规性保留列表 。

使用这些 cmdlet 之前，必须先 连接到安全性 & 符合性 PowerShell。

在以下说明中，保留策略可以引用保留策略 (不) 标签或保留标签策略。 每个策略定义它是静态的还是自适应的，以及应用策略的位置。

使用保留策略时，该策略需要一个规则来完成配置，例如，定义保留设置的规则，例如保留五年，然后删除。

使用保留标签时，这些标签包含保留设置，其策略需要不同的规则：

• 发布的保留标签策略需要一个规则来定义应在应用中显示哪些标签。
• 自动应用保留标签策略需要一个规则来定义要应用的标签以及应用标签的条件。

提示

如果你不是 E5 客户，请使用为期 90 天的 Microsoft Purview 解决方案试用版来探索其他 Purview 功能如何帮助组织管理数据安全性和合规性需求。 立即从Microsoft Purview 合规门户试用中心开始。 了解有关 注册和试用条款的详细信息。

大多数位置的保留 cmdlet

当位置为 Exchange 邮箱、SharePoint 网站或SharePoint 经典和通信网站、OneDrive 帐户、Microsoft 365 组邮箱 & 网站、Skype for Business、Exchange 公用文件夹、Teams 聊天邮件或 Teams 频道消息时，请使用下表中的 cmdlet。

当位置用于 Teams 专用频道消息、Viva Engage用户消息或Viva Engage社区消息时，请勿使用这些 cmdlet。 这些位置具有 [下一节] (#retention-cmdlets-specific-to-teams-private-channels-and-Viva Engage) 中标识的替代 cmdlet。

Cmdlet	说明	适用位置
Enable-ComplianceTagStorage Get-ComplianceTagStorage	创建存储或查看保留标签存储的一次性操作	Exchange 邮箱 SharePoint 网站 (或 SharePoint 经典版和通信网站) OneDrive 账户 Microsoft 365 组邮箱 & 站点
Get-ComplianceTag New-ComplianceTag Remove-ComplianceTag Set-ComplianceTag	查看、创建、删除、配置保留标签	Exchange 邮箱 SharePoint 网站 (或 SharePoint 经典版和通信网站) OneDrive 账户 Microsoft 365 组邮箱 & 站点
Get-RecordReviewNotificationTemplateConfig Set-RecordReviewNotificationTemplateConfig	查看或配置处置评审通知和提醒设置	Exchange 邮箱 SharePoint 网站 (或 SharePoint 经典版和通信网站) OneDrive 账户 Microsoft 365 组邮箱 & 站点
Get-RetentionCompliancePolicy New-RetentionCompliancePolicy Remove-RetentionCompliancePolicy Set-RetentionCompliancePolicy	查看、创建、删除、配置保留策略和保留标签策略	Exchange 电子邮件 SharePoint 网站 (或 SharePoint 经典版和通信网站) OneDrive 账户 Microsoft 365 组邮箱 & 站点 Skype for Business Exchange 公用文件夹 Teams 聊天消息 Teams 通道消息
Get-RetentionComplianceRule New-RetentionComplianceRule Set-RetentionComplianceRule Remove-RetentionComplianceRule	查看、创建、配置和删除保留策略和保留标签) (规则的设置	Exchange 电子邮件 SharePoint 网站 (或 SharePoint 经典版和通信网站) OneDrive 账户 Microsoft 365 组邮箱 & 站点 Skype for Business Exchange 公用文件夹 Teams 聊天消息 Teams 通道消息

特定于 Teams 专用频道和Viva Engage的保留 cmdlet

当位置适用于 Teams 专用频道消息、Viva Engage用户消息或Viva Engage社区消息时，请使用以下 cmdlet。

当 Teams 聊天邮件、Teams 频道邮件、Exchange 电子邮件、SharePoint 网站 (或 SharePoint 经典网站以及通信网站) 、OneDrive 帐户、Microsoft 365 组邮箱 & 网站、Skype for Business或 Exchange 公用文件夹的位置时，请使用上一部分中列出的 cmdlet。

Cmdlet	说明	适用位置
Get-AppRetentionCompliancePolicy New-AppRetentionCompliancePolicy Remove-AppRetentionCompliancePolicy Set-AppRetentionCompliancePolicy	查看、创建、删除和配置保留策略	Teams 专用频道消息 Viva Engage用户消息 Viva Engage社区消息
Get-AppRetentionComplianceRule New-AppRetentionComplianceRule Remove-AppRetentionComplianceRule Set-AppRetentionComplianceRule	查看、创建、配置、删除保留策略 (规则) 设置	Teams 专用频道消息 Viva Engage用户消息 Viva Engage社区消息

配置指南

使用与每个 cmdlet 关联的帮助页获取详细信息和示例。

有关创建和发布保留标签的引导帮助，请参阅 使用 PowerShell 创建和发布保留标签。