Get-CaseHoldPolicy
此 Cmdlet 僅適用於安全性與合規性 PowerShell。 如需詳細資訊，請參閱 安全性與合規性 PowerShell。
使用 Get-CaseHoldPolicy 查看Microsoft Purview 合規性入口網站中現有的案件暫停政策。 要取得有關暫停如何被套用及受影響地點的相關資訊，你需要包含 DistributionDetail 交換。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
語法
Default (預設值)
Get-CaseHoldPolicy
[[-Identity] <PolicyIdParameter>]
[-Case <String>]
[-DistributionDetail]
[-IncludeBindings]
[-IncludeBindingsOnly]
[<CommonParameters>]
Description
若要在安全性與合規性 PowerShell 中使用此 Cmdlet，您必須獲得指派權限。 如需詳細資訊，請參閱 Microsoft Purview 合規性入口網站中的權限。
範例
範例 1
Get-CaseHoldPolicy -Case "Contoso Legal"
此範例顯示與名為 Contoso Legal 的電子發現案件相關的保單詳細資訊。
範例 2
Get-CaseHoldPolicy -Identity "Regulation 123 Compliance"
此範例顯示名為「第123號法規合規」的政策詳細資訊。
參數
-Case
適用：安全性 & 合規
Case 參數會指定你想透過與該政策關聯的電子發現案件查看的案件保留政策。 您可以使用下列值來識別 eDiscovery 案例︰
- 名稱
- 識別碼 (GUID 值)。
您可以執行此命令來尋找這些值：Get-ComplianceCase | Format-Table -Auto Name,Status,Identity。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DistributionDetail
適用：安全性 & 合規
DistributionDetail 交換器會回傳案件暫停政策的詳細保單分配資訊。 您不需要使用此參數指定值。
如果你不使用這個交換器，指令不會回傳目前部署狀態的資訊，DistributionStatus 屬性會顯示為「待處理」。
此切換會影響以下特性：
- SharePointLocation
- 交換地點
- 公開資料夾位置
- 發行狀態
- 分布結果
- LastStatusUpdateTime
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Identity
適用：安全性 & 合規
Identity 參數指定你想要查看的案件保留策略。 您可以使用唯一識別原則的任何值。 例如：
- 名稱
- 辨別名稱 (DN)
- GUID
注意：Identity 參數的值$null或不存在的值，會回傳 所有 物件，就像你執行 Get- 指令時沒有 Identity 參數一樣。 請確認 Identity 參數的值清單是否準確，且不包含不存在的 $null 值。
參數屬性
| 類型: | PolicyIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 1 |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-IncludeBindings
適用：安全性 & 合規
PARAMVALUE：SwitchParameter
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-IncludeBindingsOnly
適用：安全性 & 合規
{{ Fill IncludeBindingsOnly 描述 }}
參數屬性
| 類型: | 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。