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.