Invoke-HoldRemovalAction
此 cmdlet 仅在安全与合规中心 PowerShell 内可用。 有关更多信息，请参见 安全与合规中心 PowerShell。
使用 Invoke-HoldRemovalAction cmdlet 查看和删除邮箱和 SharePoint 网站上的保留。 还可以查看以前使用此 cmdlet 删除的保留。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
Default （默认值）
Invoke-HoldRemovalAction
-Action <HoldRemovalActionType>
[-Confirm]
[-ExchangeLocation <String>]
[-Force]
[-HoldId <String>]
[-SharePointLocation <String>]
[-WhatIf]
[<CommonParameters>]
说明
要在安全与合规中心 PowerShell 中使用此 cmdlet，必须分配权限。 只有合规性管理员可以删除 Exchange 或 Sharepoint 位置的保留。 有关详细信息，请参阅 Microsoft Purview 合规门户中的权限。
示例
示例 1
Invoke-HoldRemovalAction -Action RemoveHold -ExchangeLocation "KittyPetersen@contoso.onmicrosoft.com" -HoldId "UniHecbf89df-74fc-444a-a2dc-c0756c7d3503"
如果策略 UniHecbf89df-74fc-444a-a2dc-c0756c7d3503 不是活动大小写保留策略，则本示例删除 Kitty Petersen 邮箱上的指定保留。
示例 2
Invoke-HoldRemovalAction -Action GetHolds -SharePointLocation "https://contoso.sharepoint.com/sites/finance"
此示例显示指定 SharePoint 网站上的所有保留信息。
示例 3
Invoke-HoldRemovalAction -Action GetHoldRemovals
此示例显示已使用此 cmdlet 完成的所有保留删除作。
参数
-Action
适用：安全 & 合规性
Action 参数指定 cmdlet作的模式。 有效值包含:
- GetHoldRemovals：显示使用此 cmdlet 完成的所有保留删除作。
- GetHolds：显示指定邮箱的保留 (ExchangeLocation 参数) 或 SharePoint 站点 (SharePointLocation 参数) 。
- RemoveHold：从指定的邮箱中删除指定保留 (HoldId 参数) ， (ExchangeLocation 参数) 或 SharePoint 网站 (SharePointLocation 参数) 。
参数属性
| 类型: | HoldRemovalActionType |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-Confirm
适用：安全 & 合规性
Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。
- 破坏性 cmdlet（例如 Remove-* cmdlets）内置有暂停，可强制要求先确认命令，然后再继续操作。 对于这些 cmdlet，您可以使用此确切语法跳过确认提示：
-Confirm:$false。 - 其他大多数 cmdlet（例如 New-* 和 Set-* cmdlet）都没有内置暂停。 对于这些 cmdlet，指定不含值的 Confirm 开关会引入暂停，从而强制要求你先确认命令，然后再继续操作。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ExchangeLocation
适用：安全 & 合规性
ExchangeLocation 参数指定邮箱的电子邮件地址，其中包含要查看或删除的保留。
将值 GetHolds 或 RemoveHold 用于 Action 参数时，此参数是必需的。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Force
适用：安全 & 合规性
强制开关隐藏警告或确认消息。 不必为此开关指定值。
即使策略处于活动状态，也可以使用此开关强制删除保留。 相反，应从大小写保留策略中删除保留。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-HoldId
适用：安全 & 合规性
HoldId 参数指定要查看或删除的保留。
若要查找此参数的有效值，请将此 cmdlet 与 Action 参数值 GetHolds 一起使用，并在输出中查找 HoldId 属性。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-SharePointLocation
适用：安全 & 合规性
SharePointLocation 参数指定包含要查看或删除的保留的 SharePoint 网站的 URL。
将值 GetHolds 或 RemoveHold 用于 Action 参数时，此参数是必需的。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 无线 |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-WhatIf
适用：安全 & 合规性
WhatIf 开关在安全与合规 PowerShell 中不起作用。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 无线 |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。