New-CsStaticRoute
Última modificación del tema: 2012-03-26
Crea una ruta estática de teléfono.
Sintaxis
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>]
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 las redes, existen 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, las rutas de mensajes son predeterminadas por los administradores del sistema. Cuando el servidor recibe un mensaje, este comprueba la dirección del mensaje y, a continuación, reenvía el mensaje al servidor del próximo salto que ha sido configurado previamente por el administrador. Si se han configurado correctamente, las rutas estáticas ayudan a asegurar el envío de mensajes en tiempo adecuado y preciso y con mínima sobrecarga impuesta a los servidores. La desventaja de las rutas estáticas es que los mensajes no se enrutan dinámicamente en caso de error en la red.
Las nuevas rutas estáticas se crean con el cmdlet New-CsStaticRoute. Después de crear una ruta mediante New-CsStaticRoute, debe agregarla a una recopilación de valores de configuración de enrutamiento con el cmdlet Set-CsStaticRoutingConfiguration.
Quiénes pueden ejecutar este cmdlet: De manera predeterminada, los miembros de los siguientes grupos están autorizados para ejecutar el cmdlet New-CsStaticRoute en forma local: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en roles (RBAC) que se han asignado a este cmdlet (incluidos los roles personalizados RBAC que haya creado usted), ejecute el siguiente comando en el aviso de Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsStaticRoute"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Destination |
Requerido |
Cadena de caracteres |
Si la ruta usa Seguridad de la capa de transporte (TLS) como protocolo de transporte, el destino es el nombre de dominio completo del servidor (FQDN) del próximo salto. Por ejemplo: -Destination "atl-proxy-001.litwareinc.com". Si la ruta usa protocolo de control de transmisión (TCP) como protocolo de transporte, el destino es la dirección IP del enrutador del próximo salto. Por ejemplo: -Destination "192.168.0.240". |
MatchUri |
Requerido |
Cadena de caracteres |
Nombre de dominio completo (FQDN) o sufijo del dominio usado para determinar si el mensaje se está enviando a un usuario controlado por esta ruta. Por ejemplo, puede usar el FQDN "litwareinc.com". Este patrón coincide con todos los usuarios que tienen una dirección SIP que finaliza con el nombre de dominio "litwareinc.com". Para establecer una coincidencia con los dominios secundarios de un dominio, puede usar un valor de comodín como "*.litwareinc.com". Ese valor coincide con todos los dominio que finalizan con el sufijo "litwareinc.com". Por ejemplo: northamerica.litwareinc.com; asia.litwareinc.com; y europe.litwareinc.com. |
Enabled |
Opcional |
Booleano |
Si se lo define en True, se habilita la ruta y todos los mensajes que coinciden con el patrón MatchURI se enrutarán al servidor del próximo salto. Si se lo define en False, la ruta se deshabilita y no se usa para enrutar mensajes. El valor predeterminado es True. |
MatchOnlyPhoneUri |
Opcional |
Booleano |
Si se lo define en True, solo se establecerá coincidencia con los mensajes dirigidos a un Identificador Uniforme de Recursos (URI) de teléfono (por ejemplo, sip:kenmmyer@litwareinc.com;user=phone) y potencialmente se los enrutará. Si se lo define en False (el valor predeterminado) se establecerá coincidencia con todos los mensajes. |
Port |
Requerido |
Integer |
Número de puerto usado para el enrutamiento SIP. Por ejemplo: -Port 7742. |
ReplaceHostInRequestUri |
Opcional |
Booleano |
Si se lo define en True ($True), la parte correspondiente al host de un URI solicitado será reemplazada por la dirección del servidor del próximo salto. Si se lo define en False, el URI solicitado será usado sin modificaciones. El URI solicitado representa al URI del usuario o el servicio al que se dirige la solicitud (el mensaje). El valor predeterminado es False. |
TCPRoute |
Opcional |
Parámetro modificador |
Configura TCP como el protocolo de transporte de la nueva ruta. |
TLSCertIssuer |
Opcional |
Cadena de caracteres |
Nombre de la entidad de certificación (CA) que emitió el certificado que se usará en la ruta estática. Si se ha configurado TCP como protocolo de transporte, este parámetro no se usa. Si incluye el parámetro TLSCertIssuer también deberá usar el TLSCertSerialNumber. |
TLSCertSerialNumber |
Opcional |
Matriz de bytes |
Número de serie del certificado TLS que se usará en la ruta estática. Los números de serie deben pasarse como matriz de bytes; esto significa que debe pasar el número de serie como matriz de valores de dos caracteres. Por ejemplo: -TLSCertSerialNumber 0x01, 0xA4, 0xD5, 0x67, 0x89. Si se ha configurado TCP como protocolo de transporte, este parámetro no se usa. Si incluye el parámetro TLSCertSerialNumber también deberá usar el TLSCertIssuer. |
TLSRoute |
Opcional |
Parámetro modificador |
Configura TLS como el protocolo de transporte de la nueva ruta. |
UseDefaultCertificate |
Opcional |
Booleano |
Configura la ruta para que use el certificado de Lync Server 2010 predeterminado como certificado de autenticación. Si no desea usar el certificado predeterminado, debe especificar uno distinto mediante los parámetros TLSCertIssuer y TLSCertSerialNumber. Para ver el certificado predeterminado, use el siguiente comando: Get-CsCertificate | Where-Object {$_.Use –eq "urn:certref:Default"} |
Tipos de entrada
Ninguno. New-CsStaticRoute no acepta entradas canalizadas.
Tipos de valores devueltos
New-CsStaticRoute crea nuevas instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.Route.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
$x = New-CsStaticRoute -TCPRoute -Destination "192.168.0.100" -Port 8025 -MatchUri "litwareinc.com"
Set-CsStaticRoutingConfiguration -Identity global -Route @{Add=$x}
El comando que se muestra en el Ejemplo 1 crea una nueva ruta estática y luego la agrega a la recopilación de configuración de enrutamiento estático global. Para realizar esta tarea, el primer comando usa New-CsStaticRoute para crear una ruta sólo en memoria que use TCP como protocolo de transporte. La ruta señala a la dirección IP del próximo salto, 192.168.0.100, usa el puerto 8025 y establece coincidencia con todos los URI del dominio litwareinc.com. El objeto de ruta resultante se almacena en una variable llamada $x.
El segundo comando del ejemplo después agrega la nueva ruta a la recopilación de configuración de enrutamiento estático global. Ello se realiza al llamar a Set-CsStaticRoutingConfiguration con el parámetro Route. El valor de parámetro @{Add=$x} agrega el objeto de ruta almacenado en $x al conjunto existente de rutas que ya están en la recopilación global.
-------------------------- Ejemplo 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}
En el Ejemplo 2 se muestra cómo crear una nueva ruta estática que usa TLS como protocolo de transporte, y luego se agrega dicha ruta a la recopilación de configuración de enrutamiento estático global. Para ello, el primer comando del ejemplo usa New-CsStaticRoute para crear una ruta sólo en memoria que use TLS como protocolo de transporte. La ruta señala a "atl-proxy-001.litwareinc.com" como su destino, usa el puerto 8025 y establece coincidencia con todos los URI que usan el sufijo de dominio "litwareinc.com". Además, el nuevo objeto de ruta, almacenado en una variable llamada $x, usa el certificado predeterminado a los fines de la autenticación (-UseDefaultCertificate $True).
Una vez que se crea el objeto de ruta, el segundo comando del ejemplo a continuación agrega la nueva ruta a la recopilación de configuración de enrutamiento estático global.