Commands › Microsoft Teams
Grant-CsTeamsAIPolicy
This cmdlet applies an instance of the Teams AI policy to users or groups in a tenant.
Quick start script
# Grant-CsTeamsAIPolicy — 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-CsTeamsAIPolicy -Global <SwitchParameter> -Group <String> -Identity <String> | Format-List
# 3. Export for evidence / drift tracking
Grant-CsTeamsAIPolicy | Export-Clixml .\CsTeamsAIPolicy-$(Get-Date -Format yyyyMMdd).xmlSyntax — 4 parameter sets
Identity (Default)
Grant-CsTeamsAIPolicy [<CommonParameters>]GrantToUser
Grant-CsTeamsAIPolicy -Identity <String> [[-PolicyName] <String>] [<CommonParameters>]GrantToGroup
Grant-CsTeamsAIPolicy [[-PolicyName] <String>] [-Group] <String> -Rank <Int32>
[<CommonParameters>]GrantToTenant
Grant-CsTeamsAIPolicy [[-PolicyName] <String>] [-Global] [-Force] [<CommonParameters>]Parameters (6)
| Parameter | Type | Required | What it controls |
|---|---|---|---|
| -Force | SwitchParameter | Suppresses the display of any non-fatal error message that might arise when running the command. | |
| -Global | SwitchParameter | yes | 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 | yes | Specifies the identity of the target user. |
| -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 | yes | The rank of the policy assignment, relative to other group policy assignments for the same policy type. |
Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.