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>]
Description
若要在安全性與合規性 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： (SharePointLocation 參數) (ExchangeLocation 參數) 或 SharePoint 網站 (，從指定的信箱中移除指定的 holdId 參數) 。
參數屬性
| 類型: | HoldRemovalActionType |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Confirm
適用：安全性 & 合規性
Confirm 參數會指定要顯示或隱藏確認提示。 這個參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續作業。
- 破壞性的 Cmdlet (如 Remove-* cmdlets) 有內建暫停，它會先強迫您確認命令才會繼續作業。 對於這些 Cmdlet，您可以使用以下確切語法來略過確認提示：
-Confirm:$false。 - 其他大部分的 Cmdlet (如 New-* 和 Set-* cmdlets) 則沒有內建暫停。 在使用這些 Cmdlet 時，指定不含任何值的 Confirm 參數會引入強迫您認可命令後才繼續作業的暫停。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | cf |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ExchangeLocation
適用：安全性 & 合規性
ExchangeLocation 參數會指定信箱的電子郵件位址，其中包含要檢視或移除的保留。
當您使用 Action 參數的 GetHolds 或 RemoveHold 值時，需要此參數。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Force
適用：安全性 & 合規性
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，其中包含要檢視或移除的保留。
當您使用 Action 參數的 GetHolds 或 RemoveHold 值時，需要此參數。
參數屬性
| 類型: | 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。