Remove-CsNetworkRegion
Última modificación del tema: 2012-03-25
Quita una región de red existente. Las regiones de red representan redes troncales o concentradores de red de una red empresarial.
Sintaxis
Remove-CsNetworkRegion -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Una región de red interconecta varias partes de una red en varias zonas geográficas. Cada región de red debe estar asociada a un sitio central. El sitio central es el sitio del centro de datos donde se ejecuta el servicio de directiva de ancho de banda. Use este cmdlet para quitar una región de red.
Tenga en cuenta que no se puede quitar una región de red si está asociada a un sitio de red (es decir, si la propiedad NetworkRegionID de un sitio es igual a la propiedad Identity de la región). Si intenta quitar una región asociada a un sitio, recibirá un mensaje de error.
Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Remove-CsNetworkRegion 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 "Remove-CsNetworkRegion"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
XdsGlobalRelativeIdentity |
El identificador único de la región de red que se quiere quitar. La Identidad estará representada por una cadena que identifique la región de forma única. |
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.NetworkRegionType. Acepta la entrada transferida de objetos de región de red.
Tipos de valores devueltos
Este cmdlet no devuelve un valor. Quita un objeto de tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkRegionType.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Remove-CsNetworkRegion -Identity NorthAmerica
En el Ejemplo 1 se quita la región de red con Identidad NorthAmerica. Dado que las identidades son únicas, este comando quita solo una región de red.
-------------------------- Ejemplo 2 --------------------------
Get-CsNetworkRegion | Where-Object {$_.CentralSite -eq "site:Redmond"} | Remove-CsNetworkRegion
En este ejemplo se quitan todas las regiones de red asociadas al sitio central Redmond. El comando comienza llamando al cmdlet Get-CsNetworkRegion sin parámetros para recuperar una colección de todas las regiones de red definidas para la implementación de Microsoft Lync Server 2010. A continuación, la colección se transfiere al cmdlet Where-Object. Where-Object filtra esta colección para devolver solamente los elementos (las regiones de red) cuyo valor CentralSite es igual a (-eq) site:Redmond. Tras limitar la colección a estos elementos, la nueva colección se transfiere a Remove-CsNetworkRegion, que quita todos los elementos de la colección.
-------------------------- Ejemplo 3 --------------------------
Get-CsNetworkSite | Where-Object {$_.NetworkRegionID -eq "NorthAmerica"} | Set-CsNetworkSite -NetworkRegionID $null -BypassID $null
Remove-CsNetworkRegion -Identity "NorthAmerica"
En este ejemplo se quita la región de red con Identidad NorthAmerica. No obstante, no se puede quitar una región si está asociada a un sitio. De modo que este ejemplo quita primero cualquier asociación entre la región NorthAmerica y un sitio.
El ejemplo comienza llamando al cmdlet Get-CsNetworkSite sin parámetros para recuperar una colección de todos los sitios de red definidos para la implementación de Lync Server. A continuación, la colección se transfiere al cmdlet Where-Object. Where-Object filtra esta colección para devolver solamente los elementos (los sitios de red) cuyo valor NetworkRegionID es igual a (-eq) NorthAmerica. Tras limitar la colección a estos elementos, la nueva colección se transfiere a Set-CsNetworkSite. En cada sitio que contiene el NetworkRegionID NorthAmerica, establecemos el NetworkRegionID en Null ($null). De esta forma, se quita la referencia a la región en dicho sitio. Sin embargo, un sitio no puede tener un id. de desvío si no está asociado a un sitio. De modo que, además de quitar la referencia a la región configurando NetworkRegionID como Null, se debe quitar también la asociación de desvío configurando BypassID como Null.
Una vez finalizada la línea 1, cualquier sitio que estuviera asociado a la región NorthAmerica deja de estar vinculado a una región o a una configuración de desvío. A continuación podemos llamar a la línea 2, que quita la región de red.