Get-CaseHoldRule
此 Cmdlet 僅適用於安全性與合規性 PowerShell。 如需詳細資訊，請參閱 安全性與合規性 PowerShell。
使用 Get-CaseHoldRule 在Microsoft Purview 合規性入口網站中檢視案例保留規則。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
語法
Default (預設值)
Get-CaseHoldRule
[[-Identity] <ComplianceRuleIdParameter>]
[-Policy <PolicyIdParameter>]
[<CommonParameters>]
Description
在大型環境中，在沒有任何參數的情況下執行此 Cmdlet 會導致逾時。 您可以執行下列命令作為因應措施：
Get-ComplianceCase | foreach {Get-CaseHoldPolicy -Case $_.Identity | foreach {Get-CaseHoldRule -Policy $_.Guid}}
若要在安全性與合規性 PowerShell 中使用此 Cmdlet，您必須獲得指派權限。 如需詳細資訊，請參閱 Microsoft Purview 合規性入口網站中的權限。
範例
範例 1
Get-CaseHoldRule -Identity "30 Day Rule"
此範例會顯示名為 "30 Day Rule" 的案例保留規則的詳細資訊。
參數
-Identity
適用對象：安全性 & 合規性
Identity 參數會指定您要檢視的案例保留規則。 您可以使用唯一識別規則的任何值。 例如：
- 名稱
- 辨別名稱 (DN)
- GUID
警告： Identity 參數的值 $null 或不存在的值會傳回 所有 物件，就像您在執行 Get- 命令而不使用Identity 參數一樣。 請確認 Identity 參數的任何值清單均正確無誤，且不包含不存在的$null值。
參數屬性
| 類型: | ComplianceRuleIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 1 |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Policy
適用對象：安全性 & 合規性
Policy 參數會依相關聯的案例保留原則篩選案例保留規則結果。 您可以使用唯一識別原則的任何值。 例如：
- 名稱
- 辨別名稱 (DN)
- GUID
您可以在同一個命令中搭配使用此參數與 Identity 參數。
參數屬性
| 類型: | PolicyIdParameter |
| 預設值: | 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。