Removes an existing range of unassigned numbers and the routing rules that apply to those numbers.
Syntax
Remove-CsUnassignedNumber -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]] |
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
|
Identity |
Required |
XdsGlobalRelativeIdentity |
The unique name for the range of unassigned numbers you want to remove. |
|
Confirm |
Optional |
SwitchParameter |
Prompts you for confirmation before executing the command. |
|
Force |
Optional |
SwitchParameter |
Suppresses any confirmation prompts that would otherwise be displayed before making changes. |
|
WhatIf |
Optional |
SwitchParameter |
Describes what would happen if you executed the command without actually executing the command. |
Detailed Description
Unassigned numbers are phone numbers that have been assigned to an enterprise but that have not been assigned to specific users or phones. Microsoft Communications Server 2010 can be set up to route calls to appropriate destinations when an unassigned number is called. This cmdlet removes the settings that define that routing.
Return Types
This cmdlet does not return a value. It removes an object of type Microsoft.Rtc.Management.Voice.Helpers.DisplayAnnouncementVacantNumberRange.
Examples
-------------------------- Example 1 --------------------------
 Copy Code |
|
|---|---|
Remove-CsUnassignedNumber -Identity UNSet1 |
|
In this example, the unassigned number settings with the Identity UNSet1 are removed.
-------------------------- Example 2 --------------------------
| Copy Code |
|
|---|---|
Get-CsUnassignedNumber | Where-Object {$_.AnnouncementName -match "Welcome"} | Remove-CsUnassignedNumber
|
|
Example 2 removes all unassigned number settings where the name of the assigned announcement contains the string Welcome. The command begins with a call to Get-CsUnassignedNumber, which returns a collection of all unassigned number settings. This collection is then passed the the Where-Object cmdlet, which narrows down the collection to only those unassigned number settings with an AnnouncementName that includes (-match) the string Welcome. Finally, the narrowed-down collection is passed to Remove-CsUnassignedNumber, which removes everything left in the collection.