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