Commands › Microsoft Teams
Remove-CsTeamsCortanaPolicy
The CsTeamsCortanaPolicy cmdlets enable administrators to control settings for Cortana voice assistant in Microsoft Teams.
Quick start script
# Remove-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)
Remove-CsTeamsCortanaPolicy -Identity <XdsIdentity> -WhatIf
Remove-CsTeamsCortanaPolicy -Identity <XdsIdentity>
# 4. Verify and diff
$after = Get-CsTeamsCortanaPolicy
Compare-Object ($before | Out-String) ($after | Out-String)Syntax
Remove-CsTeamsCortanaPolicy [-Tenant <System.Guid>] [-Identity] <XdsIdentity> [-Force] [-WhatIf] [-Confirm]
[<CommonParameters>]Parameters (5)
| Parameter | Type | Required | What it controls |
|---|---|---|---|
| -Confirm | SwitchParameter | Prompts you for confirmation before running the cmdlet. | |
| -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 | Identity for the policy you're modifying. To modify the global policy, use this syntax: -Identity global. To modify a per-user policy, use syntax similar to this: -Identity MyCortanaPolicy. If you do not specify an... |
| -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.