Commands › Microsoft Teams

New-CsTeamsMeetingBrandingPolicy

Microsoft Teams MicrosoftTeams New-*

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

Quick start script

# New-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)
New-CsTeamsMeetingBrandingPolicy -Identity <String> -WhatIf
New-CsTeamsMeetingBrandingPolicy -Identity <String>

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

Syntax

New-CsTeamsMeetingBrandingPolicy
 [-MeetingBackgroundImages <PSListModifier>]
 [-MeetingBrandingThemes <PSListModifier>]
 [-DefaultTheme <String>] [-EnableMeetingOptionsThemeOverride <Boolean>]
 [-EnableNdiAssuranceSlate <Boolean>] [-NdiAssuranceSlateImages <PSListModifier>] [-RequireBackgroundEffect <Boolean>]
 [-EnableMeetingBackgroundImages <Boolean>] [-Identity] <String> [-Force] [-WhatIf] [-Confirm]
 [<CommonParameters>]

Parameters (12)

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		Enable custom meeting backgrounds.
-EnableMeetingOptionsThemeOverride	Boolean		Allow organizer to control meeting theme.
-EnableNdiAssuranceSlate	Boolean		This enables meeting Network Device Interface Assurance Slate branding.
-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 created.
-MeetingBackgroundImages	PSListModifier		This parameter is reserved for Microsoft internal use only. List of meeting background images. Image upload is not possible via cmdlets. You should upload background images via Teams Admin Center.
-MeetingBrandingThemes	PSListModifier		This parameter is reserved for Microsoft internal use only. List of meeting branding themes. Image upload is not possible via cmdlets. You should create meeting themes via Teams Admin Center.
-NdiAssuranceSlateImages	NdiAssuranceSlate]		Used to specify images that can be used as assurance slates during NDI (Network Device Interface) streaming in Teams meetings. This parameter allows administrators to define a set of images that can be displayed to...
-RequireBackgroundEffect	Boolean		This mandates a meeting background for participants.
-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.