New-CsStaticRoute
上一次修改主题： 2012-03-26
创建新的静态电话路由。
语法
New-CsStaticRoute -Destination <String> -MatchUri <String> -Port <UInt16> -TLSRoute <SwitchParameter> [-Enabled <$true | $false>] [-MatchOnlyPhoneUri <$true | $false>] [-ReplaceHostInRequestUri <$true | $false>] [-TLSCertIssuer <String>] [-TLSCertSerialNumber <Byte[]>] [-UseDefaultCertificate <$true | $false>]
New-CsStaticRoute -Destination <String> -MatchUri <String> -Port <UInt16> -TCPRoute <SwitchParameter> [-Enabled <$true | $false>] [-MatchOnlyPhoneUri <$true | $false>] [-ReplaceHostInRequestUri <$true | $false>]
详细说明
向某人发送 SIP 消息时，该消息可能需要穿越多个子网和网络才能传送；该消息的传输路径通常称为路由。在网络中，有以下两种类型的路由：动态和静态。使用动态路由时，服务器使用各种算法确定应将消息转发到的下一个位置（下一个跃点）。使用静态路由时，由系统管理员预先确定消息路径。服务器接收到消息后会检查消息地址，然后将消息转发到管理员预先配置的下一个跃点服务器。如果配置正确，静态路由有助于确保消息及时准确地送达，以及尽量减少服务器上的窃听情况。静态路由的不利方面就是，如果出现网络故障，将不会以动态方式重新路由消息。
创建新静态路由使用的是 New-CsStaticRoute cmdlet。使用 New-CsStaticRoute 创建路由之后，必须使用 Set-CsStaticRoutingConfiguration cmdlet 将该路由添加到一组路由配置设置中。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 New-CsStaticRoute cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsStaticRoute"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Destination |
必需 |
字符串 |
如果路由使用传输层安全性 (TLS) 作为传输协议，则 Destination 为下一个跃点服务器的完全限定域名 (FQDN)。例如：-Destination "atl-proxy-001.litwareinc.com"。 如果路由使用传输控制协议 (TCP) 作为传输协议，则 Destination 为下一个跃点路由器的 IP 地址。例如：-Destination "192.168.0.240"。 |
MatchUri |
必需 |
字符串 |
用于确定是否向此路由处理的用户发送消息的 FQDN 或域后缀。例如，可以使用 FQDN“litwareinc.com”。此模式与 SIP 地址以域名“litwareinc.com”结尾的任何用户相匹配。 要匹配某个域的子域，可使用类似“*.litwareinc.com”形式的通配符值。该值与以后缀“litwareinc.com”结尾的任何域匹配。例如：northamerica.litwareinc.com、asia.litwareinc.com 和 europe.litwareinc.com。 |
Enabled |
可选 |
布尔值 |
如果设置为 True，则启用该路由，并且将任何匹配 MatchURI 模式的消息都路由到下一个跃点服务器。如果设置为 False，则禁用该路由，并且在路由消息的过程中将不使用该路由。默认值为 True。 |
MatchOnlyPhoneUri |
可选 |
布尔值 |
如果设置为 True，则只会匹配并可能会路由送达地址为电话统一资源标识符 (URI)（例如 sip:kenmmyer@litwareinc.com;user=phone）的消息。如果设置为 False（默认值），则将匹配所有消息。 |
Port |
必需 |
整数 |
用于 SIP 路由的端口号。例如：-Port 7742。 |
ReplaceHostInRequestUri |
可选 |
布尔值 |
如果设置为 True ($True)，则 Request-URI 的主机部分将替换为下一个跃点服务器的地址。如果设置为 False，则将按原样使用 Request-URI。Request-URI 表示作为请求（消息）送达地址的用户或服务的 URI。默认值为 False。 |
TCPRoute |
可选 |
开关参数 |
配置 TCP 作为新路由的传输协议。 |
TLSCertIssuer |
可选 |
字符串 |
颁发静态路由中所用证书的证书颁发机构 (CA) 的名称。如果已配置 TCP 作为传输协议，则不使用此参数。 如果加入了 TLSCertIssuer 参数，则同时还必须使用 TLSCertSerialNumber 参数。 |
TLSCertSerialNumber |
可选 |
字节数组 |
静态路由中所用 TLS 证书的序列号。必须以字节数组的形式传递序列号；这意味着必须以双字符值数组的形式传递序列号。例如：-TLSCertSerialNumber 0x01, 0xA4, 0xD5, 0x67, 0x89。 如果已配置 TCP 作为传输协议，则不使用此参数。 如果加入了 TLSCertSerialNumber 参数，则同时还必须使用 TLSCertIssuer 参数。 |
TLSRoute |
可选 |
开关参数 |
配置 TLS 作为新路由的传输协议。 |
UseDefaultCertificate |
可选 |
布尔值 |
将路由配置为使用默认的 Lync Server 2010 证书作为其身份验证证书。如果不想使用默认证书，则必须使用 TLSCertIssuer 和 TLSCertSerialNumber 参数指定其他证书。 要查看默认证书，请使用以下命令： Get-CsCertificate | Where-Object {$_.Use –eq "urn:certref:Default"} |
输入类型
无。New-CsStaticRoute 不接受通过管道传递的输入。
返回类型
New-CsStaticRoute 创建 Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.Route 对象的新实例。
示例
-------------------------- 示例 1 ------------------------
$x = New-CsStaticRoute -TCPRoute -Destination "192.168.0.100" -Port 8025 -MatchUri "litwareinc.com"
Set-CsStaticRoutingConfiguration -Identity global -Route @{Add=$x}
示例 1 中显示的命令创建一个新的静态路由，然后将该路由添加到全局静态路由配置集合中。为完成此任务，第一个命令使用 New-CsStaticRoute 创建了一个使用 TCP 作为其传输协议的仅内存中路由。该路由指向下一个跃点 IP 地址 192.168.0.100，使用端口 8025，并匹配域 litwareinc.com 中的任何 URI。得到的路由对象存储在名为 $x 的变量中。
然后，示例中的第二个命令将这个新路由添加到全局静态路由配置集合中。这一点是通过调用带 Route 参数的 Set-CsStaticRoutingConfiguration 实现的。参数值 @{Add=$x} 将 $x 中存储的路由对象添加到全局集合中已有的一组路由中。
-------------------------- 示例 2 ------------------------
$x = New-CsStaticRoute -TLSRoute -Destination "atl-proxy-001.litwareinc.com" -Port 8025 -MatchUri "*.litwareinc.com" -UseDefaultCertificate $True
Set-CsStaticRoutingConfiguration -Identity global -Route @{Add=$x}
示例 2 显示如何创建使用 TLS 作为其传输协议的新静态路由，然后将该路由添加到全局静态路由配置集合中。为此，示例中的第一个命令使用 New-CsStaticRoute 创建了一个使用 TLS 作为其传输协议的仅内存中路由。路由指向用作其目标的“atl-proxy-001.litwareinc.com”，使用端口 8025，并匹配任何使用域后缀“litwareinc.com”的 URI。此外，这个新路由对象（存储在名为 $x 的变量中）使用默认证书进行身份验证 (-UseDefaultCertificate $True)。
创建路由对象之后，示例中的第二个命令将这个新路由添加到全局静态路由配置集合中。