用于保留策略和保留标签的 PowerShell cmdlet
使用以下部分来确定可用于大规模配置、自动化脚本或高级配置方案所需的保留策略和保留标签的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。 这些位置具有 下一节中标识的替代 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 创建和发布保留标签。