Compartir a través de

  • Artículo

Remove-CsStaticRoutingConfiguration

 

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

Quita la colección especificada de las opciones de configuración de enrutamiento estático.

Sintaxis

Remove-CsStaticRoutingConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-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 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. El inconveniente de las rutas estáticas es que, si se produce un error en la red, los mensajes no se vuelven a enrutar dinámicamente.

Al instalar Microsoft Lync Server 2010, se crea una colección global de rutas estáticas creadas automáticamente para usted. (La colección se crea, pero no hay rutas asignadas a dicha colección). Además, el software permite crear más colecciones aplicadas al ámbito de servicio (las colecciones nuevas solo se pueden asignar al servicio registrador). Si, más tarde, cambia de idea, puede usar el cmdlet Remove-CsStaticRoutingConfiguration para eliminar las recopilaciones que se aplican al ámbito de servicio.

También puede ejecutar Remove-CsStaticRoutingConfiguration para toda la colección. Sin embargo, en ese caso no se quitará la colección global; Lync Server 2010 no permite quitar recopilaciones globales. En su lugar, todas las propiedades de la colección global se restablecerán con los valores predeterminados. Esto implica que se eliminarán todas las rutas asignadas a la colección global.

Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Remove-CsStaticRoutingConfiguration de forma local: RTCUniversalServerAdmins. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC) a los que se ha asignado este cmdlet (incluido cualquier otro rol RBAC personalizado que usted mismo haya creado), ejecute el siguiente comando desde Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsStaticRoutingConfiguration"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Identidad Xds

Identificador único de la colección de configuraciones de enrutamiento estático que se quitará. Para quitar una colección configurada en el ámbito de servicio, use la sintaxis del siguiente ejemplo: -Identity "service:Registrar:atl-cs-001.litwareinc.com".

También se puede ejecutar Remove-CsStaticRoutingConfiguration en la colección global; para hacerlo, utilice esta sintaxis: -Identity global. Sin embargo, recuerde que la colección global no se puede quitar realmente. En su lugar, las propiedades de esa colección se restablecerán a sus valores predeterminados. Esto significa que todos los elementos de la propiedad Route serán eliminados.

Force

Opcional

Parámetro modificador

Suprime la visualización de los mensajes de error que no sean graves y que puedan ocurrir 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. Remove-CsStaticRoutingConfiguration acepta las instancias transmitidas del objeto de configuración de enrutamiento estático.

Tipos de valores devueltos

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

Ejemplo

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

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

El comando del Ejemplo 1 elimina la colección de configuración de enrutamiento estático que tiene la identidad service:Registrar:atl-cs-001.litwareinc.com.

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

Get-CsStaticRoutingConfiguration -Filter "service:*" | Remove-CsStaticRoutingConfiguration

En el Ejemplo 2 se eliminan todas las colecciones de configuraciones de enrutamiento estático que se aplican al ámbito de servicio. Para ello, el comando empieza por utilizar Get-CsStaticRoutingConfiguration y el parámetro Filter; el valor de filtro "service:*" limita los datos devueltos para incluir solo las recopilaciones cuya identidad empiece con el valor de cadena "service:". A continuación, la colección filtrada se transfiere a Remove-CsStaticRoutingConfiguration, que elimina cada elemento de la colección.

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

Get-CsStaticRoutingConfiguration | Where-Object {$_.Route.Count -eq 0} | Remove-CsStaticRoutingConfiguration

En el Ejemplo 3 se muestra cómo eliminar todas las colecciones de configuraciones de enrutamiento estático a las que no se ha asignado ninguna ruta real. Para realizar esta tarea, el comando llama primero a Get-CsStaticRoutingConfiguration; esta acción devuelve información sobre todas las recopilaciones de enrutamiento estático que está usando la organización. A continuación, la colección se transfiere al cmdlet Where-Object, que extrae solo las colecciones cuyo número de rutas (Route.Count) es igual a 0. Después se transfiere la información filtrada a Remove-CsStaticRoutingConfiguration, que elimina todas las recopilaciones a las que no se haya asignado al menos una ruta.