Commands › Exchange Online

New-ComplianceCase

Exchange Online ExchangeOnlineManagement New-*

For more information, see Security & Compliance PowerShell. Use the New-ComplianceCase cmdlet to create eDiscovery cases in the Microsoft Purview compliance portal. You use eDiscovery cases to place content locations on hold, perform Content Searches associated with the case, and export search results. > [!NOTE] > In the cloud, this cmdlet has the following requirements: > - Version 3.9.0 or later of the Exchange Online PowerShell module (August 2025). > - Use the *EnableSearchOnlySession* parameter when you run the **Connect-IPPSSession** command to connect to Security & Compliance PowerShell

Quick start script

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

# 2. Capture the current state first — you cannot roll back what you never recorded
$before = Get-ComplianceCase
$before | Format-List

# 3. Make the change (dry run first)
New-ComplianceCase -Name <String> -WhatIf
New-ComplianceCase -Name <String>

# 4. Verify and diff
$after = Get-ComplianceCase
Compare-Object ($before | Out-String) ($after | Out-String)

Syntax

New-ComplianceCase [-Name] <String>
 [-CaseType <ComplianceCaseType>]
 [-Confirm]
 [-Description <String>]
 [-DomainController <Fqdn>]
 [-ExternalId <String>]
 [-SecondaryCaseType <String>]
 [-SourceCaseType <String>]
 [-WhatIf]
 [<CommonParameters>]

Parameters (9)

Parameter	Type	Required	What it controls
-Name	String	yes	The Name parameter specifies the unique name of the compliance case. The maximum length is 64 characters. If the value contains spaces, enclose the value in quotation marks (").
-CaseType	ComplianceCaseType		The CaseType parameter specifies the type of compliance case that you want to create. Valid values are:
-Confirm	SwitchParameter		The Confirm switch specifies whether to show or hide the confirmation prompt. How this switch affects the cmdlet depends on whether the cmdlet requires confirmation before proceeding.
-Description	String		The Description parameter specifies a description for the compliance case. The maximum length is 256 characters. If the value contains spaces, enclose the value in quotation marks (").
-DomainController	Fqdn		This parameter is reserved for internal Microsoft use.
-ExternalId	String		The ExternalId parameter specifies an optional ID or external case number that you can associate with the new compliance case.
-SecondaryCaseType	String		This parameter is reserved for internal Microsoft use.
-SourceCaseType	String		This parameter is reserved for internal Microsoft use.
-WhatIf	SwitchParameter		The WhatIf switch doesn't work in Security & Compliance PowerShell.

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