用于保留策略和保留标签的 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 聊天和 Copilot 交互或 Teams 频道消息时，请使用下表中的 cmdlet。

当位置适用于 Teams 专用频道消息、Viva Engage用户消息、Viva Engage社区消息、Teams 聊天 (没有 Copilot 交互) 、Microsoft Copilot体验或企业 AI 应用时，请勿使用这些 cmdlet。 这些位置具有 下一节中标识的替代 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 聊天和 Copilot 交互 Teams 通道消息
Get-RetentionComplianceRule New-RetentionComplianceRule Set-RetentionComplianceRule Remove-RetentionComplianceRule	查看、创建、配置和删除保留策略和保留标签) (规则的设置	Exchange 电子邮件 SharePoint 网站 (或 SharePoint 经典版和通信网站) OneDrive 账户 Microsoft 365 个组邮箱 & 网站 Skype for Business Exchange 公用文件夹 Teams 聊天和 Copilot 交互 Teams 通道消息

其他位置的保留 cmdlet

当位置适用于 Teams 专用频道消息、Viva Engage用户消息、Viva Engage社区消息、Teams 聊天、Microsoft Copilot体验或企业 AI 应用时，请使用以下 cmdlet。

注意

Teams 聊天、Microsoft Copilot体验和企业 AI 应用的支持正在推出，目前可能尚不适用于 Purview 租户。

当位置用于 Teams 聊天和 Copilot 交互、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社区消息 Teams 聊天 Microsoft Copilot体验 企业 AI 应用
Get-AppRetentionComplianceRule New-AppRetentionComplianceRule Remove-AppRetentionComplianceRule Set-AppRetentionComplianceRule	查看、创建、配置、删除保留策略 (规则) 设置	Teams 专用频道消息 Viva Engage用户消息 Viva Engage社区消息 Teams 聊天 Microsoft Copilot体验 企业 AI 应用

配置指南

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

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