Compartir a través de

  • Artículo

New-CsNetworkInterRegionRoute

 

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

Crea una nueva ruta para conectar regiones de red dentro de una configuración de control de admisión de llamadas (CAC).

Sintaxis

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

New-CsNetworkInterRegionRoute -InterNetworkRegionRouteID <String> -NetworkRegionID1 <String> -NetworkRegionID2 <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-NetworkRegionLinkIDs <String>] [-NetworkRegionLinks <PSListModifier>] [-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 crea esa asociación de rutas.

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

XdsGlobalRelativeIdentity

Un identificador único para la ruta regional de red recién creada. 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.

InterNetworkRegionRouteID

Requerido

Cadena de caracteres

Este valor es el mismo que la Identidad. No se pueden especificar ambos parámetros, Identity e InterNetworkRegionRouteID; el valor que se introduzca para uno de ellos se usará en ambos.

NetworkRegionID1

Requerido

Cadena de caracteres

La Identidad (NetworkRegionID) de una de las dos regiones conectadas mediante esta ruta. El valor que se pase a este parámetro debe ser una región distinta del valor del parámetro NetworkRegionID2. Es decir, 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 se pueden tener dos rutas definidas para conectar Norteamérica y EMEA).

NetworkRegionID2

Requerido

Cadena de caracteres

La Identidad (NetworkRegionID) de una de las dos regiones conectadas mediante esta ruta. El valor que se pase a este parámetro debe ser una región distinta del valor del parámetro NetworkRegionID1. Es decir, 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 se pueden tener dos rutas definidas para conectar Norteamérica y EMEA).

NetworkRegionLinkIDs

Opcional

Cadena de caracteres

Permite especificar todos los vínculos de esta ruta como una cadena de valores separados por comas. Los valores son las identidades (NetworkRegionLinkIDs) de los vínculos regionales. Si introduce valores para ambos parámetros, NetworkRegionLinkIDs y NetworkRegionLinks, no se tendrá en cuenta NetworkRegionLinkIDs. Este parámetro permite especificar cómodamente la lista de vínculos, sin tener que construir un objeto de lista y pasarlo al parámetro NetworkRegionLinks.

NetworkRegionLinks

Opcional

Modificador de lista PS

Un objeto de lista que contiene las identidades (NetworkRegionLinkIDs) de los vínculos regionales que se aplican a esta ruta. Para este cmdlet, este parámetro solo difiere del parámetro NetworkRegionLinkIDs en el formato, si introduce más de un vínculo. Se recomienda usar el parámetro NetworkRegionLinkIDs para definir la lista inicial con este cmdlet.

Force

Opcional

Parámetro modificador

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

InMemory

Opcional

Parámetro modificador

Crea una referencia de objeto sin confirmar realmente el objeto como cambio permanente. Si se asigna la salida de este cmdlet llamado con este parámetro en una variable, puede realizar cambios en las propiedades de la referencia del objeto y después confirmar estos cambios, llamando a este conjunto coincidente de cmdlet, - cmdlet.

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

Ninguno.

Tipos de valores devueltos

Crea un objeto de tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.InterNetworkRegionRouteType.

Ejemplo

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

New-CsNetworkInterRegionRoute -Identity NA_APAC_Route -NetworkRegionID1 NorthAmerica -NetworkRegionID2 APAC -NetworkRegionLinkIDs "NA_EMEA,EMEA_APAC"

En el Ejemplo 1 se crea una nueva ruta regional de red entre la región de NorthAmerica y la de APAC. Damos a la nueva ruta la Identidad NA_APAC_Route. Este nombre se asignará automáticamente como InterNetworkRegionRouteID. Las regiones conectadas son NorthAmerica, que se pasa como valor del parámetro NetworkRegionID1, y APAC, que se pasa como valor del parámetro NetworkRegionID2. En este ejemplo suponemos que no hay ningún vínculo regional directo configurado entre NorthAmerica y APAC. Sin embargo, sí que hay vínculos de NorthAmerica a EMEA (NA_EMEA), y de EMEA a APAC (EMEA_APAC). Usamos ambos vínculos, separados por comas, como valor del parámetro NetworkRegionLinkIDs. Esta acción enrutará las conexiones de NorthAmerica a APAC a través de EMEA, y aplicará las limitaciones de ancho de banda para las conexiones de audio y vídeo asociadas a esos vínculos.