You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This cmdlet releases existing telephone numbers from Microsoft Teams telephone number management inventory. Once released the phone numbers will not be visible in Teams PowerShell as acquired telephone numbers. A maximum of 1,000 phone numbers can be released at a time. If more than 1,000 numbers need to be released, the requests should be divided into multiple increments of up to 1,000 numbers.
28
30
29
-
The cmdlet is an asynchronous operation and will return an OrderId as output. You can use the [Get-CsOnlineTelephoneNumberOrder](https://learn.microsoft.com/powershell/module/teams/get-csonlinetelephonenumberorder) cmdlet to check the status of the OrderId, including any error or warning messages that might result from the operation: `Get-CsOnlineTelephoneNumberOrder -OrderType Release -OrderId "orderId"`.
31
+
This cmdlet releases existing telephone numbers from Microsoft Teams telephone number management
32
+
inventory. Once released the phone numbers will not be visible in Teams PowerShell as acquired
33
+
telephone numbers. A maximum of 1,000 phone numbers can be released at a time. If more than 1,000
34
+
numbers need to be released, the requests should be divided into multiple increments of up to 1,000
35
+
numbers.
36
+
37
+
The cmdlet is an asynchronous operation and will return an OrderId as output. You can use the
In this example, a 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 the [Get-CsOnlineTelephoneNumberOrder](https://learn.microsoft.com/powershell/module/teams/get-csonlinetelephonenumberorder) cmdlet to retrieve the status of the order: `Get-CsOnlineTelephoneNumberOrder -OrderType Release -OrderId "orderId"`.
51
+
In this example, a telephone number "+123456789" is being released from Microsoft Teams telephone
In this example, a list of telephone numbers are being released from Microsoft Teams telephone number management. The output of the cmdlet is the OrderId that can be used with the [Get-CsOnlineTelephoneNumberOrder](https://learn.microsoft.com/powershell/module/teams/get-csonlinetelephonenumberorder) cmdlet to retrieve the status of the order: `Get-CsOnlineTelephoneNumberOrder -OrderType Release -OrderId "orderId"`.
61
+
In this example, a list of telephone numbers are being released from Microsoft Teams telephone
In this example, a range of 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 the [Get-CsOnlineTelephoneNumberOrder](https://learn.microsoft.com/powershell/module/teams/get-csonlinetelephonenumberorder) cmdlet to retrieve the status of the order: `Get-CsOnlineTelephoneNumberOrder -OrderType Release -OrderId "orderId"`.
71
+
In this example, a range of telephone numbers from "+12000000" to "+12000009" are being released from Microsoft Teams telephone number management.
In this example, the content of a file with a list of telephone numbers are being released via file upload. The file should be in Comma Separated Values (CSV) file format and should only contain the list of telephone numbers to be released. The New-CsOnlineTelephoneNumberReleaseOrder cmdlet is only used to pass the content. To read the output of this cmdlet and retrieve the status of your order, you can use OrderId with the [Get-CsOnlineTelephoneNumberOrder](./get-csonlinetelephonenumberorder.md) cmdlet : `Get-CsOnlineTelephoneNumberOrder -OrderType Release -OrderId "orderId"`.
81
+
In this example, the content of a file with a list of telephone numbers are being released via file upload. The file should be in Comma Separated Values (CSV) file format and should only contain the list of telephone numbers to be released. The `New-CsOnlineTelephoneNumberReleaseOrder` cmdlet is only used to pass the content.
65
82
66
83
## PARAMETERS
67
84
68
85
### -EndingNumber
69
-
This is the ending number of a range of telephone number you wish to release from your tenant in Microsoft Teams telephone number management inventory.
86
+
87
+
This is the ending number of a range of telephone number you wish to release from your tenant in
88
+
Microsoft Teams telephone number management inventory.
This is the content of a .csv file that includes the telephone numbers to be released from the Microsoft Teams telephone number management inventory. This parameter can be used to release up to 1,000 numbers at a time.
103
+
104
+
This is the content of a .csv file that includes the telephone numbers to be released from the
105
+
Microsoft Teams telephone number management inventory. This parameter can be used to release up to
106
+
1,000 numbers at a time.
85
107
86
108
```yaml
87
109
Type: Byte[]
@@ -93,9 +115,12 @@ Position: Named
93
115
Default value: None
94
116
Accept pipeline input: False
95
117
Accept wildcard characters: False
118
+
```
96
119
97
120
### -StartingNumber
98
-
This is the starting number of a range of telephone number you wish to release from your tenant in Microsoft Teams telephone number management inventory.
121
+
122
+
This is the starting number of a range of telephone number you wish to release from your tenant in
123
+
Microsoft Teams telephone number management inventory.
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
155
+
156
+
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable,
0 commit comments