Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

Grant-CsTeamsMeetingBrandingPolicy

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

GrantToUser

Grant-CsTeamsMeetingBrandingPolicy
 [[-PolicyName] <String>]
 -Identity <String>
 [<CommonParameters>]

GrantToGroup

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

GrantToTenant

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 "alice@contoso.com" -PolicyName "Policy Test"

In this example, the command assigns TeamsMeetingBrandingPolicy with the name Policy Test to user alice@contoso.com.

Assign TeamsMeetingBrandingPolicy to a group

PS C:\> Grant-CsTeamsMeetingBrandingPolicy -Group group@contoso.com -PolicyName "Policy Test" -Rank 1

In this example, the command will assign TeamsMeetingBrandingPolicy with the name Policy Test to group group@contoso.com.

Parameters

-Force

Suppresses any confirmation prompts that would otherwise be displayed before making changes.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-Global

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

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-Group

Specifies the group used for the group policy assignment.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-Identity

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

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-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.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-Rank

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

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Notes

Available in Teams PowerShell Module 4.9.3 and later.

Related Links


Feedback

Was this page helpful?