Creates a new range of unassigned numbers and the routing rules that apply to those numbers. Running this cmdlet will add an entry to the unassigned number routing table.
Syntax
New-CsUnassignedNumber -Identity <XdsGlobalRelativeIdentity> -NumberRangeStart <String> -NumberRangeEnd <String> -AnnouncementService <String> -AnnouncementName <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Priority <Int32>] [-WhatIf [<SwitchParameter>]] |
New-CsUnassignedNumber -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Priority <Int32>] [-WhatIf [<SwitchParameter>]] |
New-CsUnassignedNumber -Identity <XdsGlobalRelativeIdentity> -NumberRangeStart <String> -NumberRangeEnd <String> -ExUmAutoAttendantPhoneNumber <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Priority <Int32>] [-WhatIf [<SwitchParameter>]] |
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
|
Identity |
Required |
XdsGlobalRelativeIdentity |
A unique name for the range of unassigned numbers being created. All unassigned number ranges have a global scope, so the name specified here must be unique throughout the Microsoft Communications Server deployment. |
|
NumberRangeStart |
Required |
String |
The first number in the range of unassigned numbers. Must be less than or equal to the value supplied for NumberRangeEnd. The number must match the regular expression (tel:)?(\+)?[1-9]\d{0,17}(;ext=[1-9]\d{0,9})?. This means the number may begin with the string tel: (if you don’t specify that string it will be automatically added for you), a plus sign (+), and a digit 1 through 9. The phone number can be up to 17 digits and may be followed by and extension in the format ;ext= followed by the extension number. |
|
NumberRangeEnd |
Required |
String |
The last number in the range of unassigned numbers. Must be greater than or equal to the number supplied for NumberRangeStart. To specify a range of one number, use the same number for the NumberRangeStart and NumberRangeEnd. The number must match the regular expression (tel:)?(\+)?[1-9]\d{0,17}(;ext=[1-9]\d{0,9})?. This means the number may begin with the string tel: (if you don’t specify that string it will be automatically added for you), a plus sign (+), and a digit 1 through 9. The phone number can be up to 17 digits and may be followed by and extension in the format ;ext= followed by the extension number. |
|
AnnouncementService |
Required |
String |
The fully qualified domain name (FQDN) or service ID of the announcement server. This parameter is required only if you have not specified a value for the ExUmAutoAttendantPhoneNumber parameter. |
|
ExUmAutoAttendantPhoneNumber |
Required |
String |
The phone number of the ExUM Auto Attendant to route calls in this range to. This field is required only if you are not using an Announcement Service (in which case you do not supply values for the AnnouncementService or AnnouncementName parameters). The ExUM Auto Attendant contact must already be set up in order to assign a value to this parameter. |
|
AnnouncementName |
Required |
String |
The name of the Announcement that will be used to handle calls to this range of numbers. |
|
Confirm |
Optional |
SwitchParameter |
Prompts you for confirmation before executing the command. |
|
InMemory |
Optional |
SwitchParameter |
Creates an object reference without actually committing the object as a permanent change. If you assign the output of this cmdlet called with this parameter to a variable, you can make changes to the properties of the object reference and then commit those changes by calling this cmdlet’s matching Set- cmdlet. |
|
Priority |
Optional |
Int32 |
It is possible for unassigned number ranges to overlap. If a number falls within more than one range, the range with the highest priority will take effect. |
|
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 creates the settings that define that routing.
Before running this cmdlet, your system must already either have Announcements defined or an Exchange Unified Messaging (ExUM) Auto Attendant set up. To determine whether you have Announcements, call the Get-CsAnnouncement cmdlet. To create a new Announcement, call New-CsAnnouncement. To check on ExUM Auto Attendant settings, run the Get-CsExUmContact cmdlet.
Available scope: Global
Return Types
Creates an object of type Microsoft.Rtc.Management.Voice.Helpers.DisplayAnnouncementVacantNumberRange.
Examples
-------------------------- Example 1 --------------------------
 Copy Code |
|
|---|---|
New-CsUnassignedNumber -Identity UNSet1 -NumberRangeStart "+14255551000" -NumberRangeEnd "+14255551100" -AnnouncementService Redmond1-ApplicationServer-1 -AnnouncementName "Welcome Announcement" |
|
This example creates an unassigned number range with the name UNSet1. We use the NumberRangeStart (+14255551000) and NumberRangeEnd (+14255551100) parameters to define the range of unassigned numbers to which the specified announcement will apply. Finally, we specify the Announcement by first supplying the AnnouncementService parameter with the service ID of the Announcement server, then passing the value "Welcome Announcement" to the parameter AnnouncementName. Keep in mind that an Announcement with that name must already exist in the system.
-------------------------- Example 2 --------------------------
| Copy Code |
|
|---|---|
New-CsUnassignedNumber -Identity UNSet2 -NumberRangeStart "+14255552100" -NumberRangeEnd "+14255552200" -ExUmAutoAttendantPhoneNumber "+12065551234" |
|
This example creates an unassigned number range with the name UNSet2. As in Example 1 we use the NumberRangeStart (+14255552100) and NumberRangeEnd (+14255552200) parameters to define the range of vacant numbers to which the specified announcement will apply. However, in this example instead of using the Announcement Service, this number range will use the Exchange UM Auto Attendant. (The Auto Attendant is a single number designated as the main number for the enterprise that guides users through voice prompts to help them reach the appropriate party.) We pass a phone number to the ExUmAutoAttendantPhoneNumber parameter to complete this command. Note that Exchange Unified Messaging must be set up and this number must be an existing contact object phone number in Active Directory.
-------------------------- Example 3 --------------------------
| Copy Code |
|
|---|---|
New-CsUnassignedNumber -Identity UNSet2 -NumberRangeStart "+14255552100" -NumberRangeEnd "+14255552200" -ExUmAutoAttendantPhoneNumber "+12065551234" -Priority 2 |
|
Example 3 is almost identical to Example 2: It creates an unassigned number range with the name UNSet2. The difference in this example is that we’ve added the Priority parameter, in this case with a value of 2. This means that if an unassigned number range has been defined that overlaps this one and that number range has a higher priority (a lower priority number, such as 1), calls will be routed based on the settings for that range rather than this one.