Set-CsNetworkSite
Última modificación del tema: 2012-03-26
Modifica un sitio de red existente definido para un control de admisión de llamadas (CAC) o Enhanced 9-1-1 (E9-1-1).
Sintaxis
Set-CsNetworkSite [-Identity <XdsGlobalRelativeIdentity>] [-BWPolicyProfileID <String>] [-BypassID <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-LocationPolicy <String>] [-NetworkRegionID <String>] [-WhatIf [<SwitchParameter>]]
Set-CsNetworkSite [-BWPolicyProfileID <String>] [-BypassID <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-LocationPolicy <String>] [-NetworkRegionID <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 modifica la configuración de un sitio existente. Esto puede incluir la región a la que está asociado el sitio, la descripción del sitio y el perfil de directivas de banda ancha asociado.
Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Set-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 "Set-CsNetworkSite"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
XdsGlobalRelativeIdentity |
El identificador único del sitio de red que se quiere modificar. Los sitios se crean únicamente en el ámbito global, de modo que no es necesario especificar el ámbito. En su lugar, se debe especificar únicamente el id. del sitio de red. |
Instance |
Opcional |
DisplayNetworkSiteType |
Una referencia a un objeto de sitio de red (un objeto de tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.DisplayNetworkSiteType). Este objeto puede recuperarse llamando al cmdlet Get-CsNetworkSite. |
BWPolicyProfileID |
Opcional |
Cadena de caracteres |
La Identidad del perfil de directiva de ancho de banda que definirá las limitaciones de 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 especifica un valor para este parámetro, debe especificar también un valor para el parámetro NetworkRegionID. Si no especifica un valor para este parámetro, pero especifica uno para NetworkRegionID, se generará automáticamente un BypassID. Si especifica un valor de forma explícita, debe tener el formato de un GUID (por ejemplo, 3b24a047-dce6-48b2-9f20-9fbff17ed62a). Le recomendamos que suministre un valor para NetworkRegionID y permita que el valor de BypassID se genere automáticamente. Si escribe manualmente un valor, recibirá una pregunta de confirmación para indicar que no desea generar el valor automáticamente. |
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. Para obtener una lista de las directivas de ubicación, llame al cmdlet Get-CsLocationPolicy. |
NetworkRegionID |
Opcional |
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. Si ya existe un BypassID en este sitio y no se especifica un valor para el parámetro BypassID, un BypassID generado automáticamente sobrescribirá el BypassID existente. |
Force |
Opcional |
Parámetro modificador |
Suprime las preguntas de confirmación que aparecerí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.DisplayNetworkSiteType. Acepta la entrada transferida de objetos de sitio de red.
Tipos de valores devueltos
Este cmdlet no devuelve un valor. Modifica un objeto de tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.DisplayNetworkSiteType.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Set-CsNetworkSite -Identity Vancouver -NetworkRegionID Canada
En este ejemplo, se modifica el sitio de red denominado Vancouver. El nombre de sitio que se está modificando se especifica como el valor del parámetro Identity. El sitio Vancouver se mueve a una nueva región, lo que requiere que se cambie el parámetro NetworkRegionID, en este caso a la región denominada Canada. Como se ha suministrado un NetworkRegionID, pero no se ha especificado ningún valor para BypassID, éste se generará automáticamente. Cualquier id. de desvío existente se sobrescribirá.
-------------------------- Ejemplo 2 --------------------------
Set-CsNetworkSite -Identity Vancouver - BWPolicyProfileID LowBWLimits
En el Ejemplo 2, simplemente se modifica el perfil de directivas de banda ancha asociado al sitio Vancouver. El nombre de sitio se especifica como el valor del parámetro Identity. A continuación, se especifica un valor para el parámetro BWPolicyProfileID: LowBWLimits. Se usarán para este sitio las directivas asociadas a ese perfil.