Compartir a través de

  • Artículo

Get-CsNetworkInterRegionRoute

 

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

Recupera una ruta o más que conectan las regiones de red dentro de una configuración de control de admisión de llamadas (CAC, call admission control).

Sintaxis

Get-CsNetworkInterRegionRoute [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]

Get-CsNetworkInterRegionRoute [-Filter <String>] [-LocalStore <SwitchParameter>]

Descripción detallada

Cada región dentro de una configuración CAC debe tener alguna forma de obtener acceso a todas las otras regiones. Mientras que los vínculos regionales establecen las limitaciones de ancho de banda de las conexiones entre regiones y también representan los vínculos físicos, las rutas determinan las vías de acceso vinculadas por las que se desplazará la conexión al pasar de una región a otra. Este cmdlet recupera información sobre estas asociaciones de rutas.

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

XdsGlobalRelativeIdentity

El identificador único para la ruta de región de red que quiere recuperar. Las rutas de región de red se crean solo en el ámbito global; por lo tanto, no es necesario que este identificador especifique un ámbito. Por el contrario, contiene una cadena que consiste en un nombre único que identifica una ruta particular.

Filter

Opcional

Cadena de caracteres

Una cadena que le permite recuperar rutas basándose en la coincidencia de los valores Identity con la cadena con comodín transferida como un valor para este parámetro.

LocalStore

Opcional

Parámetro modificador

Recupera la información de ruta interregional de red de la réplica local de la Almacén de administración central, en lugar de la Almacén de administración central en sí.

Tipos de entrada

Ninguno.

Tipos de valores devueltos

Este cmdlet devuelve uno o más objetos tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.InterNetworkRegionRouteType.

Ejemplo

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

Get-CsNetworkInterRegionRoute -Identity NA_APAC_Route

El Ejemplo 1 recupera la ruta con el valor Identity NA_APAC_Route.

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

Get-CsNetworkInterRegionRoute -Filter *APAC*

En el Ejemplo 2, usamos el parámetro Filter para recuperar todas las rutas que contienen la cadena APAC en cualquier lugar dentro del valor Identity.

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

Get-CsNetworkInterRegionRoute | Where-Object {$_.NetworkRegionLinks -eq "NA_EMEA"}

Este ejemplo recupera todas las rutas de región que usan el vínculo de región de red NA_EMEA. El comando comienza llamando al cmdlet Get-CsNetworkInterRegionRoute. Llamar a este cmdlet sin parámetros recupera todas las rutas definidas con la configuración CAC. Esta recopilación de rutas luego se redirecciona al cmdlet Where-Object. Where-Object recibe la recopilación y recupera todos sus elementos que tienen el valor NA_EMEA en su lista NetworkRegionLinks.

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

Get-CsNetworkInterRegionRoute | Where-Object {$_.NetworkRegionID1 -eq "NorthAmerica" -or $_.NetworkRegionID2 -eq "NorthAmerica"}

El Ejemplo 4 recupera todas las rutas de región que incluyan la región NorthAmerica. La primera parte del comando consiste en un llamado al cmdlet Get-CsNetworkInterRegionRoute. Este cmdlet, al que se llama sin parámetros, recuperará todas las rutas de región. A continuación, esta recopilación de rutas se redirecciona al cmdlet Where-Object. El cmdlet Where-Object limitará la recopilación para incluir sólo las rutas que tienen definida NorthAmerica como una de las regiones de la ruta. Realiza esto controlando si la ruta tiene un valor NetworkRegionID1 igual a (-eq) NorthAmerica o (-or) un valor NetworkRegionID2 igual a NorthAmerica.