Compartir a través de

  • Artículo

New-CsStaticRoutingConfiguration

 

Última modificación del tema: 2012-03-26

Crea una nueva recopilación de opciones de configuración de enrutamiento estático.

Sintaxis

New-CsStaticRoutingConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Route <PSListModifier>] [-WhatIf [<SwitchParameter>]]

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; el recorrido de acceso por el cual se debe desplazar 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 determinar la próxima ubicación (el próximo salto) donde se debe reenviar un 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 redistribuyen de manera dinámica en caso de producirse un error en la red.

Al instalar Microsoft Lync Server 2010, se crea automáticamente una recopilación global de rutas estáticas. Asimismo, se puede usar el cmdlet New-CsStaticRoutingConfiguration para crear recopilaciones adicionales y el ámbito del sitio o del servicio (para el servicio registrador solamente).

Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet New-CsStaticRoutingConfiguration localmente: 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-CsStaticRoutingConfiguration"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Identidad Xds

Identificador único para la nueva recopilación de enrutamiento estático que debe crearse. Las recopilaciones nuevas solo pueden crearse en el ámbito de servicio y solamente pueden asignarse al servicio de registrador. Debido a esto, la identidad para una nueva recopilación debe ser similar a esto: -Identity "service:Registrar:atl-cs-001.litwareinc.com".

Route

Opcional

Modificador de lista PS

Rutas estáticas individuales mantenidas dentro de la recopilación. Las rutas que se desean agregar a una recopilación deben copiarse de otra recopilación o deben crearse usando el cmdlet New-CsStaticRoute. Para obtener información detallada, consulte la sección de ejemplos relacionados con este tema.

Force

Opcional

Parámetro modificador

Suprime la visualización de los mensajes de error que no sean graves y que puedan producirse al ejecutar el comando.

InMemory

Opcional

Parámetro modificador

Crea una referencia de objeto sin confirmar realmente el objeto como cambio permanente. Si se asigna la salida de este cmdlet llamado con este parámetro en una variable, puede realizar cambios en las propiedades de la referencia del objeto y después confirmar estos cambios, llamando a este conjunto coincidente de cmdlet, - cmdlet.

WhatIf

Opcional

Parámetro modificador

Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente.

Confirm

Opcional

Parámetro modificador

Solicita confirmación antes de ejecutar el comando.

Tipos de entrada

Ninguno. New-CsStaticRoutingConfiguration no acepta entradas canalizadas.

Tipos de valores devueltos

New-CsStaticRoutingConfiguration crea nuevas instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.RoutingSettings.

Ejemplo

-------------------------- Ejemplo 1 --------------------------

New-CsStaticRoutingConfiguration -Identity "service:Registrar:atl-cs-001.litwareinc.com"

El comando anterior crea una nueva recopilación de configuraciones de enrutamiento estático con el parámetro Identity service:Registrar:atl-cs-001.litwareinc.com. Debido a que el parámetro Route no se incluye en el comando, la nueva recopilación no tendrá ninguna ruta estática asignada.

-------------------------- Ejemplo 2 --------------------------

$x = New-CsStaticRoute -TCPRoute -Destination "192.168.0.100" -Port 8025 -MatchUri "*.litwareinc.com"

New-CsStaticRoutingConfiguration -Identity "service:Registrar:atl-cs-001.litwareinc.com" -Route $x

Los comandos que se muestran en el Ejemplo 2 crean una nueva ruta proxy SIP que usa TCP como su transporte; esta nueva ruta luego se agrega a una nueva recopilación de configuración de enrutamiento estático. Para llevar esta acción a cabo, el primer comando en el ejemplo usa New-CsStaticRoute para crear una nueva ruta que apunta al servidor del próximo salto con la dirección IP 192.168.1.100. Esta nueva ruta (almacenada en una variable denominada $x) también usa el puerto 8025 y el patrón MatchUri "sip:*@litwareinc.com".

Después de esto, se llama a New-CsStaticRoutingConfiguration para crear una nueva recopilación (con el parámetro Identity service:Registrar:atl-cs-001.litwareinc.com), lo que asigna la ruta almacenada en la variable $x a la propiedad Route de la nueva recopilación.