Modifier

Partager via

New-CsOnlineTelephoneNumberReleaseOrder

  • Reference
Module:
MicrosoftTeamsPowerShell
Applies to:
Microsoft Teams

This cmdlet creates a request to release Direct Routing telephone numbers from Microsoft Teams telephone number management inventory.

Syntax

New-CsOnlineTelephoneNumberReleaseOrder
   [-TelephoneNumber <String>]
   [-StartingNumber <String>]
   [-EndingNumber <String>]
   [<CommonParameters>]

Description

This cmdlet releases existing Direct Routing telephone numbers from Microsoft Teams telephone number management inventory. Once released the phone numbers will not be visible in Teams PowerShell as acquired Direct Routing phone numbers. The cmdlet is an asynchronous operation and will return an OrderId as output. Get-CsOnlineTelephoneNumberOrder cmdlet can be used to check the status of the OrderId including any error or warning message that may result from the operation.

Examples

Example 1

PS C:\> New-CsOnlineTelephoneNumberReleaseOrder -TelephoneNumber "+123456789"
cdf3073a-6fbb-4ade-a8af-e8fa1f3b9c13

In this example, a new Direct Routing telephone number "+123456789" is being released from Microsoft Teams telephone number management inventory. The output of the cmdlet is the OrderId that can be used with Get-CsOnlineTelephoneNumberOrder cmdlet to retrieve the status of the order.

Example 2

PS C:\> New-CsOnlineTelephoneNumberReleaseOrder -StartingNumber "+12000000" -EndingNumber "+12000009"
cdf3073a-6fbb-4ade-a8af-e8fa1f3b9c13

In this example, a range of Direct Routing telephone numbers from "+12000000" to "+12000009" are being released from Microsoft Teams telephone number management. The output of the cmdlet is the OrderId that can be used with Get-CsOnlineTelephoneNumberOrder cmdlet to retrieve the status of the order.

Parameters

-EndingNumber

This is the ending number of a range of Direct Routing telephone number you wish to release from Microsoft Teams telephone number management inventory.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-StartingNumber

This is the starting number of a range of Direct Routing telephone number you wish to release from Microsoft Teams telephone number management inventory.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TelephoneNumber

This is the Direct Routing telephone number you wish to release from Microsoft Teams telephone number management inventory.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

None

Outputs

System.String

Notes

The cmdlet is available in Teams PowerShell module 6.7.1 or later.

The cmdlet is only available in commercial and GCC cloud instances.