Compartir a través de


Remove-CsNetworkInterRegionRoute

 

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

Quita una ruta que conecte regiones de red dentro de una configuración de control de admisión de llamadas (CAC).

Sintaxis

Remove-CsNetworkInterRegionRoute -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Todas las regiones con configuraciones CAC deben tener alguna manera de obtener acceso a las demás 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 la ruta de acceso vinculada que atravesará la conexión de una región a otra. Este cmdlet quita una de esas asociaciones de rutas.

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

XdsGlobalRelativeIdentity

El identificador único de la ruta de región de red que se quiere quitar. Dado que las rutas regionales de red se crean únicamente en el ámbito global, este identificador no necesita especificar el ámbito. Por el contrario, contiene una cadena que consiste en un nombre único que identifica la ruta.

Force

Opcional

Parámetro modificador

Suprime las preguntas de confirmación que aparecerían antes de realizar cambios.

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.NetworkConfiguration.InterNetworkRegionRouteType. Acepta la entrada transferida de objetos de ruta interregional de red.

Tipos de valores devueltos

Este cmdlet no devuelve un valor. Quita un objeto de tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.InterNetworkRegionRouteType.

Ejemplo

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

Remove-CsNetworkInterRegionRoute -Identity NA_APAC_Route

En el Ejemplo 1 se quita la ruta con Identidad NA_APAC_Route.

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

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

En el Ejemplo 2 se quitan todas las rutas regionales que incluyen la región NorthAmerica. La primera parte del comando es una llamada al cmdlet Get-CsNetworkInterRegionRoute. Este cmdlet, al que se llama sin parámetros, recuperará todas las rutas regionales. A continuación, esta colección de rutas se transfiere al cmdlet Where-Object. El cmdlet Where-Object filtrará la colección para incluir solo las rutas que tienen definida NorthAmerica como una de las regiones de la ruta. Para hacerlo, comprueba si la ruta tiene un valor de NetworkRegionID1 igual a (-eq) NorthAmerica, o (-or) un valor de NetworkRegionID2 igual a NorthAmerica. Cuando la colección contiene solo las rutas que incluyen la región NorthAmerica, transferimos la colección a Remove-CsNetworkInterRegionRoute, que quita cada una de las rutas.