Remove-CsPhoneNumberAssignment (MicrosoftTeams)

Publisher

Microsoft

URL

https://learn.microsoft.com/en-us/powershell/module/microsoftteams/remove-csphonenumberassignment

Published

2026-08-07

Updated

unknown

Accessed

2026-09-25

HTTP status

200

License

Microsoft Learn terms of use; no-redistribution; short excerpts and locators only

Source notes citing this source

• Remove-CsPhoneNumberAssignment can set an assignment block on the freed number, either indefinite (AssignmentBlockedForever) or for 1 to 365 days (AssignmentBlockedDays), parameters introduced in Teams PowerShell module 7.5.0. in context
• Remove-CsPhoneNumberAssignment unassigns a number from a user or resource account, automatically sets EnterpriseVoiceEnabled to False, and leaves the number available in the tenant unless an assignment block is set. in context
• Remove-CsPhoneNumberAssignment can block a number from reassignment, indefinitely with -AssignmentBlockedForever or for 1 to 365 days with -AssignmentBlockedDays; both parameters were introduced in module 7.5.0. in context
• From module 4.2.1-preview, Remove-CsPhoneNumberAssignment reports failures as exceptions appended to $Error and honours -ErrorAction, instead of returning a result object with Code and Message. in context
• Unassigning a phone number with Remove-CsPhoneNumberAssignment automatically sets EnterpriseVoiceEnabled to False; the number stays in the tenant unless an assignment block is applied. in context
• Remove-CsPhoneNumberAssignment -RemoveAll unassigns all phone numbers from a user or resource account without naming each number or its type. in context

Cite this source record

APA

WarmTransfer. (2026, August 7). Remove-CsPhoneNumberAssignment (MicrosoftTeams). WarmTransfer. https://warmtransfer.net/knowledge/sources/ms-ps-remove-csphonenumberassignment-b

BibTeX

@misc{warmtransfer-ms-ps-remove-csphonenumberassignment-b,
  title  = {Remove-CsPhoneNumberAssignment (MicrosoftTeams)},
  author = {{WarmTransfer}},
  year   = {2026},
  url    = {https://warmtransfer.net/knowledge/sources/ms-ps-remove-csphonenumberassignment-b},
  note   = {Microsoft, accessed 2026-09-25}
}