Edit

Share via

Grant-CsTeamsMeetingBrandingPolicy

  • Reference
Module:
MicrosoftTeamsPowerShell

Assigns a teams meeting branding policy at the per-user scope. The CsTeamsMeetingBrandingPolicy cmdlet enables administrators to control the appearance in meetings by defining custom backgrounds, logos, and colors.

Syntax

Grant-CsTeamsMeetingBrandingPolicy
     -Identity <String>
     [[-PolicyName] <String>]
     [<CommonParameters>]
Grant-CsTeamsMeetingBrandingPolicy
     [[-PolicyName] <String>]
     [-Group] <String>
     -Rank <Int32>
     [<CommonParameters>]
Grant-CsTeamsMeetingBrandingPolicy
     [[-PolicyName] <String>]
     [-Global]
     [-Force]
     [<CommonParameters>]

Description

Assigns a teams meeting branding policy at the per-user scope. The CsTeamsMeetingBrandingPolicy cmdlet enables administrators to control the appearance in meetings by defining custom backgrounds, logos, and colors.

Examples

Assign TeamsMeetingBrandingPolicy to a user

PS C:\> Grant-CsTeamsMeetingBrandingPolicy -identity "[email protected]" -PolicyName "Policy Test"

In this example, the command assigns TeamsMeetingBrandingPolicy with the name Policy Test to user [email protected].

Assign TeamsMeetingBrandingPolicy to a group

PS C:\> Grant-CsTeamsMeetingBrandingPolicy -Group [email protected] -PolicyName "Policy Test" -Rank 1

In this example, the command will assign TeamsMeetingBrandingPolicy with the name Policy Test to group [email protected].

Parameters

-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

-Global

Use this switch if you want to grant the specified policy to be the default policy for all users in the tenant.

Type:SwitchParameter
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Group

Specifies the group used for the group policy assignment.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Identity

The user you want to grant policy to. This can be specified as an SIP address, UserPrincipalName, or ObjectId.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PolicyName

The name of the custom policy that is being assigned to the user. To remove a specific assignment and fall back to the default tenant policy, you can assign it to $Null.

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Rank

The rank of the policy assignment, relative to other group policy assignments for the same policy type.

Type:Int32
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Notes

Available in Teams PowerShell Module 4.9.3 and later.