Remove-CsLisSwitch
Última modificación del tema: 2012-03-27
Elimina un conmutador de red de un servidor de información de ubicación (LIS).
Sintaxis
Remove-CsLisSwitch -ChassisID <String> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Enhanced 9-1-1 (E9-1-1) permite al operador de servicios de emergencia identificar la ubicación del autor de la llamada sin tener que preguntar a éste dicha información. Si el autor de la llamada está llamando desde una conexión de voz sobre IP (VoIP), dicha información debe extraerse en función de varios factores de conexión. El administrador de VoIP debe configurar un mapa de ubicaciones (o diagrama de cables) para determinar la ubicación del autor de una llamada. Este cmdlet quita un conmutador de la base de datos de configuración de ubicaciones. Esta eliminación no implica la eliminación de la ubicación real, sino solo del conmutador. Para eliminar la ubicación, llame al cmdlet Remove-CsLisLocation.
No puede eliminar un interruptor si el ChassisID del interruptor está siendo usado por un puerto. (Ejecute el siguiente comando para averiguar qué ChassisID están usando otros puertos: Get-CsLisPort | Select-Object ChassisID). Primero debe eliminar todos los puertos con el ChassisID dado antes de eliminar el conmutador.
Si intenta eliminar un conmutador que no existe, no se realizará ninguna acción y no recibirá un mensaje de error ni de advertencia.
Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Remove-CsLisSwitch 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-CsLisSwitch"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
ChassisID |
Requerido |
Cadena de caracteres |
Dirección de Media Access Control (MAC) del conmutador de red. Este valor estará en la forma nn-nn-nn-nn-nn-nn, por ejemplo, 12-34-56-78-90-ab. |
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
Acepta la entrada transferida de objetos de conmutador de LIS.
Tipos de valores devueltos
Este cmdlet no devuelve un valor. Elimina un objeto del tipo System.Management.Automation.PSCustomObject.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Remove-CsLisSwitch -ChassisID 99-99-99-99-99-99
En el Ejemplo 1 se elimina el conmutador LIS con la dirección MAC (ChassisID) 99-99-99-99-99-99.
Este comando dará error si el ChassisID lo está usando un puerto. Además, si este conmutador se ha asociado con una ubicación, dicha ubicación no se eliminará, sólo se eliminará el conmutador de la asignación de ubicaciones.
-------------------------- Ejemplo 2 --------------------------
Get-CsLisSwitch | Where-Object {$_.City -eq ""} | Remove-CsLisSwitch
En este ejemplo se eliminan todos los interruptores que no tienen una ciudad. El ejemplo comienza con una llamada al cmdlet Get-CsLisSwitch, que devuelve una colección de todos los conmutadores. Esta colección se transfiere al cmdlet Where-Object, que encuentra los elementos que tienen una propiedad City vacía; es decir, los elementos donde City es igual (-eq) a una cadena vacía (“”). Para acabar, transferimos esta colección de conmutadores que no tienen ciudades al cmdlet Remove-CsLisSwitch, que elimina todo lo que dicha colección contiene.
Tenga en cuenta que, como en el ejemplo 1, no se eliminan las ubicaciones de la base de datos de ubicaciones, sino solo los conmutadores que hacen referencia a tales ubicaciones. En este caso, quiere decir que habrá ubicaciones no válidas (no son válidas porque Ciudad es una propiedad requerida de ubicación) en la base de datos de ubicaciones que también deberían ser eliminadas. Para quitar ubicaciones, llame al cmdlet Remove-CsLisLocation.