Compartir a través de


New-CsNetworkSite

 

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

Crea un nuevo sitio de red para su uso con un control de admisión de llamadas (CAC) o Enhanced 9-1-1 (E9-1-1).

Sintaxis

New-CsNetworkSite -Identity <XdsGlobalRelativeIdentity> -NetworkRegionID <String> [-BWPolicyProfileID <String>] [-BypassID <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-LocationPolicy <String>] [-WhatIf [<SwitchParameter>]]

New-CsNetworkSite -NetworkRegionID <String> -NetworkSiteID <String> [-BWPolicyProfileID <String>] [-BypassID <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-LocationPolicy <String>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Los sitios de red son las oficinas o ubicaciones configuradas dentro de cada región de una implementación de E9-1-1 o CAC. Este cmdlet crea un nuevo sitio y, opcionalmente, lo asocia a una región. Por ejemplo, una región de red para Norteamérica se podría asociar con sitios de red como Chicago, Redmond y Vancouver. Debe crearse un sitio de red CAC para cada sitio de una organización, incluso aunque no tenga limitaciones de ancho de banda.

Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet New-CsNetworkSite localmente: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en rol (RBAC), este rol se ha asignado (así como cualquier otro rol RBAC personalizado que haya creado) para ejecutar el siguiente comando desde el símbolo del sistema Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsNetworkSite"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

XdsGlobalRelativeIdentity

Identificador único para el sitio de red recién creado. Dado que los sitios de red se crean únicamente en el ámbito global, este identificador no necesita especificar el ámbito. En su lugar, contiene una cadena que es única en todos los sitios de red de la implementación de Microsoft Lync Server 2010.

NetworkRegionID

Requerido

Cadena de caracteres

La Identidad de la región de la red a la que está asociado este sitio. Este parámetro debe contener un valor si desea facilitar un BypassID (ya sea por autogeneración o manualmente) o si la propiedad EnableBandwidthPolicyCheck de la configuración de red es True. Para recuperar las opciones de configuración de red, llame al cmdlet Get-CsNetworkConfiguration.

NetworkSiteID

Requerido

Cadena de caracteres

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

BWPolicyProfileID

Opcional

Cadena de caracteres

Identidad del perfil de la directiva de ancho de banda que define las limitaciones de ancho de banda aplicables a este sitio. Puede recuperar una lista de los perfiles disponibles llamando al cmdlet Get-CsNetworkBandwidthPolicyProfile.

Si especifica un valor para este parámetro, debe especificar también un valor para el parámetro NetworkRegionID.

BypassID

Opcional

Cadena de caracteres

Un identificador único global (GUID). Este GUID se usará para asignar sitios de red a valores de desvío de medios en una configuración de red de CAC o de E9-1-1. (Use este valor de BypassID para llamar a New-CsNetworkMediaBypassConfiguration.)

Si no especifica un valor para este parámetro, se generará uno automáticamente, pero sólo si suministra un valor para el parámetro NetworkRegionID. Si no suministra el parámetro NetworkRegionID, no se generará ningún BypassID. Tampoco podrá suministrar de manera explícita un valor para el parámetro BypassID sin proporcionar un valor para el parámetro NetworkRegionID.

Si especifica un valor de forma explícita, debe tener el formato de un GUID (por ejemplo, 3b24a047-dce6-48b2-9f20-9fbff17ed62a). Se recomienda la generación automática. Si escribe manualmente un valor, recibirá una pregunta de confirmación para verificar que no desea autogenerar el valor.

Description

Opcional

Cadena de caracteres

Una cadena que describe el sitio. Este parámetro se puede usar para ofrecer una explicación más descriptiva de la naturaleza o ubicación del sitio, lo que no puede expresarse en la Identidad.

LocationPolicy

Opcional

Cadena de caracteres

El nombre de la directiva de ubicación asociada a este sitio. La directiva de ubicación asigna valores específicos de E9-1-1 al sitio. Puede llamar al cmdlet Get-CsLocationPolicy para obtener una lista de las directivas de ubicación.

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.DisplayNetworkSiteType.

Ejemplo

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

New-CsNetworkSite -Identity Vancouver -NetworkRegionID NorthAmerica

En este ejemplo, se crea un nuevo sitio de red llamado Vancouver. El nombre de sitio se especifica como el valor del parámetro Identity. También se especifica un valor para el parámetro NetworkRegionID, que asocia el sitio con la región (en este ejemplo, Norteamérica). Se generará un valor de BypassID de manera automática. No se recomienda establecer este valor manualmente.

Observe que el comando del ejemplo no incluye el parámetro BWPolicyProfileID. Hasta que no se agregue un valor al sitio más adelante por medio de Set-CsNetworkSite, el sitio no tendrá limitaciones de ancho de banda para las conexiones multimedia.

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

New-CsNetworkSite -Identity Paris -NetworkRegionID EMEA -BWPolicyProfileID LowBWLimits

En el Ejemplo 2 se crea un nuevo sitio de red llamado Paris. El nombre de sitio se especifica como el valor del parámetro Identity. Al igual que en el Ejemplo 1, se ha especificado un valor para NetworkRegionID (en este caso, la región es EMEA). También se adopta el enfoque recomendado de permitir que el cmdlet genere el BypassID. A diferencia de lo que sucede en el Ejemplo 1, en este ejemplo también se especifica un valor para el parámetro BWPolicyProfileID: LowBWLimits. Se usarán para este sitio las directivas asociadas a ese perfil.