Commands › Microsoft Teams
Remove-CsOnlineVoiceRoute
Removes an online voice route. Online voice routes contain instructions that tell Skype for Business Online how to route calls from Office 365 users to phone numbers on the public switched telephone network (PSTN) or a private branch exchange (PBX).
Quick start script
# Remove-CsOnlineVoiceRoute — 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-CsOnlineVoiceRoute
$before | Format-List
# 3. Make the change (dry run first)
Remove-CsOnlineVoiceRoute -Identity <String> -WhatIf
Remove-CsOnlineVoiceRoute -Identity <String>
# 4. Verify and diff
$after = Get-CsOnlineVoiceRoute
Compare-Object ($before | Out-String) ($after | Out-String)Syntax
Remove-CsOnlineVoiceRoute [-Identity] <string> [-WhatIf] [-Confirm] [<CommonParameters>]Parameters (3)
| Parameter | Type | Required | What it controls |
|---|---|---|---|
| -Confirm | SwitchParameter | Prompts you for confirmation before running the cmdlet. | |
| -Identity | String | yes | The unique identity of the online voice route. (If the route name contains a space, such as Test Route, you must enclose the full string in parentheses.) |
| -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.