用于保留策略和保留标签的 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 BusinessExchange 公用文件夹Teams 聊天邮件Teams 频道邮件时,请使用下表中的 cmdlet。

当位置用于 Teams 专用频道消息、Viva Engage用户消息或Viva Engage社区消息时,请勿使用这些 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 聊天消息

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 创建和发布保留标签