Commands › Microsoft Teams
Grant-CsTeamsCortanaPolicy
The CsTeamsCortanaPolicy cmdlets enable administrators to control settings for Cortana voice assistant in Microsoft Teams.
Quick start script
# Grant-CsTeamsCortanaPolicy — 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-CsTeamsCortanaPolicy -Group <String> -PolicyName <String> | Format-List
# 3. Export for evidence / drift tracking
Grant-CsTeamsCortanaPolicy | Export-Clixml .\CsTeamsCortanaPolicy-$(Get-Date -Format yyyyMMdd).xmlSyntax — 3 parameter sets
Identity (Default)
Grant-CsTeamsCortanaPolicy [[-Identity] <UserIdParameter>] [-PolicyName] <String> [-Tenant <System.Guid>]
[-DomainController <Fqdn>] [-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]GrantToTenant
Grant-CsTeamsCortanaPolicy [-PolicyName] <String> [-Tenant <System.Guid>] [-DomainController <Fqdn>]
[-PassThru] [-Global] [-WhatIf] [-Confirm] [<CommonParameters>]GrantToGroup
Grant-CsTeamsCortanaPolicy [-PassThru] [[-PolicyName] <String>] [-MsftInternalProcessingMode <String>]
-Group <String> [-Rank <Int32>] [-WhatIf] [-Confirm] [<CommonParameters>]Parameters (10)
| Parameter | Type | Required | What it controls |
|---|---|---|---|
| -Confirm | SwitchParameter | Prompts you for confirmation before running the cmdlet. | |
| -DomainController | Fqdn | This parameter is reserved for internal Microsoft use. | |
| -Global | SwitchParameter | Use this switch if you want to grant the specified policy to be the default policy for all users in the tenant. | |
| -Group | String | yes | Specifies the group used for the group policy assignment. |
| -Identity | UserIdParameter | Indicates the identity of the user account the policy should be assigned to. User identities can be specified using one of four formats: 1) the user's SIP address; 2) the user principal name (UPN); 3) the user's... | |
| -PassThru | SwitchParameter | {{ Fill PassThru Description }} | |
| -PolicyName | String | yes | 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 to $Null. |
| -Rank | Int32 | The rank of the policy assignment, relative to other group policy assignments for the same policy type. | |
| -Tenant | Guid | Globally unique identifier (GUID) of the tenant account whose external user communication policy are being created. For example: -Tenant "38aad667-af54-4397-aaa7-e94c79ec2308" You can return your tenant ID by running... | |
| -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.