Commands › Microsoft Teams

Set-CsTeamsMeetingBrandingPolicy

Microsoft Teams MicrosoftTeams Set-*

The **CsTeamsMeetingBrandingPolicy** cmdlet enables administrators to control the appearance in meetings by defining custom backgrounds, logos, and colors.

Quick start script

# Set-CsTeamsMeetingBrandingPolicy — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-MicrosoftTeams -CertificateThumbprint $thumb -ApplicationId $appId -TenantId $tenantId

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

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

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

Syntax

Set-CsTeamsMeetingBrandingPolicy
 [-MeetingBackgroundImages <PSListModifier>]
 [-MeetingBrandingThemes <PSListModifier>]
 [-DefaultTheme <String>] [-EnableMeetingOptionsThemeOverride <Boolean>]
 [-EnableMeetingBackgroundImages <Boolean>] [-Identity] <String> [-Force] [-WhatIf] [-Confirm]
 [<CommonParameters>]

Parameters (9)

Parameter	Type	Required	What it controls
-Confirm	SwitchParameter		Prompts you for confirmation before running the cmdlet.
-DefaultTheme	String		This parameter is reserved for Microsoft internal use only. Identity of default meeting theme.
-EnableMeetingBackgroundImages	Boolean		Enables custom meeting backgrounds.
-EnableMeetingOptionsThemeOverride	Boolean		Allows organizers to control meeting themes.
-Force	SwitchParameter		Suppresses any confirmation prompts that would otherwise be displayed before making changes.
-Identity	String	yes	Identity of meeting branding policy that will be updated. To refer to the global policy, use this syntax: `-Identity global`.
-MeetingBackgroundImages	PSListModifier		This parameter is reserved for Microsoft internal use only. List of meeting background images. It is not possible to add or remove background images using cmdlets. You should use Teams Admin Center for that purpose.
-MeetingBrandingThemes	PSListModifier		List of meeting branding themes. You can alter the list returned by the `Get-CsTeamsMeetingBrandingPolicy` cmdlet and pass it to this parameter. It is not possible to add or remove meeting branding themes using...
-WhatIf	SwitchParameter		Describes what would happen if you executed the command without actually executing the command.

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