Remove-CsPhoneNumberAssignment

Remove-CsPhoneNumberAssignment
    -Identity <String>
    -TelephoneNumber <String>
    -NumberType <String>
    [-HttpPipelinePrepend <SendAsyncStep[]>]
    [-Notify]
    [-AssignmentBlockedForever]
    [-AssignmentBlockedDays <Integer>]
    [<CommonParameters>]

Remove-CsPhoneNumberAssignment
    -Identity <String>
    [-HttpPipelinePrepend <SendAsyncStep[]>]
    [-RemoveAll]
    [-Notify]
    [<CommonParameters>]

This cmdlet removes or unassigns a phone number from a user or resource account. The phone number continues to be available in the tenant unless you block assignment by using AssignmentBlockedForever or AssignmentBlockedDays.

Unassigning a phone number from a user or resource account automatically sets EnterpriseVoiceEnabled to False.

If the cmdlet executes successfully, no result object is returned. If the cmdlet fails for any reason, a result object is returned that contains a Code string parameter and a Message string parameter with additional details about the failure. Email notification to the end user is a best-effort operation. No error message is displayed if the email fails to send.

Note: In Teams PowerShell module 4.2.1-preview and later, the cmdlet reports errors differently. Instead of returning a result object, the cmdlet generates an exception and appends it to the $Error automatic variable. The cmdlet also supports the ErrorAction parameter to control execution after an error occurs.

Remove-CsPhoneNumberAssignment -Identity user1@contoso.com -TelephoneNumber +12065551234 -NumberType CallingPlan

This example removes or unassigns the Microsoft Calling Plan telephone number +1 (206) 555-1234 from the user user1@contoso.com.

Remove-CsPhoneNumberAssignment -Identity user2@contoso.com -RemoveAll

This example removes or unassigns all telephone numbers from user2@contoso.com.

Remove-CsPhoneNumberAssignment -Identity user1@contoso.com -TelephoneNumber +12065551234 -NumberType CallingPlan -Notify

This example removes or unassigns the Microsoft Calling Plan phone number +1 (206) 555-1234 from the user user1@contoso.com and sends an email notification to the user about the removal.

Remove-CsPhoneNumberAssignment -Identity user2@contoso.com -RemoveAll -Notify

This example removes or unassigns all telephone numbers from user2@contoso.com and sends an email notification to the user about the change.

Remove-CsPhoneNumberAssignment -Identity user1@contoso.com -TelephoneNumber +12065551234 -NumberType CallingPlan -AssignmentBlockedForever

This example removes a telephone number assignment from user1@contoso.com and sets an assignment block on the unassigned number for an indefinite duration.

Remove-CsPhoneNumberAssignment -Identity user1@contoso.com -TelephoneNumber +12065551234 -NumberType CallingPlan -AssignmentBlockedDays 30

This example removes a telephone number assignment from user1@contoso.com and sets an assignment block on the unassigned number for 30 days. The telephone number isn't available for new assignment for 30 days or until the block is removed manually. The telephone number automatically becomes available for assignment after the 30-day period ends.

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

The cmdlet is available in Teams PowerShell module 3.0.0 or later. The Notify parameter was introduced in Teams PowerShell module 7.3.0. The AssignmentBlockedForever and AssignmentBlockedDays parameters were introduced in Teams PowerShell module 7.5.0.