Get-CsPhoneNumberAssignment (MicrosoftTeams)

Publisher

Microsoft

URL

https://learn.microsoft.com/en-us/powershell/module/microsoftteams/get-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

• A phone number's ActivationState is one of Activated, AssignmentPending, AssignmentFailed, UpdatePending or UpdateFailed. in context
• Get-CsPhoneNumberAssignment can filter numbers by capability (ConferenceAssignment, VoiceApplicationAssignment, UserAssignment, TeamsPhoneMobile), and Microsoft's example finds activated, unassigned numbers with VoiceApplicationAssignment. in context
• Get-CsPhoneNumberAssignment -AssignedPstnTargetId accepts a user or resource account and returns the assigned number's NumberType, ActivationState, PstnAssignmentStatus, PstnPartnerName, LocationId and LocationUpdateSupported. in context
• An Operator Connect number intended for a resource account probably needs the VoiceApplicationAssignment capability, and one uploaded only with UserAssignment probably cannot be assigned to an auto attendant or call queue account, so capability is what to check when a service number request goes wrong. inferred in context
• Get-CsPhoneNumberAssignment -CapabilitiesContain accepts TeamsPhoneMobile as a capability value alongside ConferenceAssignment, VoiceApplicationAssignment and UserAssignment. in context
• The Get-CsPhoneNumberAssignment reference documents only DirectRouting, CallingPlan and OperatorConnect as supported -NumberType filter values, with no Teams Phone Mobile-specific value. in context
• An audit script that calls Get-CsPhoneNumberAssignment without -Top/-Skip paging or Export-CsAcquiredPhoneNumber will see at most 500 numbers, so in larger tenants it undercounts without raising an error. inferred in context
• When Get-CsPhoneNumberAssignment -CapabilitiesContain is given a comma-separated list, it returns only numbers that have all of the listed capabilities, not any of them. in context
• Get-CsPhoneNumberAssignment returns at most 500 results by default; -Top raises that to at most 1000, and larger sets must be paged with -Skip and -Top or exported with Export-CsAcquiredPhoneNumber. in context
• The NumberSource output of Get-CsPhoneNumberAssignment is Online for numbers assigned in Microsoft 365 and OnPremises for numbers assigned in on-premises AD and synced; it was introduced in module 5.7.0. in context
• Get-CsPhoneNumberAssignment -AssignedPstnTargetId finds the number assigned to a user or resource account and accepts a UPN, SIP address, ObjectId or Teams shared calling routing policy instance name. in context
• Get-CsPhoneNumberAssignment is available from module 4.0.0; the AssignmentBlockedState and AssignmentBlockedUntil outputs arrived in 7.5.0 and SmsActivationState in 7.7.0. in context

Cite this source record

APA

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

BibTeX

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