Compartir a través de

  • Artículo

Set-CsNetworkRegion

 

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

Modifica una región de red existente. Las regiones de red representan concentradores de red o redes troncales dentro de la red de una empresa.

Sintaxis

Set-CsNetworkRegion [-Identity <XdsGlobalRelativeIdentity>] [-AudioAlternatePath <$true | $false>] [-BWAlternatePaths <PSListModifier>] [-BypassID <String>] [-CentralSite <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-VideoAlternatePath <$true | $false>] [-WhatIf [<SwitchParameter>]]

Set-CsNetworkRegion [-AudioAlternatePath <$true | $false>] [-BWAlternatePaths <PSListModifier>] [-BypassID <String>] [-CentralSite <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-VideoAlternatePath <$true | $false>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Una región de red interconecta varias partes de una red a través de varias zonas geográficas. Cada región de red debe estar asociada con un sitio central. El sitio central es el sitio del centro de datos donde se está ejecutando el servicio de directiva de ancho de banda de CAC (control de admisión de llamadas). Use este cmdlet para modificar una región de red existente, incluidas las opciones que determinan si están permitidas las rutas de acceso alternativas para las conexiones de audio y vídeo, y que asocian los sitios de la región con una configuración de omisión de medios.

Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Set-CsNetworkRegion de manera local: RTCUniversalServerAdmins. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC), se ha asignado este cmdlet (incluidos los roles RBAC que haya creado usted mismo) para ejecutar el siguiente comando desde el símbolo del sistema de Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsNetworkRegion\b"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

XdsGlobalRelativeIdentity

El identificador único de la región de red que quiere modificar. El valor de Identity tendrá el formato de una cadena de caracteres que identifica de forma única la región.

Instance

Opcional

PSObject

Una referencia a un objeto de región de red. Este objeto debe ser del tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkRegionType y puede recuperarse llamando a Get-CsNetworkRegion.

AudioAlternatePath

Opcional

Booleano

Este parámetro determina si las llamadas de audio se enrutarán a través de una ruta de acceso alternativa si no existe ancho de banda adecuado en la ruta de acceso principal.

Este parámetro rellana la propiedad BWAlternatePaths. El valor proporcionado para este parámetro está almacenado en la propiedad AlternatePath para el elemento de ruta de acceso alternativa con el valor Audio para BWPolicyModality.

Si proporciona un valor para este parámetro, no podrá especificar ningún valor para el parámetro BWAlternatePaths.

Si alguna de las llamadas serán llamadas por Internet, este valor debe ser True, independientemente de la configuración de ancho de banda.

BWAlternatePaths

Opcional

Modificador de lista PS

Una lista de objetos que contienen información sobre si están permitidas las rutas de conexión alternativas si no se puede completar una solicitud de medios con la ruta de acceso preferida (por ejemplo, si se han excedido los límites en la ruta de acceso en cuestión). Los objetos de ruta de acceso alternativa deben ser del tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.BWAlternatePathType. Puede crear objetos de este tipo llamando al cmdlet New-CsNetworkBWAlternatePath.

BypassID

Opcional

Cadena de caracteres

Un identificador único global (GUID). Este GUID se usa para asignar regiones de red a opciones de omisión de medios de una configuración de red CAC o E99-1 (Enhanced 9-1-1). (Use este valor de BypassID para llamar a New-CsNetworkMediaBypassConfiguration.)

Este parámetro se puede generar automáticamente al crear la región (llamando al cmdlet New-CsNetworkRegion). No se recomienda cambiar este valor. Si especifica un valor, debe estar en el formato de un GUID (por ejemplo, 3b24a047-dce6-48b2-9f20-9fbff17ed62a). Recibirá una confirmación donde se le indicará que compruebe si realmente quiere definir este valor manualmente.

CentralSite

Opcional

Cadena de caracteres

El sitio central donde se ejecuta el servicio de directiva de ancho de banda. Este servicio debe habilitarse para usar el CAC. Este servicio se ejecuta en el Servidor front-end o el Servidor Standard Edition.

Description

Opcional

Cadena de caracteres

Una cadena de caracteres que describe la región. Este parámetro se puede usar para proporcionar una explicación más descriptiva sobre la utilidad de la región que puede expresarse mediante el valor de Identity por sí solo.

VideoAlternatePath

Opcional

Booleano

Este parámetro determina si las llamadas de vídeo se enrutarán a través de una ruta de acceso alternativa si no existe ancho de banda adecuado en la ruta de acceso principal.

Este parámetro rellana la propiedad BWAlternatePaths. El valor proporcionado para este parámetro está almacenado en la propiedad AlternatePath para el elemento de ruta de acceso alternativa con el valor Video para BWPolicyModality.

Si proporciona un valor para este parámetro, no podrá especificar ningún valor para el parámetro BWAlternatePaths.

Si alguna de las llamadas serán llamadas por Internet, este valor debe ser True, independientemente de la configuración de ancho de banda.

Force

Opcional

Parámetro modificador

Suprime los mensajes 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.NetworkRegionType. Acepta datos transferidos de objetos de región de red.

Tipos de valores devueltos

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

Ejemplo

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

Set-CsNetworkRegion -Identity NorthAmerica -Description "North American Region"

En este ejemplo se modifica la región de red denominada NorthAmerica. Se especifica el valor "North American Region" para el parámetro Description. Si ya existía una descripción en la región NorthAmerica, este comando la sobrescribirá con el nuevo valor. Si no se había definido ninguna descripción, el comando la definirá.

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

Set-CsNetworkRegion -Identity EMEA -VideoAlternatePath $False

En este ejemplo se modifica la región de red denominada EMEA y se especifica un nuevo valor de ruta de vídeo alternativa. Para ello, se llama a Set-CsNetworkRegion y se le envía el valor de Identity EMEA. A continuación, se especifica el parámetro VideoAlternatePath, enviando el valor $False. Al definir VideoAlternatePath en False, se indica que, si el ancho de banda adecuado no está disponible, la llamada de vídeo no se enrutará a una ruta de acceso alternativa y no se completará.

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

$a = Get-CsNetworkRegion -Identity NorthAmerica
$a.BWAlternatePaths | foreach {Set-CsNetworkRegion -Identity Asia -BWAlternatePaths @{add=$_}}

En el ejemplo 3 se asigna el mismo conjunto de opciones de ruta alternativa que se ha definido para la región NorthAmerica a la región de red Asia. En la primera línea del ejemplo se recupera una instancia de la región de red NorthAmerica y se asigna a la variable $a. En la segunda línea, se empieza recuperando el contenido de la propiedad BWAlternatePaths o de la región NorthAmerica (almacenado en la variable $a): $a.BWAlternatePaths. Se tratará de una recopilación de todas las opciones de ruta alternativa de la región NorthAmerica.

El siguiente paso consiste en transferir la recopilación de configuraciones a la función foreach. Foreach pasará por cada uno de los elementos de la recopilación y realizará las acciones que se encuentran dentro de las llaves sucesivas. En este caso, la acción consiste en llamar a Set-CsNetworkRegion con el valor Asia para Identity para establecer las propiedades de la región Asia. El parámetro siguiente es BWAlternatePaths. Enviamos el valor @{add=$_} a este parámetro. La variable $_ representa el elemento actual de la recopilación, en este caso se trata de la ruta de acceso alternativa actual. La parte @{add=} del valor agrega el elemento a la recopilación de BWAlternatePaths para la región Asia.