Commands › Microsoft Teams
New-CsTeamsCortanaPolicy
The CsTeamsCortanaPolicy cmdlets enable administrators to control settings for Cortana voice assistant in Microsoft Teams.
Quick start script
# New-CsTeamsCortanaPolicy — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-MicrosoftTeams -CertificateThumbprint $thumb -ApplicationId $appId -TenantId $tenantId
# 2. Capture the current state first — you cannot roll back what you never recorded
$before = Get-CsTeamsCortanaPolicy
$before | Format-List
# 3. Make the change (dry run first)
New-CsTeamsCortanaPolicy -Identity <XdsIdentity> -WhatIf
New-CsTeamsCortanaPolicy -Identity <XdsIdentity>
# 4. Verify and diff
$after = Get-CsTeamsCortanaPolicy
Compare-Object ($before | Out-String) ($after | Out-String)Syntax
New-CsTeamsCortanaPolicy [-Tenant <System.Guid>] [-Description <String>] [-CortanaVoiceInvocationMode <String>]
[-AllowCortanaVoiceInvocation <Boolean>] [-AllowCortanaAmbientListening <Boolean>]
[-AllowCortanaInContextSuggestions <Boolean>] [-Identity] <XdsIdentity> [-InMemory] [-Force] [-WhatIf]
[-Confirm] [<CommonParameters>]Parameters (11)
| Parameter | Type | Required | What it controls |
|---|---|---|---|
| -AllowCortanaAmbientListening | Boolean | This parameter is reserved for internal Microsoft use. | |
| -AllowCortanaInContextSuggestions | Boolean | This parameter is reserved for internal Microsoft use. | |
| -AllowCortanaVoiceInvocation | Boolean | This parameter is reserved for internal Microsoft use. | |
| -Confirm | SwitchParameter | Prompts you for confirmation before running the cmdlet. | |
| -CortanaVoiceInvocationMode | String | The value of this field indicates if Cortana is enabled and mode of invocation. * Disabled - Cortana voice assistant is turned off and cannot be used. * PushToTalkUserOverride - Cortana voice assistant is enabled but... | |
| -Description | String | Provide a description of your policy to identify purpose of creating it. | |
| -Force | SwitchParameter | The Force switch specifies whether to suppress warning and confirmation messages. It can be useful in scripting to suppress interactive prompts. If the Force switch isn't provided in the command, you're prompted for... | |
| -Identity | XdsIdentity | yes | Unique identifier for Teams cortana policy you're creating. |
| -InMemory | SwitchParameter | Creates an object reference without actually committing the object as a permanent change. If you assign the output of this cmdlet called with this parameter to a variable, you can make changes to the properties of... | |
| -Tenant | Guid | Globally unique identifier (GUID) of the tenant account whose external user communication policy are being created. For example: | |
| -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.