Compartir a través de

  • Artículo

Get-CsStaticRoutingConfiguration

 

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

Devuelve información sobre la configuración de enrutamiento estático que se usa en la organización.

Sintaxis

Get-CsStaticRoutingConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsStaticRoutingConfiguration [-Filter <String>] [-LocalStore <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). Mediante el cmdlet Get-CsStaticRoutingConfiguration se devuelve información sobre todas las recopilaciones de configuración de enrutamiento estático que se usan en la organización. Incluye la posibilidad de devolver información detallada sobre cada ruta asignada a una colección.

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identidad Xds

Identificador único de la colección de configuración de enrutamiento estático. Para devolver información sobre la colección global, use la siguiente sintaxis: -Identity global. Para recuperar información sobre una colección configurada en el ámbito de servicio, use la sintaxis del siguiente ejemplo: -Identity "service:Registrar:atl-cs-001.litwareinc.com". Tenga en cuenta que no se pueden utilizar comodines al especificar una Identidad. Si necesita usar comodines, utilice el parámetro Filter en su lugar.

Si no incluye los parámetros Identity ni Filter, Get-CsStaticRoutingConfiguration devolverá información sobre todas las recopilaciones de configuración de enrutamiento estático.

Filter

Opcional

Cadena de caracteres

Permite usar comodines al especificar la colección (o colecciones) de configuraciones de enrutamiento estático que se devolverán. Por ejemplo, esta sintaxis devuelve todas las colecciones de enrutamiento estático configuradas en el ámbito de servicio: -Filter "service:*".

Tenga en cuenta que no es posible usar los parámetros Identity y Filter en el mismo comando.

LocalStore

Opcional

Parámetro modificador

Recupera los datos de configuración del enrutamiento estático de la réplica local de Almacén de administración central en lugar de la de Almacén de administración central.

Tipos de entrada

Ninguno. Get-CsStaticRoutingConfiguration no acepta la entrada transferida.

Tipos de valores devueltos

Get-CsStaticRoutingConfiguration devuelve instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.RoutingSettings.

Ejemplo

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

Get-CsStaticRoutingConfiguration

El comando que se muestra en el Ejemplo 1 devuelve información sobre todas las colecciones de configuración de enrutamiento estático que se usan en su organización.

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

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

En el Ejemplo 2, se devuelve información sobre una sola colección de configuración de enrutamiento estático: aquella con la Identidad service:Registrar:atl-cs-001.litwareinc.com.

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

Get-CsStaticRoutingConfiguration -Filter "service:*"

En el Ejemplo 3 se usa el parámetro Filter para devolver información sobre las recopilaciones de configuración de enrutamiento estático asignadas al ámbito de servicio. El valor del filtro "service:*" limita los datos devueltos para incluir solo las colecciones cuya Identidad empiece por "service:".

-------------------------- Ejemplo 4 ------------------------

Get-CsStaticRoutingConfiguration | Select-Object -ExpandProperty Route

El comando anterior devuelve información de ruta detallada sobre todas las colecciones de configuración de enrutamiento estático que se usan en la organización. Para hacerlo, el comando llama primero a Get-CsStaticRoutingConfiguration sin ningún parámetro, para devolver la información completa de cada colección de enrutamiento estático. A continuación, esta información se transfiere al cmdlet Select-Object, que usa el parámetro ExpandProperty para "ampliar" el valor de la propiedad Route. Cuando se amplía una propiedad, todos los objetos y valores incluidos en ella se muestran en pantalla de modo legible.

-------------------------- Ejemplo 5 ------------------------

Get-CsStaticRoutingConfiguration | Select-Object -ExpandProperty Route | Where-Object {$_.MatchOnlyPhoneUri -eq $True}

El comando que se muestra en el Ejemplo 5 devuelve información sobre todas las rutas estáticas configuradas para coincidir únicamente con los identificadores de recursos uniformes (URI) de teléfonos. Para ejecutar esta tarea, el comando llama primero a Get-CsStaticRoutingConfiguration sin ningún parámetro; esta acción devuelve todas las colecciones de configuración de enrutamiento estático y sus rutas asociadas. A continuación, esta información se transfiere al cmdlet Select-Object, que usa ExpandProperty para ampliar todos los objetos almacenados en la propiedad Route. Después, estos objetos de ruta se transfieren al cmdlet Where-Object, que extrae solo las rutas donde la propiedad MatchOnlyPhoneUri es igual a True.