New-CsNetworkRegion

 

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

Crea una nueva región de red. Las regiones de red representan concentradores o redes troncales de red en una red de empresa.

Sintaxis

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

New-CsNetworkRegion -CentralSite <String> -NetworkRegionID <String> [-AudioAlternatePath <$true | $false>] [-BWAlternatePaths <PSListModifier>] [-BypassID <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-VideoAlternatePath <$true | $false>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Una región de red interconecta varias partes de una red en múltiples áreas 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 control de admisión (CAC). Use este cmdlet para crear una nueva región de red. Los parámetros de este cmdlet permiten proporcionar configuraciones que determinan si se pueden usar rutas alternativas vía Internet para conexiones de audio y vídeo; además, pueden generar el Id. secundario automáticamente.

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

Parámetros

Parámetro	Requerido	Tipo	Descripción
Identity	Requerido	XdsGlobalRelativeIdentity	Un identificador único para la nueva región de red creada. Las regiones se crean solo en el ámbito global, entonces no es necesario que este identificador especifique un ámbito. En su lugar, contiene una cadena que es un nombre único que identifica esa región.
CentralSite	Requerido	Cadena de caracteres	El sitio central que ejecuta el servicio de directiva de ancho de banda. Este servicio debe habilitarse para usar CAC. Este servicio se ejecuta en el Servidor front-end o en el Servidor Standard Edition.
NetworkRegionID	Requerido	Cadena de caracteres	El valor es el mismo que el valor Identity. No puede especificar un valor Identity y NetworkRegionID; un valor escrito para uno se usará automáticamente para ambos.
AudioAlternatePath	Opcional	Booleano	Este parámetro determina si las llamadas de audio se enrutarán a través de una ruta alternativa si no existe un ancho de banda adecuado en la ruta primaria. Este parámetro se rellena con 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 un valor BWPolicyModality de Audio. Si proporciona un valor para este parámetro, no podrá especificar ningún valor para el parámetro BWAlternatePaths. Valor predeterminado: True. Establezca este parámetro en el valor False solamente si necesita cancelar la descarga de Internet. 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 contiene información sobre si se permiten las rutas de conexión de Internet alternativas si una solicitud de medios es incapaz de completar la ruta preferida (por ejemplo, si se han superado los límites en esa ruta). Los objetos de rutas de acceso alternativas se deben crear mediante el llamado del cmdlet New-CsNetworkBWAlternatePath. Si suministra un valor para este parámetro, no puede especificar valores de suministro para los parámetros AudioAlternatePath o VideoAlternatePath . Las rutas alternativas para audio y vídeo están habilitadas (AlternatePath = True) en forma predeterminada.
BypassID	Opcional	Cadena de caracteres	Un identificador único global (GUID). Este GUID se usa para asignar regiones de red a configuraciones de omisión de medios de una configuración de red de CAC o 9-1-1 mejorado (E9-1-1). (Use este valor de BypassID en el llamado a New-CsNetworkMediaBypassConfiguration). Si usted especifica un valor para este parámetro, un valor se generará automáticamente. Si especifica un valor, debe ser en el formato de un GUID (por ejemplo, 3b24a047-dce6-48b2-9f20-9fbff17ed62a). Se recomienda la autogeneración. Si suministra un valor para este parámetro, recibirá una solicitud de confirmación preguntándole si realmente desea suministrar este valor en lugar de permitirle autogenerarse.
Description	Opcional	Cadena de caracteres	Una cadena que describe la región. Este parámetro puede usarse para proporcionar una explicación más descriptiva del propósito de la región que puede expresarse solamente con el valor Identity.
VideoAlternatePath	Opcional	Booleano	Este parámetro determina si las llamadas de vídeo se enrutarán a través de una ruta alternativa si no existe un ancho de banda adecuado en la ruta primaria. Este parámetro se rellena con 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 un valor BWPolicyModality de Vídeo. Si suministra un valor para este parámetro, no puede especificar un valor para el parámetro BWAlternatePaths. Valor predeterminado: True. Establezca este parámetro en el valor False solamente si necesita cancelar la descarga de Internet. 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 las solicitudes de confirmación que, de lo contrario, se mostrarían antes de realizar cambios. Por ejemplo, si suministra un valor en el parámetro BypassID, no se le solicitará confirmación.
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 tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkRegionType.

Ejemplo

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

New-CsNetworkRegion -Identity NorthAmerica -Description "All North American Locations" -CentralSite Redmond-NA-MLS

En este ejemplo, se crea una nueva región de red llamada NorthAmerica. El nombre de región se especifica como el valor para el parámetro Identity. También se especifica un valor para el parámetro Description opcional, que describe esta región como compuesta por “All North American Locations”. Finalmente, el parámetro CentralSite recibe un valor del nombre del sitio central para esta región, Redmond-NA-MCS.

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

New-CsNetworkRegion -Identity EMEA -CentralSite Dublin-EU-Site -AudioAlternatePath $False

Este ejemplo crea una nueva región de red llamada EMEA que incluye configuraciones para una ruta alternativa de audio. Para llevar a cabo esta acción, llamamos a New-CsNetworkRegion, lo que transfiere un parámetro Identity de EMEA. Asignamos un valor para el parámetro CentralSite requerido (en este ejemplo, el nombre del sitio central para esta región es Dublin-EU-Site), a continuación, especificamos el parámetro AudioAlternatePath, que transfiere el valor $False. La configuración de AudioAlternatePath en el valor False indica si el ancho de banda correspondiente no está disponible; las llamadas de audio no se enrutarán a una ruta de acceso alternativa, ya que, en cambio, simplemente no se completarán.

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

$a = New-CsNetworkBWAlternatePath -BWPolicyModality "audio" -AlternatePath $False
New-CsNetworkRegion -Identity EMEA -CentralSite Dublin-EU-Site -BWAlternatePaths $a

Este ejemplo crea la misma región de red que se creó en el Ejemplo 2. Sin embargo, en este caso, usamos el parámetro BWAlternatePaths para definir configuraciones de ruta alternativa, en lugar del parámetro AudioAlternatePath. En la primera línea del ejemplo, se llama al cmdlet New-CsNetworkBWAlternatePath para crear una nueva ruta de acceso alternativa. Una ruta alternativa tiene solo dos propiedades: BWPolicyModality, que debe configurarse como audio o vídeo (audio, en este ejemplo); y AlternatePath, que debe tener el valor True o False (False en este ejemplo). Asignamos el resultado desde este cmdlet, una referencia al objeto de ruta alternativa recién creado, hasta la variable $a.

En la línea 2 de este ejemplo, usamos esta nueva ruta de acceso alternativa creada cuando desarrollamos una nueva región de red. Para llevar a cabo esta acción, llamamos a New-CsNetworkRegion, lo que transfiere un parámetro Identity de EMEA. Asignamos un valor para el parámetro CentralSite requerido (en este ejemplo, el nombre del sitio central para esta región es Dublin-EU-Site) y, a continuación, especificamos el parámetro BWAlternatePaths, que transfiere la variable ($a) que contiene el objeto de ruta de acceso alternativa que acabamos de crear.

Vea también

Otros recursos

Remove-CsNetworkRegion
Set-CsNetworkRegion
Get-CsNetworkRegion
New-CsNetworkBWAlternatePath