Commands › Exchange Online

Set-MessageClassification

Exchange Online ExchangeOnlineManagement Set-*

Configure an existing message classification instance in your organization.

Quick start script

# Set-MessageClassification — 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-MessageClassification
$before | Format-List

# 3. Make the change (dry run first)
Set-MessageClassification -Identity <MessageClassificationIdParameter> -WhatIf
Set-MessageClassification -Identity <MessageClassificationIdParameter>

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

Syntax

Set-MessageClassification [-Identity] <MessageClassificationIdParameter>
 [-ClassificationID <Guid>]
 [-Confirm]
 [-DisplayName <String>]
 [-DisplayPrecedence <ClassificationDisplayPrecedenceLevel>]
 [-DomainController <Fqdn>]
 [-Name <String>]
 [-PermissionMenuVisible <Boolean>]
 [-RecipientDescription <String>]
 [-RetainClassificationEnabled <Boolean>]
 [-SenderDescription <String>]
 [-WhatIf]
 [<CommonParameters>]

Parameters (12)

Parameter	Type	Required	What it controls
-Identity	MessageClassificationIdParameter	yes	The Identity parameter specifies the message classification that you want to modify. You can use any value that uniquely identifies the message classification. For example:
-ClassificationID	Guid		The ClassificationID parameter specifies the classification ID (GUID) of an existing message classification that you want to import and use in your Exchange organization. Use this parameter if you're configuring...
-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.
-DisplayName	String		The DisplayName parameter specifies the title of the message classification that's displayed in Outlook and selected by users. The maximum length is 256 characters. If the value contains spaces, enclose the value in...
-DisplayPrecedence	ClassificationDisplayPrecedenceLevel		The DisplayPrecedence parameter specifies the relative precedence of the message classification to other message classifications that might be applied to a specified message. Valid values are:
-DomainController	Fqdn		This parameter is available only in on-premises Exchange.
-Name	String		The Name parameter specifies the unique name for the message classification. The maximum length is 64 characters. If the value contains spaces, enclose the value in quotation marks (").
-PermissionMenuVisible	Boolean		The PermissionMenuVisible parameter specifies whether the values that you entered for the DisplayName and RecipientDescription parameters are displayed in Outlook as the user composes a message. Valid values are:
-RecipientDescription	String		The RecipientDescription parameter specifies the detailed text that's shown to Outlook recipient when they receive a message that has the message classification applied. The maximum length is 1024 characters. If the...
-RetainClassificationEnabled	Boolean		The RetainClassificationEnabled parameter specifies whether the message classification should persist with the message if the message is forwarded or replied to.
-SenderDescription	String		The SenderDescription parameter specifies the detailed text that's shown to Outlook senders when they select a message classification to apply to a message before they send the message. The maximum length is 1024...
-WhatIf	SwitchParameter		The WhatIf switch shows what the command does without making any changes. You don't need to specify a value with this switch.

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