Edit

Share via

Grant-CsUserPolicyPackage

  • Reference
Module:
MicrosoftTeamsPowerShell

This cmdlet supports applying a policy package to users in a tenant. Note that there is a limit of 20 users you can apply the package to at a time. To apply a policy package to a larger number of users, consider using New-CsBatchPolicyPackageAssignmentOperation.

Syntax

Grant-CsUserPolicyPackage
     [-Identity] <String[]>
     [-PackageName] <String>
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

This cmdlet supports applying a policy package to users in a tenant. Provide one or more user identities to assign the package with all the associated policies. The available policy packages and their definitions can be found by running Get-CsPolicyPackage. The recommended policy package for each user can be found by running Get-CsUserPolicyPackageRecommendation. For more information on policy packages, please review https://zcusa.951200.xyz/MicrosoftTeams/manage-policy-packages.

Examples

Example 1

PS C:\> Grant-CsUserPolicyPackage -Identity 1bc0b35f-095a-4a37-a24c-c4b6049816ab,johndoe@example.com -PackageName Education_PrimaryStudent

Applies the Education_PrimaryStudent policy package to two users in the tenant.

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

-Identity

A list of one or more users in the tenant. Note that there is a limit of 20 users you can apply the package to at a time.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-PackageName

The name of a specific policy package to apply. All possible policy package names can be found by running Get-CsPolicyPackage.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False