Compartir a través de

  • Artículo

Set-CsNetworkInterRegionRoute

 

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

Modifica una ruta existente que conecta las regiones de red dentro de una configuración de control de admisión de llamadas (CAC).

Sintaxis

Set-CsNetworkInterRegionRoute [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-NetworkRegionID1 <String>] [-NetworkRegionID2 <String>] [-NetworkRegionLinkIDs <String>] [-NetworkRegionLinks <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Set-CsNetworkInterRegionRoute [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-NetworkRegionID1 <String>] [-NetworkRegionID2 <String>] [-NetworkRegionLinkIDs <String>] [-NetworkRegionLinks <PSListModifier>] [-WhatIf [<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 además 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 modifica esa asociación de rutas.

Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Set-CsNetworkInterRegionRoute localmente: 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-CsNetworkInterRegionRoute"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

XdsGlobalRelativeIdentity

El identificador único de la ruta de región de red que se desea modificar. 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. En cambio, contiene una cadena que es un nombre único que identifica esa ruta.

Instance

Opcional

InterNetworkRegionRouteType

Una referencia de objeto a una ruta de región existente. Este objeto debe ser del tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.InterNetworkRegionRouteType, que se puede recuperar al llamar al cmdlet Get-CsNetworkInterRegionRoute.

NetworkRegionID1

Opcional

Cadena de caracteres

La Identity (NetworkRegionID) de una de las dos regiones conectadas a través de esta ruta. El valor pasado a este parámetro debe ser una región diferente del valor del parámetro NetworkRegionID2. (En otras palabras, no se puede enrutar una región a sí misma). Además, la combinación de NetworkRegionID1 y NetworkRegionID2 debe ser única (por ejemplo, no puede tener dos rutas definidas que conecten NorthAmerica y EMEA).

NetworkRegionID2

Opcional

Cadena de caracteres

La Identity (NetworkRegionID) de una de las dos regiones conectadas a través de esta ruta. El valor pasado a este parámetro debe ser una región diferente del valor del parámetro NetworkRegionID1. (En otras palabras, no se puede enrutar una región a sí misma). Además, la combinación de NetworkRegionID1 y NetworkRegionID2 debe ser única (por ejemplo, no puede tener dos rutas definidas que conecten NorthAmerica y EMEA).

NetworkRegionLinkIDs

Opcional

Cadena de caracteres

Permite especificar todos los vínculos para esta ruta como una cadena de valores separados por coma. Los valores son las identidades (NetworkRegionLinkIDs) de los vínculos de región. Si escribe valores para ambos parámetros, NetworkRegionLinkIDs y NetworkRegionLinks, no se tendrá en cuenta NetworkRegionLinkIDs. Todos los vínculos modificados con este parámetro remplazarán todos los vínculos existentes en la ruta.

NetworkRegionLinks

Opcional

Modificador de lista PS

Un objeto de lista que contiene las identidades (NetworkRegionLinkIDs) de los vínculos de región que se aplican a esta ruta. Para este cmdlet, este parámetro difiere de NetworkRegionLinkIDs en que, además de permitirle remplazar todos los vínculos existentes para esta ruta, usted puede agregar o quitar vínculos específicos.

Force

Opcional

Parámetro modificador

Suprime las solicitudes de confirmación que, de lo contrario, se mostrarí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 entradas transferidas de objetos de ruta interregional de red.

Tipos de valores devueltos

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

Ejemplo

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

Set-CsNetworkInterRegionRoute -Identity NA_APAC_Route -NetworkRegionLinkIDs "NA_SA,SA_APAC"

Este ejemplo modifica la ruta NA_APAC_Route al cambiar los vínculos de región que se recorrerán en la ruta. El parámetro NetworkRegionLinkIDs se usa con un valor de “NA_SA,SA_APAC”, que reemplaza todos los vínculos existentes con el especificado en esa cadena.

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

Set-CsNetworkInterRegionRoute -Identity NA_APAC_Route -NetworkRegionLinks @{add="SA_EMEA"}

Como el Ejemplo 1, el Ejemplo 2 modifica los vínculos dentro de la ruta NA_APAC_Route. No obstante, en este ejemplo, en lugar de reemplazar todos los vínculos para esa ruta mediante el parámetro NetworkRegionLinkIDs, se usa el parámetro NetworkRegionLinks para agregar un vínculo a la lista de vínculos que ya existen en esa ruta. En este caso, el vínculo SA_EMEA se agrega a la ruta. La sintaxis @{add=<link>} agrega un elemento a la lista de vínculos. Además, puede usar la sintaxis @{replace=<link>} para reemplazar los vínculos existentes por aquellos especificados por <vínculo> (que, esencialmente, se comporta de la misma manera que si se usa NetworkRegionLinkIDs) o la sintaxis @{remove=<link>} para quitar un vínculo de la lista.

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

Set-CsNetworkInterRegionRoute -Identity NA_Route5 -NetworkRegionID2 SouthAmerica -NetworkRegionLinkIDs "NA_SA,SA_APAC"

El Ejemplo 3 modifica la ruta denominada NA_Route5. Este ejemplo cambia una de las regiones que incluye esta ruta. El parámetro NetworkRegionID2 se usa para especificar una nueva región, y por lo tanto, el parámetro NetworkRegionLinkIDs se usa para crear una nueva lista de vínculos que conectan las regiones de esta ruta.