Remove-CsNetworkSubnet
Última modificación del tema: 2012-03-27
Quita una subred de red existente.
Sintaxis
Remove-CsNetworkSubnet -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Cada subred debe estar asociada a un sitio de red para poder determinar la ubicación geográfica del host que pertenece a esta subred. Use este cmdlet para quitar una subred de red.
Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Remove-CsNetworkSubnet 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-CsNetworkSubnet"}
Parámetros
Parámetro | Requerido | Tipo | Descripción |
---|---|---|---|
Identity |
Requerido |
XdsGlobalRelativeIdentity |
Id. de subred único de la subred que se quiere quitar. Este valor será una dirección IP (por ejemplo, 174.11.12.0). |
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.SubnetType. Acepta la entrada transferida de objetos de subred de red.
Tipos de valores devueltos
Este cmdlet no devuelve un valor. Quita un objeto de tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.SubnetType.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Remove-CsNetworkSubnet -Identity 172.11.15.0
En este ejemplo se quita la subred con la Identidad (id. de subred) 172.11.15.0.
-------------------------- Ejemplo 2 --------------------------
Get-CsNetworkSubnet | Where-Object {$_.NetworkSiteID -eq "Vancouver"} | Remove-CsNetworkSubnet
En el Ejemplo 2 se quitan todas las subredes asociadas al sitio Vancouver. Para ello, comenzamos con la llamada del cmdlet Get-CsNetworkSubnet. Esto recuperará una colección de todas las subredes definidas en la instalación de Microsoft Lync Server 2010. Dicha colección de subredes se canaliza después al cmdlet Where-Object. Where-Object filtra y acota la colección para obtener únicamente las subredes con NetworkSiteID igual a (-eq) Vancouver. Ahora que la colección solo incluye subredes asociadas al sitio Vancouver, transferimos la colección a Remove-CsNetworkSubnet, lo cual quita todos los elementos de la colección.