New-CsSipProxyTransport

 

上一次修改主题: 2012-03-27

指定要在静态路由中使用的传输协议。通过 Microsoft Lync Server 2010,可以选择传输控制协议 (TCP) 或传输层安全性 (TLS) 作为路由的传输协议。

语法

New-CsSipProxyTransport -Port <UInt16> -TransportChoice <ITransportChoice>

详细说明

向某人发送 SIP 消息时,该消息可能需要穿越多个子网和网络才能传送;该消息的传输路径通常称为路由。在网络中,共有两种路由:即动态路由和静态路由。对于动态路由,服务器使用算法确定应将消息转发到的下一个位置(即下一个跃点)。对于静态路由,消息路径由系统管理员预先确定。当服务器接收消息时,该服务器将检查消息地址,并将其转发到管理员预先配置的下一个跃点服务器。如果配置正确,静态路由将有助于确保及时、准确地传送消息,并在服务器上消耗最少的开销。静态路由的不利方面就是,如果出现网络故障,将不会以动态方式重新路由消息。

通过 Lync Server 2010,您可以为代理服务器设置静态路由。这些路由主要包含两部分:代理配置设置和 SIP 代理路由。SIP 代理路由有很多属性,例如,每个路由必须有 Transport,它是定义用于沿路由传输消息的网络协议的属性。Transport 属性可以使用 New-CsSipProxyTransport cmdlet 进行指定。

New-CsSipProxyTransport 包含两个必需参数:TransportChoice 和 Port。TransportChoice 参数是使用其他 cmdlet 配置的,即 New-CsSipProxyTCP(将传输控制协议指定为路由传输协议)或 New-CsSipProxyTLS(将 TLS 指定为路由传输协议)。使用 New-CsSipProxyTransport 创建的任何传输对象都必须保存到变量中。该变量随后将用于配置 SIP 代理路由的 Transport 属性。

如果使用 New-CsStaticRoute 创建静态路由,则无需使用 New-CsSipProxyTransport cmdlet。

谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 New-CsSipProxyTransport cmdlet:RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsSipProxyTransport"}

参数

参数 必需 类型 描述

Port

必需

整数

用于 SIP 路由的端口号。例如:-Port 7742。

TransportChoice

必需

传输对象

指示要在静态路由中使用的传输协议(TCP 或 TLS)。要使用 TCP 协议,请使用 New-CsSipProxyTCP cmdlet 创建一个传输对象。要使用 TLS 协议,请使用 New-CsSipProxyTLS cmdlet 创建一个传输对象。

输入类型

无。New-CsSipProxyTransport 不接受通过管道传递的输入。

返回类型

New-CsSipProxyTransport 创建 Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.Transport 对象的新实例。

示例

-------------------------- 示例 1 --------------------------

$cert = New-CsSipProxyUseDefaultCert

$tls = New-CsSipProxyTLS -Certificate $cert -Fqdn atl-proxy-001.litwareinc.com

$transport = New-CsSipProxyTransport -TransportChoice $tls -Port 7500

示例 1 中显示的命令创建一个将 TLS 用作其传输协议的新 SIP 代理传输对象。由于 TLS 需要证书(用于身份验证目的),因此示例中的第一个命令使用 New-CsSipProxyUseDefaultCert 配置新的 SipProxy.UseDefaultCert 对象。此对象存储在名为 $cert 的变量中,将指示 Lync Server 使用默认证书进行 TLS 传输。创建了 UseDefaultCert 对象后,可以调用 New-CsSipProxyTLS 以创建新的 SipProxy.TLS 对象,此对象使用默认的证书,并指向作为下一个跃点服务器的完全限定域名 (FQDN) 的 atl-proxy-001.litwareinc.com。

-------------------------- 示例 2 --------------------------

$tcp = New-CsSipProxyTCP -IPAddress 192.168.1.100

$transport = New-CsSipProxyTransport -TransportChoice $tcp -Port 7500

示例 2 中显示的命令创建一个将 TCP 用作其传输协议的新 SIP 代理传输对象。为执行此操作,此示例中的第一个命令使用 New-CsSipProxyTCP 创建一个新的 SipProxy.TCP 对象,该对象指向 IP 地址为 192.168.1.100 的下一个跃点服务器;该 TCP 对象存储在名为 $tcp 的变量中。

创建 SipProxy.TCP 对象之后,便可以调用 New-CsSipProxyTransport cmdlet 创建一个 TCP 传输对象。

另请参阅

其他资源

New-CsSipProxyTCP
New-CsSipProxyTLS