Set-CsTeamsMeetingBrandingPolicy
The CsTeamsMeetingBrandingPolicy cmdlet enables administrators to control the appearance in meetings by defining custom backgrounds, logos, and colors.
Syntax
Set-CsTeamsMeetingBrandingPolicy
[-MeetingBackgroundImages <PSListModifier>]
[-MeetingBrandingThemes <PSListModifier>]
[-DefaultTheme <String>]
[-EnableMeetingOptionsThemeOverride <Boolean>]
[-EnableMeetingBackgroundImages <Boolean>]
[-Identity] <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
The Set-CsTeamsMeetingBrandingPolicy
cmdlet allows administrators to update existing meeting branding policies.
However, it cannot be used to upload the images. If you want to upload the images, you should use Teams Admin Center.
Examples
Example 1
PS C:\> Get-CsTeamsMeetingBrandingPolicy
PS C:\> $brandingPolicy = Get-CsTeamsMeetingBrandingPolicy -Identity "demo branding"
PS C:\> $brandingPolicy.MeetingBrandingThemes[0].BrandAccentColor = "#FF0000"
PS C:\> Set-CsTeamsMeetingBrandingPolicy -Identity "demo branding" -MeetingBrandingThemes $brandingPolicy.MeetingBrandingThemes
In this example, the commands will change the brand accent color of the theme inside the demo branding
meeting branding policy to #FF0000
.
Parameters
-Confirm
Prompts you for confirmation before running the cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultTheme
This parameter is reserved for Microsoft internal use only. Identity of default meeting theme.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableMeetingBackgroundImages
Enables custom meeting backgrounds.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableMeetingOptionsThemeOverride
Allows organizers to control meeting themes.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Suppresses any confirmation prompts that would otherwise be displayed before making changes.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Identity
Identity of meeting branding policy that will be updated. To refer to the global policy, use this syntax: -Identity global
.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MeetingBackgroundImages
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.
Type: | PSListModifier |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MeetingBrandingThemes
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 cmdlets. You should use Teams Admin Center for that purpose.
Type: | PSListModifier |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Describes what would happen if you executed the command without actually executing the command.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Notes
Available in Teams PowerShell Module 4.9.3 and later.