[This is preliminary documentation and is subject to change. Blank topics are included as placeholders.]

Specifies the transmission protocol to be used in a static route. Microsoft Communications Server 2010 enables you to choose either TCP (Transmission Control Protocol) or TLS (Transport Layer Security) as the transmission protocol for a route.

Syntax

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

Parameters

Parameter Required Type Description

TransportChoice

Required

Transport object

Indicates the transmission protocol (TCP or TLS) to be used on the static route. To use the TCP protocol, create a transport object using the New-CsSipProxyTCP cmdlet. To use the TLS protocol, create a transport object using the New-CsSipProxyTLS cmdlet.

Port

Required

Integer

Port number used for SIP routing. For example: -Port 7742.

Detailed Description

When you send a SIP (Session Initiation Protocol) message to someone that message might need to traverse multiple subnets and networks before it is delivered; the path traveled by the message is often referred to as a route. In networking, there are two types of routes: dynamic and static. With dynamic routing, servers use algorithms to determine the next location (the next hop) where a message should be forwarded. With static routing, message paths are predetermined by system administrators. When a message is received by a server, the server checks the message address and then forwards the message to the next hop server that has been preconfigured by an administrator. If configured correctly, static routes help ensure timely, and accurate, delivery of messages, and with minimal overheard placed on servers. The downside to static routes? Messages are not dynamically rerouted in the event of a network failure.

Microsoft Communications Server “14” enables you to set up static routes for proxy servers. These routes are composed of two primary pieces: proxy configuration settings and SIP proxy route. In turn, SIP proxy routes have a number of properties ; for example, each route must have a Transport, a property that defines the network protocol used for transmitting messages along the route. The Transport property can be specified using the New-CsSipProxyTransport cmdlet.

New-CsSipProxyTransport has two required parameters: -TransportChoice and –Port. The –TransportChoice parameter is configured using another cmdlet, either New-CsSipProxyTCP (to assign the Transmission Control Protocol as the route transport) or New-CsSipProxyTLS (to assign the Transport Layer Security as the route transport). Any transport object created by using New-CsSipProxyTransport must be saved to a variable. That variable will then be used to configure the Transport property of a SIP proxy route.

You do not need to use the New-CsSipproxyTransport cmdlet if you are using New-CsStaticRoute to create your static route.

Return Types

New-CsSipProxyTransport creates new instances of the Microsoft.Rtc.Management.WriteableConfig.Settings.SipProxy.Transport object.

Examples

-------------------------- Example 1 ------------------------

Copy Code
$cert = New-CsSipProxyUseDefaultCert

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

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

The commands shown in Example 1 create a new SIP proxy transport object that uses TLS as its transport. Because the TLS requires a certificate (to be used for authentication purposes), the first command in the example uses New-CsSipProxyUseDefaultCert to configure a new SipProxy.UseDefaultCert. This object, stored in a variable named $cert, instructs Communications Server to use the default certificate for the TLS transport. After the UseDefaultCert object has been created, New-CsSipProxyTLS can be called to create a new SipProxy.TLS object, one that uses the default certificate and that points to atl-proxy-001.litwareinc.com as the fully qualified domain name of the next hop server.

-------------------------- Example 2 ------------------------

Copy Code
$tcp = New-CsSipProxyTCP -IPAddress 192.168.1.100

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

The commands shown in Example 1 create a new SIP proxy transport object that uses TCP as its transport. To do this, the first command in the example uses New-CsSipProxyTCP to create a new SipProxy.TCP object that points to the next hop server with the IP address 192.168.1.100; this TCP object is stored in a variable named $tcp.

After the SipProxy.TCP object has been created, the New-CsSipProxyTransport cmdlet creates a TCP transport object