Commands › Microsoft Teams
Grant-CsTeamsWorkLoadPolicy
This cmdlet applies an instance of the Teams Workload policy to users or groups in a tenant.
Quick start script
# Grant-CsTeamsWorkLoadPolicy — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-MicrosoftTeams -CertificateThumbprint $thumb -ApplicationId $appId -TenantId $tenantId
# 2. Run and inspect
Grant-CsTeamsWorkLoadPolicy -Group <String> | Format-List
# 3. Export for evidence / drift tracking
Grant-CsTeamsWorkLoadPolicy | Export-Clixml .\CsTeamsWorkLoadPolicy-$(Get-Date -Format yyyyMMdd).xmlSyntax — 3 parameter sets
Identity (Default)
Grant-CsTeamsWorkLoadPolicy [[-Identity] <String>] [-PassThru] [[-PolicyName] <String>]
[-MsftInternalProcessingMode <String>] [-WhatIf] [-Confirm] [<CommonParameters>]GrantToTenant
Grant-CsTeamsWorkLoadPolicy [-PassThru] [[-PolicyName] <String>] [-MsftInternalProcessingMode <String>]
[-Global] [-WhatIf] [-Confirm] [<CommonParameters>]GrantToGroup
Grant-CsTeamsWorkLoadPolicy [-PassThru] [[-PolicyName] <String>] [-MsftInternalProcessingMode <String>]
[-Group] <String> [-Rank <Int32>] [-WhatIf] [-Confirm] [<CommonParameters>]Parameters (9)
| Parameter | Type | Required | What it controls |
|---|---|---|---|
| -Confirm | SwitchParameter | Prompts you for confirmation before running the cmdlet. | |
| -Global | SwitchParameter | This is the equivalent to `-Identity Global`. | |
| -Group | String | yes | This is the identifier of the group that the policy should be assigned to. |
| -Identity | String | Specifies the identity of the target user. | |
| -MsftInternalProcessingMode | String | For Microsoft internal use only. | |
| -PassThru | SwitchParameter | Enables you to pass a user object through the pipeline that represents the user being assigned the policy. | |
| -PolicyName | String | Specifies the name of the policy to be assigned. The PolicyName is the policy identity minus the policy scope ("tag:"), for example, a policy that has an identity of "Tag:Enabled" has a PolicyName of "Enabled". | |
| -Rank | Int32 | The rank of the policy assignment, relative to other group policy assignments for the same policy type. | |
| -WhatIf | SwitchParameter | Shows what would happen if the cmdlet runs. The cmdlet is not run. |
Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.