Commands › Microsoft Teams
Remove-CsOnlineTelephoneNumber
Remove one or more unassigned telephone numbers from your tenant.
Quick start script
# Remove-CsOnlineTelephoneNumber — 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-CsOnlineTelephoneNumber
$before | Format-List
# 3. Make the change (dry run first)
Remove-CsOnlineTelephoneNumber -TelephoneNumber <String[]> -WhatIf
Remove-CsOnlineTelephoneNumber -TelephoneNumber <String[]>
# 4. Verify and diff
$after = Get-CsOnlineTelephoneNumber
Compare-Object ($before | Out-String) ($after | Out-String)Syntax
Remove-CsOnlineTelephoneNumber -TelephoneNumber <String[]> [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]Parameters (4)
| Parameter | Type | Required | What it controls |
|---|---|---|---|
| -Confirm | SwitchParameter | The Confirm switch causes the command to pause processing and requires confirmation to proceed. | |
| -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... | |
| -TelephoneNumber | String[] | yes | Specifies the telephone number(s) to remove. The format can be with or without the prefixed +, but needs to include country code etc. |
| -WhatIf | SwitchParameter | The WhatIf switch causes the command to simulate its results. By using this switch, you can view what changes would occur without having to commit those changes. |
Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.