New-CsUnassignedNumber
上一次修改主题： 2012-03-26
创建新的未分配号码的范围和应用于这些号码的路由规则。运行此 cmdlet 将向未分配的号码路由表中添加条目。
语法
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>]]
详细说明
未分配的号码是指已分配给组织但尚未分配给特定用户或电话的电话号码。当呼叫未分配的号码时，可设置 Microsoft Lync Server 2010 将呼叫路由至相应目标。此 cmdlet 可创建定义路由的设置。
在运行此 cmdlet 之前，系统必须已定义通知，或已设置 Exchange 统一消息 (UM) 自动助理。要确定您是否具有通知，请调用 Get-CsAnnouncement cmdlet。要创建新的通知，请调用 New-CsAnnouncement。要检查 Exchange UM 自动助理设置，请运行 Get-CsExUmContact cmdlet。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 New-CsUnassignedNumber cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsUnassignedNumber"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
XdsGlobalRelativeIdentity |
将要创建的未分配号码范围的唯一名称。所有未分配号码范围都具有 global 作用域，因此此处指定的名称必须在整个 Lync Server 2010 部署中是唯一的。 |
AnnouncementName |
必需 |
字符串 |
要用于处理对此号码范围的呼叫的通知的名称。 |
AnnouncementService |
必需 |
字符串 |
通知服务器的完全限定域名 (FQDN) 或服务 ID。仅当您未指定 ExUmAutoAttendantPhoneNumber 参数的值时才需要此参数。 |
ExUmAutoAttendantPhoneNumber |
必需 |
字符串 |
要将此范围内的呼叫路由到的 Exchange UM 自动助理的电话号码。仅当您未使用通知服务时（在您未提供 AnnouncementService 或 AnnouncementName 参数值的情况下）才需要此字段。必须已设置 Exchange UM 自动助理联系人以便为此参数分配值。 |
NumberRangeStart |
必需 |
字符串 |
未分配号码范围中的第一个号码。必须小于等于为 NumberRangeEnd 提供的值。 此号码必须符合正则表达式 (tel:)?(\+)?[1-9]\d{0,17}(;ext=[1-9]\d{0,9})?。这意味着此号码可能以字符串 tel:（如果没有指定此字符串，将自动为您添加）、加号 (+) 以及一个 1 到 9 之间的数字开头。电话号码最长为 17 位数，并可以后跟分机号，格式为 ;ext= 后跟分机号。 |
NumberRangeEnd |
必需 |
字符串 |
未分配号码范围的最后一个号码。必须大于等于为 NumberRangeStart 提供的号码。要指定一个号码的范围，请对 NumberRangeStart 和 NumberRangeEnd 使用相同的号码。 此号码必须符合正则表达式 (tel:)?(\+)?[1-9]\d{0,17}(;ext=[1-9]\d{0,9})?。这意味着此号码可能以字符串 tel:（如果没有指定此字符串，将自动为您添加）、加号 (+) 以及一个 1 到 9 之间的数字开头。电话号码最长为 17 位数，并可以后跟分机号，格式为 ;ext= 后跟分机号。 |
Priority |
可选 |
Int32 |
未分配号码的范围有可能重叠。如果一个号码可以划分在多个范围内，则具有最高优先级的范围生效。 |
Force |
可选 |
开关参数 |
在进行更改前取消可能另外显示的任何确认提示。 |
InMemory |
可选 |
开关参数 |
创建对象引用，但并不作为永久性更改实际提交对象。如果将使用此参数调用的 cmdlet 的输出分配给一个变量，您可以更改对象引用的属性，然后通过调用与此 cmdlet 匹配的 Set- cmdlet 提交这些更改。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
无。
返回类型
创建一个类型为 Microsoft.Rtc.Management.Voice.Helpers.DisplayAnnouncementVacantNumberRange 的对象。
示例
-------------------------- 示例 1 --------------------------
New-CsUnassignedNumber -Identity UNSet1 -NumberRangeStart "+14255551000" -NumberRangeEnd "+14255551100" -AnnouncementService ApplicationServer:redmond.litwareinc.com -AnnouncementName "Welcome Announcement"
此示例创建一个名为 UNSet1 的未分配号码范围。使用 NumberRangeStart (+14255551000) 和 NumberRangeEnd (+14255551100) 参数定义将对其应用指定通知的未分配号码范围。最后，通过首先为 AnnouncementService 参数提供通知服务的服务 ID，然后将值“Welcome Announcement”传递给参数 AnnouncementName 来指定通知。请记住，系统中必须已存在具有该名称的通知。
-------------------------- 示例 2 --------------------------
New-CsUnassignedNumber -Identity UNSet2 -NumberRangeStart "+14255552100" -NumberRangeEnd "+14255552200" -ExUmAutoAttendantPhoneNumber "+12065551234"
此示例创建名为 UNSet2 的未分配号码范围。与在示例 1 中的操作相同，使用 NumberRangeStart (+14255552100) 和 NumberRangeEnd (+14255552200) 参数定义将对其应用指定通知的未分配号码范围。但在此示例中，该号码范围将使用 Exchange UM 自动助理，而不使用通知服务。（自动助理是指定作为组织主要号码的单个号码，该号码通过语音提示指导用户以帮助其到达相应方。）将一个电话号码传递给 ExUmAutoAttendantPhoneNumber 参数以完成该命令。请注意，必须设置 Exchange UM，且此号码必须是 Active Directory 域服务 (AD DS) 中的现有联系人对象的电话号码。此联系人必须是自动助理联系人（即联系人的 AutoAttendant 属性必须为 True）。
-------------------------- 示例 3 --------------------------
New-CsUnassignedNumber -Identity UNSet2 -NumberRangeStart "+14255552100" -NumberRangeEnd "+14255552200" -ExUmAutoAttendantPhoneNumber "+12065551234" -Priority 2
示例 3 与示例 2 几乎相同：创建名为 UNSet2 的未分配号码范围。不同之处在于，在此示例中添加了值为 2 的 Priority 参数。这意味着，如果另一个已定义的未分配号码范围与此号码范围重叠，且另一个号码范围的优先级较高（优先级编号较小，如 1），那么将基于另一个号码范围的设置路由呼叫，而不基于此号码范围的设置。