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.
Vea también
Otros recursos
Remove-CsNetworkInterRegionRoute
Set-CsNetworkInterRegionRoute
Get-CsNetworkInterRegionRoute