New-CsVoiceRoute
上一次修改主题： 2012-03-26
创建新的语音路由。语音路由包含一些说明，指示 Microsoft Lync Server 2010 如何将来自企业语音用户的呼叫路由到公用电话交换网 (PSTN) 或专用交换机 (PBX) 上的电话号码。
语法
New-CsVoiceRoute -Identity <XdsGlobalRelativeIdentity> [-AlternateCallerId <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-NumberPattern <String>] [-Priority <Int32>] [-PstnGatewayList <PSListModifier>] [-PstnUsages <PSListModifier>] [-SuppressCallerId <Nullable>] [-WhatIf [<SwitchParameter>]]
New-CsVoiceRoute -Name <String> [-AlternateCallerId <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-NumberPattern <String>] [-Priority <Int32>] [-PstnGatewayList <PSListModifier>] [-PstnUsages <PSListModifier>] [-SuppressCallerId <Nullable>] [-WhatIf [<SwitchParameter>]]
详细说明
使用此 cmdlet 可创建新的语音路由。所有语音路由都是在 Global 作用域创建的。但是，可以定义多个全局语音路由。这是通过 Identity 参数实现的，该参数需要一个唯一的路由名称。
语音路由通过 PSTN 用法与语音策略关联。语音路由包括一个正则表达式，用于标识要通过给定语音路由进行路由的电话号码：与该正则表达式匹配的电话号码将通过该路由进行路由。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 New-CsVoiceRoute cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsVoiceRoute"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
Xds 标识 |
用于唯一标识语音路由的名称。由于只能在 global 作用域定义语音路由，因此标识就是您要为路由分配的名称。（可以在路由名称中包含空格（例如 Test Route），但是在调用 New-CsVoiceRoute 时，必须用双引号将整个字符串括起来。） 如果指定了 Identity，则 Name 必须留空。Identity 的值将分配给 Name。 |
Name |
必需 |
字符串 |
语音路由的唯一名称。如果设置了此参数，则会将该值自动应用到语音路由 Identity。不能同时指定 Identity 和 Name。 |
AlternateCallerId |
可选 |
字符串 |
如果 SuppressCallerId 参数设置为 True，会将 AlternateCallerId 参数的值显示给接收方，而不是呼叫者的实际号码。该号码应该是一个有效的号码，可以用来代表组织中的部门，例如技术支持部或人力资源部。 如果 SuppressCallerId 参数设置为 False，则将忽略 AlternateCallerId 参数。 该值必须与正则表达式 (\+)?[1-9]\d*(;ext=[1-9]\d*)? 匹配。换句话说，该值可以（但非必须）以一个加号 (+) 开头；必须包含任意位数字；可后跟一个由 ;ext= 开头并后接任意位数字的分机。（请注意，如果要包含一个分机，则必须用双引号将字符串括起来。） |
Description |
可选 |
字符串 |
该语音路由用途的描述。 |
NumberPattern |
可选 |
字符串 |
用于指定应用该路由的电话号码的正则表达式。将根据其余路由设置对与此模式匹配的号码进行路由。 默认值：[0-9]{10} |
Priority |
可选 |
Int32 |
数字可以解析为多个语音路由。如果可能有多个路由，则优先级确定将应用路由的顺序。 |
PstnGatewayList |
可选 |
PSListModifier |
在 Lync Server 2010 中，一个中介服务器可以与多个网关关联。该参数包含由与此语音路由关联的网关组成的列表。该列表的每个成员必须是 PSTN 网关或 中介服务器 的服务标识。仅当为 Microsoft Office Communications Server 2007 或 Microsoft Office Communications Server 2007 R2 配置中介服务器时，该值才可以引用中介服务器。对于 Lync Server 2010，必须使用 PSTN 网关。服务标识是一个格式为 <ServiceRole>:<FQDN> 的字符串，其中 ServiceRole 是服务角色的名称 (PSTNGateway)，FQDN 是池的完全限定域名 (FQDN) 或服务器的 IP 地址。例如，PSTNGateway:redmondpool.litwareinc.com。通过调用命令 Get-CsService | Select-Object Identity 可以检索服务标识。 默认情况下，此列表为空。但是，如果在创建新语音路由时将此参数留空，您将收到一条警告消息。 |
PstnUsages |
可选 |
PSListModifier |
可应用到该语音路由的 PSTN 用法（如 Local、Long Distance 等）的列表。PSTN 用法必须是现有用法。（可以通过调用 Get-CsPstnUsage cmdlet 来检索 PSTN 用法。） 默认情况下，此列表为空。但是，如果在创建新语音路由时将此参数留空，您将收到一条警告消息。 |
SuppressCallerId |
可选 |
布尔值 |
确定是否在出站呼叫中显示呼叫者的 ID。如果此参数设置为 True，将隐藏呼叫者 ID。将在实际 ID 的位置显示 AlternateCallerId 的值。当 SuppressCallerId 设置为 True 时，必须为 AlternateCallerId 提供值。 |
Force |
可选 |
开关参数 |
在进行更改前取消可能另外显示的任何确认提示。 |
InMemory |
可选 |
SwitchParmeter |
创建对象引用，但并不作为永久性更改实际提交对象。如果将使用此参数调用的 cmdlet 的输出分配给一个变量，您可以更改对象引用的属性，然后通过调用与此 cmdlet 匹配的 Set- cmdlet 提交这些更改。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
字符串 |
在执行命令之前提示您进行确认。 |
输入类型
无。
返回类型
创建一个类型为 Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route 的对象。
示例
-------------------------- 示例 1 --------------------------
New-CsVoiceRoute -Identity Route1
此示例中的命令创建一个 Identity 为 Route1 的新语音路由。其他所有属性都将设置为默认值。
-------------------------- 示例 2 --------------------------
New-CsVoiceRoute -Identity Route1 -PstnUsages @{add="Long Distance"} -PstnGatewayList @{add="PstnGateway:redmondpool.litwareinc.com"}
此示例中的命令创建一个 Identity 为 Route1 的新语音路由。该命令还向用法列表中添加了 PSTN 用法 Long Distance，并向 PSTN 网关列表中添加了服务 ID PstnGateway:redmondpool.litwareinc.com。
-------------------------- 示例 3 --------------------------
$x = (Get-CsPstnUsage).Usage
New-CsVoiceRoute -Identity Route1 -PstnUsages @{add=$x}
此示例创建一个名为 Route1 的新语音路由，并使用组织的所有现有用法来填充该路由的 PSTN 用法列表。此示例中的第一个命令可检索全局 PSTN 用法的列表。请注意，对 Get-CsPstnUsage 的调用位于括号中，这意味着将首先检索包含 PSTN 用法信息的对象。（由于只有一个全局 PSTN 用法，因此只会检索到一个对象。）然后，该命令检索此对象的 Usage 属性。包含用法列表的该属性将分配给变量 $x。在此示例的第二行中，调用 New-CsVoiceRoute 以创建新的语音路由。该语音路由的标识为 Route1。请注意传递给 PstnUsages 参数的值：@{add=$x}。该值表示将 $x 的内容（其中包含第 1 行中检索到的电话用法列表）添加到此路由的 PSTN 用法列表。