Get-CaseHoldPolicy
此 Cmdlet 僅適用于安全 & 性合規性 PowerShell。 如需詳細資訊，請參閱 安全 & 性合規性 PowerShell。
使用Get-CaseHoldPolicy來檢視Microsoft Purview 合規性入口網站中現有的案例保存原則。 若要取得如何套用保留和受影響位置的相關資訊，您必須包含 DistributionDetail 參數。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
Syntax
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。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-DistributionDetail
DistributionDetail 參數會傳回案例保留原則的詳細原則發佈資訊。 您不需要使用此參數指定值。
如果您未使用此參數，命令將不會傳回目前部署狀態的相關資訊，而且 DistributionStatus 屬性只會顯示為 「Pending」。
此參數會影響下列屬性：
- SharePointLocation
- ExchangeLocation
- PublicFolderLocation
- DistributionStatus
- DistributionResults
- LastStatusUpdateTime
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Identity
Identity 參數會指定您想要檢視的案例保留原則。 您可以使用唯一識別原則的任何值。 例如：
- 名稱
- 辨別名稱 (DN)
- GUID
| Type: | PolicyIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-IncludeBindings
PARAMVALUE：SwitchParameter
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-IncludeBindingsOnly
{{ Fill IncludeBindingsOnly Description }}
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |