Remove-CsNetworkRegionLink
Última modificación del tema: 2012-03-26
Quita un vínculo entre dos regiones configuradas para el control de admisión de llamadas (CAC).
Sintaxis
Remove-CsNetworkRegionLink -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Las regiones de una red se vinculan mediante conexiones de red WAN físicas. Este cmdlet no afecta a las conexiones físicas, sólo quita el vínculo de la configuración de CAC.
Quién puede ejecutar este cmdlet: de forma predeterminada, están autorizados para ejecutar el cmdlet Remove-CsNetworkRegionLink localmente los miembros de los siguientes grupos: RTCUniversalServerAdmins. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC) a los que se ha asignado este cmdlet (incluidos los roles de RBAC personalizados que haya creado), ejecute el siguiente comando en el símbolo del sistema de Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsNetworkRegionLink"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
XdsGlobalRelativeIdentity |
El identificador único del vínculo de región de red que quiere quitar. Los vínculos de región de red sólo pueden crearse en el ámbito global, por lo tanto, no es necesario especificar un ámbito en este identificador. En su lugar, contiene una cadena de caracteres que consiste en el nombre único que identifica dicho vínculo. |
Force |
Opcional |
Parámetro modificador |
Suprime los mensajes de confirmación que, de lo contrario, se mostrarí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.NetworkRegionLinkType. Acepta la entrada por canalización de objetos de vínculo 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.NetworkRegionLinkType.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Remove-CsNetworkRegionLink -Identity NA_EMEA
Este primer ejemplo quita el vínculo de región de red con el valor de Identity NA_EMEA.
-------------------------- Ejemplo 2 --------------------------
Get-CsNetworkRegionLink | Where-Object {$_.BWPolicyProfileID -eq "HighBWLimits"} | Remove-CsNetworkRegionLink
El Ejemplo 2 quita todos los vínculos de región de red que usen el perfil de directiva de ancho de banda HighBWLimits. Primero se llama al cmdlet Get-CsNetworkRegionLink sin parámetros para que devuelva todos los vínculos de región. Esta recopilación de vínculos se transfiere al cmdlet Where-Object. Where-Object examina los elementos de la recopilación, uno por uno, para comprobar el valor de la propiedad BWPolicyProfileID. Si esta propiedad es igual a (-eq) HighBWLimits, el elemento se transfiere al cmdlet Remove-CsNetworkRegionLink, que quita el vínculo.