Commands › Exchange Online

Get-CaseHoldPolicy

Exchange Online ExchangeOnlineManagement Get-*

For more information, see Security & Compliance PowerShell. Use the Get-CaseHoldPolicy to view existing case hold policies in the Microsoft Purview compliance portal. To get relevant information about how the hold was applied and the affected locations, you need to include the DistributionDetail switch.

App-only limitation executed read-only 20 Oct 2026 · module v3.10.1 — not served under read-only app-only RBAC

Quick start script

# Get-CaseHoldPolicy — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-ExchangeOnline -CertificateThumbprint $thumb -AppId $appId -Organization $org

# 2. Run and inspect
Get-CaseHoldPolicy | Format-List

# 3. Export for evidence / drift tracking
Get-CaseHoldPolicy | Export-Clixml .\CaseHoldPolicy-$(Get-Date -Format yyyyMMdd).xml

Syntax

Get-CaseHoldPolicy [[-Identity] <PolicyIdParameter>]
 [-Case <String>]
 [-DistributionDetail]
 [-IncludeBindings]
 [-IncludeBindingsOnly]
 [<CommonParameters>]

Parameters (5)

Parameter	Type	What it controls
-Identity	PolicyIdParameter	The Identity parameter specifies the case hold policy that you want to view. You can use any value that uniquely identifies the policy. For example:
-Case	String	The Case parameter specifies the case hold policy that you want to view by using the eDiscovery case that's associated with the policy. You can use the following values to identify the eDiscovery case:
-DistributionDetail	SwitchParameter	The DistributionDetail switch returns detailed policy distribution information on the case hold policy. You don't need to specify a value with this switch.
-IncludeBindings	SwitchParameter	PARAMVALUE: SwitchParameter
-IncludeBindingsOnly	SwitchParameter	{{ Fill IncludeBindingsOnly Description }}

Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.