New-CsSipProxyTransport
Última modificación del tema: 2012-03-27
Especifica el protocolo de transmisión que se va a usar en una ruta estática. Microsoft Lync Server 2010 permite elegir entre TCP (Protocolo de control de transmisión) o TLS (Seguridad de la capa de transporte) como protocolo de transmisión de una ruta.
Sintaxis
New-CsSipProxyTransport -Port <UInt16> -TransportChoice <ITransportChoice>
Descripción detallada
Cuando se envía un mensaje SIP a alguien, es posible que el mensaje deba atravesar diversas redes y subredes antes de la entrega; la ruta de acceso que recorre el mensaje se suele denominar ruta. En el ámbito de las redes, hay dos tipos de rutas: dinámicas y estáticas. Con el enrutamiento dinámico, los servidores usan algoritmos para calcular la siguiente ubicación (el siguiente salto) a la que se debe reenviar el mensaje. Con el enrutamiento estático, los administradores del sistema se encargan de predeterminar las rutas de acceso de los mensajes. Cuando un servidor recibe un mensaje, comprueba la dirección del mensaje y, a continuación, lo reenvía al servidor del siguiente salto que haya preconfigurado un administrador. Si se configuran correctamente, las rutas estáticas ayudan a asegurar la entrega precisa y puntual de los mensajes sin apenas sobrecargar los servidores. La desventaja de las rutas estáticas reside en que los mensajes no se redistribuyen de forma dinámica si se produce un error de red.
Lync Server 2010 permite configurar rutas estáticas para servidores proxy. Estas rutas están formadas por dos partes principales: opciones de configuración de proxy y rutas de proxy SIP. A su vez, las rutas de proxy SIP tienen una determinada cantidad de propiedades; por ejemplo, cada ruta debe tener un transporte, propiedad que define el protocolo de red usado para transmitir mensajes por la ruta. La propiedad Transport se puede especificar mediante el cmdlet New-CsSipProxyTransport.
New-CsSipProxyTransport tiene dos parámetros obligatorios: TransportChoice y Port. El parámetro TransportChoice se configura usando otro cmdlet, ya sea New-CsSipProxyTCP (para asignar el Protocolo de control de transmisión como transporte de ruta) o New-CsSipProxyTLS (para asignar el protocolo TLS como transporte de ruta). Todo objeto de transporte que se cree mediante New-CsSipProxyTransport se debe guardar en una variable. A continuación se usará esa variable para configurar la propiedad de Transporte de una ruta de proxy SIP.
No necesita usar el cmdlet New-CsSipProxyTransport si está usando New-CsStaticRoute para crear la ruta estática.
Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet New-CsSipProxyTransport localmente: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en rol (RBAC), este rol se ha asignado (así como cualquier otro rol RBAC personalizado que haya creado) para ejecutar el siguiente comando desde el símbolo del sistema Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsSipProxyTransport"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Port |
Requerido |
Entero |
Número del puerto que se usará para el enrutamiento SIP. Por ejemplo: -Port 7742. |
TransportChoice |
Requerido |
Objeto de transporte |
Indica el protocolo de transmisión (TCP o TLS) que se usará en la ruta estática. Para usar el protocolo TCP, cree un objeto de transporte con el cmdlet New-CsSipProxyTCP. Para usar el protocolo TLS, cree un objeto de transporte con el cmdlet New-CsSipProxyTLS. |
Tipos de entrada
Ninguno. New-CsSipProxyTransport no acepta entradas transferidas.
Tipos de valores devueltos
New-CsSipProxyTransport crea nuevas instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.Transport.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
$cert = New-CsSipProxyUseDefaultCert
$tls = New-CsSipProxyTLS -Certificate $cert -Fqdn atl-proxy-001.litwareinc.com
$transport = New-CsSipProxyTransport -TransportChoice $tls -Port 7500
Los comandos que se muestran en el Ejemplo 1 crean un nuevo objeto de transporte de proxy SIP que usa TLS como transporte. Debido a que TLS requiere un certificado (que se usará con fines de autenticación), el primer comando del ejemplo usa New-CsSipProxyUseDefaultCert para configurar un nuevo SipProxy.UseDefaultCert. Este objeto, almacenado en una variable denominada $cert, indica a Lync Server que use el certificado predeterminado para el transporte de TLS. Después de la creación del objeto UseDefaultCert, se puede llamar a New-CsSipProxyTLS para crear un nuevo objeto SipProxy.TLS que usa el certificado predeterminado y que apunta a atl-proxy-001.litwareinc.com como el nombre de dominio completo del servidor del próximo salto.
-------------------------- Ejemplo 2 ------------------------
$tcp = New-CsSipProxyTCP -IPAddress 192.168.1.100
$transport = New-CsSipProxyTransport -TransportChoice $tcp -Port 7500
Los comandos que se muestran en el Ejemplo 2 crean un nuevo objeto de transporte de proxy SIP que usa TCP como transporte. Para ello, el primer comando del ejemplo usa New-CsSipProxyTCP para crear un nuevo objeto SipProxy.TCP que apunta al servidor del siguiente salto, con IP 192.168.1.100. Este objeto TCP se almacena en una variable llamada $tcp.
Una vez creado el objeto SipProxy.TCP, se puede llamar al cmdlet New-CsSipProxyTransport para crear un objeto de transporte TCP.