Compartir a través de

  • Artículo

Set-CsStaticRoutingConfiguration

 

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

Modifica una recopilación de existente de configuraciones de enrutamiento estático.

Sintaxis

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

Set-CsStaticRoutingConfiguration [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-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; 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 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 forma dinámica si se produce un error de red.

Al instalar Microsoft Lync Server 2010, se crea una recopilación global de opciones de configuración de rutas estáticas automáticamente. (Se crea la recopilación, pero no hay rutas asignadas a esa recopilación). Además, el software le permite crear recopilaciones adicionales aplicados al ámbito de servicio (estas recopilaciones nuevas solo se pueden asignar al servicio Registrar). El cmdlet Set-CsStaticRoutingConfiguration le permite modificar los valores de propiedades de una recopilación de enrutamientos estáticos existentes. Eso significa que puede usar el cmdlet para agregar nuevas rutas a una recopilación o eliminar rutas existentes de una recopilación.

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identidad Xds

Identificador único de la recopilación de configuración de enrutamiento estático a modificar. Para modificar la recopilación global, use esta sintaxis: -Identity global. Para modificar una recopilación aplicada al ámbito de servicios, use una sintaxis similar a la siguiente: -Identity "service:Registrar:atl-cs-001.litwareinc.com". No puede usar comodines al especificar la identidad.

Si este parámetro no está incluido, Set-CsStaticRoutingConfiguration modificará automáticamente la recopilación global.

Instance

Opcional

Objeto RoutingSettings

Permite enviar una referencia a un objeto al cmdlet, en lugar de definir valores de parámetros individuales.

Route

Opcional

Modificador de lista PS

Rutas estáticas individuales mantenidas dentro de la recopilación. Las rutas que se agregan a la recopilación se deben copiar de otra recopilación o se deben crear con el cmdlet New-CsStaticRoute; para eliminar una ruta de una recopilación, primero se debe crear un objeto que haga referencia a esa ruta. Para obtener más información, vea la sección Ejemplos del tema de ayuda.

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.

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

Objeto Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.RoutingSettings. Set-CsStaticRoutingConfiguration acepta las instancias canalizadas del objeto de la configuración de enrutamiento estático.

Tipos de valores devueltos

Set-CsStaticRoutingConfiguration no devuelve ningún valor ni objeto. En su lugar, el cmdlet configura instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.RoutingSettings.

Ejemplo

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

$x = Get-CsStaticRoutingConfiguration -Identity global | Select-Object -ExpandProperty Route | Where-Object {$_.MatchUri -eq "litwareinc.com" -and $_.MatchOnlyPhoneUri -eq $True}

Set-CsStaticRoutingConfiguration -Identity service:Registrar:atl-cs-001.litwareinc.com -Route @{Add=$x}

Los comandos que se muestran en el Ejemplo 1 copian una ruta de la recopilación de enrutamiento estático global y después asignan esa ruta a una segunda recopilación de enrutamiento estático (aquella con Identity service:Registrar:atl-cs-001.litwareinc.com). Para realizar esta tarea, el primer comando del ejemplo se conecta a la recopilación global y devuelve una referencia de objetos a la ruta con MatchUri litwareinc.com y un MatchOnlyPhoneUri igual a True.

Para ello, el comando llama a Get-CsStaticRoutingConfiguration para devolver información de la recopilación de configuración estática de enrutamiento global. Estos datos después se canalizan al cmdlet Select-Object, que usa el parámetro -ExpandProperty para expandir los valores de la propiedad Route. Esos valores expandidos (que representan las rutas individuales asignadas a la recopilación) después se canalizan al cmdlet Where-Object, que elige solo la única ruta donde la propiedad MarchUri es igual a litwareinc.com y la propiedad MatchOnlyPhoneUri es igual a True. La ruta devuelta se almacena en una variable denominada $x.

Después de recuperar la ruta, el segundo comando del ejemplo agrega esa ruta al servicio: recopilación Registrar:atl-cs-001.litwareinc.com. Para ello, se llama a Set-CsStaticRoutingConfiguration junto con el parámetro Route; el valor del parámetro @{Add=$x} le indica a Set-CsStaticRoutingConfiguration que anexe la ruta almacenada en la variable $x a la recopilación de rutas mantenidas en la propiedad Route.

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

$x = Get-CsStaticRoutingConfiguration -Identity service:Registrar:atl-cs-001.litwareinc.com | Select-Object -ExpandProperty Route | Where-Object {$_.MatchUri -eq "litwareinc.com" -and $_.MatchOnlyPhoneUri -eq $True}

Set-CsStaticRoutingConfiguration -Identity service:Registrar:atl-cs-001.litwareinc.com -Route @{Remove=$x}

Los comandos anteriores eliminan una ruta de la recopilación de enrutamiento estático. Para ello, el primer comando del ejemplo se conecta a la recopilación con Identity service:Registrar:atl-cs-001.litwareinc.com y devuelve una referencia de objetos a la ruta con MatchUri litwareinc.com y un MatchOnlyPhoneUri igual a True. Para ello, el comando llama a Get-CsStaticRoutingConfiguration para devolver información de la recopilación service:Registrar:atl-cs-001.litwareinc.com. Estos datos después se canalizan al cmdlet Select-Object, que usa el parámetro ExpandProperty para expandir los valores de la propiedad Route. Esos valores expandidos (que representan las rutas individuales asignadas a la recopilación) después se canalizan al cmdlet Where-Object, que elige solo la única ruta donde la propiedad MarchUri es igual a litwareinc.com y la propiedad MatchOnlyPhoneUri es igual a True. La ruta devuelta después se almacena en una variable denominada $x.

Después de haber recuperado la ruta, el segundo comando elimina esa ruta de la recopilación. Para ello, se llama a Set-CsStaticRoutingConfiguration junto con el parámetro Route; el valor del parámetro @{Remove=$x} le indica a Set-CsStaticRoutingConfiguration que elimine la ruta almacenada en la variable $x.

-------------------------- Ejemplo 3 --------------------------

Set-CsStaticRoutingConfiguration -Identity service:Registrar:atl-cs-001.litwareinc.com -Route $Null

En el Ejemplo 3 se muestra cómo puede quitar todas las rutas asignadas a la recopilación de configuración de enrutamiento estático. Para ello, simplemente incluya el parámetro Route y establezca el valor del parámetro en Null. Después de completar el comando, la recopilación seguirá existiendo, pero ya no tendrá rutas asignadas a esta.