使用PowerShell执行合规搜索清除操作时遇-Purge参数不可用问题

DevOps 小满

2026-5-19

解决合规搜索-Purge参数不可用的问题

哥们儿，我之前处理合规搜索清除操作时也踩过这个一模一样的坑！别着急，咱们从几个关键方向逐一排查：

先确认权限是否足够
执行Purge操作可不是光有合规搜索权限就行，必须得拥有Compliance Search Purge角色权限。你可以登录合规管理中心，进入「权限」->「合规中心角色」找到对应角色组，检查自己是否在其中。要是没添加，先让管理员把你加入该角色组，之后重新登录PowerShell会话再试试。
检查合规搜索的状态与结果
Purge参数仅对已完成且检索到内容的搜索生效。先运行这条命令确认状态：
```
Get-ComplianceSearch -Identity "你的搜索名称"
```
查看输出里的Status是否为Completed，以及ItemsRetrieved是否大于0。如果搜索还在Running状态，或者根本没找到任何内容，那-Purge肯定无法使用，得等搜索完成或调整搜索条件确保能命中内容。
核对命令格式是否正确
很多人栽在参数搭配上！Purge参数必须和-PurgeType一起使用，不能单独写-Purge。正确的命令格式如下：
```
# 软删除（内容可恢复）
New-ComplianceSearchAction -SearchName "你的搜索名称" -Purge -PurgeType SoftDelete

# 硬删除（内容不可恢复，需额外权限）
New-ComplianceSearchAction -SearchName "你的搜索名称" -Purge -PurgeType HardDelete
```
参数顺序其实影响不大，但必须保证-Purge和-PurgeType同时存在，拼写也不能出错。
更新PowerShell模块版本
要是你用的是旧版本的Exchange Online PowerShell模块，可能存在参数不支持的情况。先尝试更新模块：
```
Update-Module -Name ExchangeOnlineManagement
```
更新完成后断开现有会话，重新连接再执行Purge命令。