Commands › Exchange Online

Set-ComplianceCase

Exchange Online ExchangeOnlineManagement Set-*

For more information, see Security & Compliance PowerShell. Use the Set-ComplianceCase cmdlet to modify eDiscovery cases in the Microsoft Purview compliance portal. > [!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

# Set-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)
Set-ComplianceCase -Identity <ComplianceCaseIdParameter> -WhatIf
Set-ComplianceCase -Identity <ComplianceCaseIdParameter>

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

Syntax

Set-ComplianceCase [-Identity] <ComplianceCaseIdParameter>
 [-CaseType <ComplianceCaseType>]
 [-Close]
 [-Confirm]
 [-Description <String>]
 [-DomainController <Fqdn>]
 [-ExternalId <String>]
 [-Name <String>]
 [-Reopen]
 [-WhatIf]
 [<CommonParameters>]

Parameters (10)

Parameter	Type	Required	What it controls
-Identity	ComplianceCaseIdParameter	yes	The Identity parameter specifies the compliance case that you want to modify. You can use any value that uniquely identifies the case. For example:
-CaseType	ComplianceCaseType		This parameter is reserved for internal Microsoft use.
-Close	SwitchParameter		The Close switch specifies that you want to close the compliance case. You don't need to specify a value with this switch.
-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 compliance case.
-Name	String		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 (").
-Reopen	SwitchParameter		The Reopen switch specifies that you want to re-open a closed compliance case. You don't need to specify a value with this switch.
-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.