Remove-CsLisPort
Última modificación del tema: 2012-03-27
Quita una asociación entre un puerto Location Information Server (LIS) y una ubicación. Dicha asociación se usa en una implementación Enhanced 9-1-1 (E9-1-1) de Enterprise Voice para informar a un operador de servicios de emergencia sobre la ubicación del autor de la llamada.
Sintaxis
Remove-CsLisPort -ChassisID <String> -PortID <String> -PortIDSubType <InterfaceAlias | InterfaceName | LocallyAssigned> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Enhanced 9-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 una asignación de ubicación (denominada asignación de cable) que determinará la ubicación del autor de la llamada. Este cmdlet quita la asociación entre una ubicación física y el puerto a través del cual se enrutarán las llamadas quitando el puerto de la base de datos de configuración de ubicaciones.
Al quitar una ubicación de puerto, no se quitará la ubicación real, sino solo el puerto. Para eliminar la ubicación, abra el cmdlet Remove-CsLisLocation. Al quitar el puerto, no se quitará también el modificador con el ChassisID dado. Para quitar el modificador, llame al cmdlet Remove-CsLisSwitch.
Si intenta quitar un puerto que no existe, no se llevará a cabo ninguna acción y no recibirá ningún mensaje de error ni de advertencia.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Remove-CsLisPort de forma local: 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 (incluido cualquier otro rol RBAC personalizado que usted mismo haya creado), ejecute el siguiente comando desde Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsLisPort"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
ChassisID |
Requerido |
Cadena de caracteres |
La dirección de control de acceso a medios (MAC) del modificador del puerto. Este valor estará en el formato nn-nn-nn-nn-nn-nn, como 12-34-56-78-90-ab. |
PortID |
Requerido |
Cadena de caracteres |
El identificador del puerto que quiera quitar. |
PortIDSubType |
Requerido |
PortIDSubType |
El subtipo del puerto que quiera quitar. Este valor se puede especificar en forma de valor numérico o de cadena de caracteres, pero debe ser un subtipo válido. Los subtipos válidos son: 1: InterfaceAlias 5: InterfaceName 7: LocallyAssigned |
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 puerto LIS.
Tipos de valores devueltos
Este cmdlet no devuelve un valor. Quita un objeto de tipo System.Management.Automation.PSCustomObject.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Remove-CsLisPort -ChassisID 99-99-99-99-99-99 -PortID 4200 -PortIDSubType 1
En el Ejemplo 1 se quita el puerto de LIS con la dirección MAC (ChassisID) 99-99-99-99-99-99, el valor de PortID 4200 y el valor de PortIDSubType 1. (Tenga en cuenta que el valor de 1 para PortIDSubType se convierte en un valor de InterfaceAlias. Este parámetro y valor también podría haberse especificado de la siguiente manera: -PortIDSubType InterfaceAlias)
Si este puerto estaba asociado a una ubicación, dicha ubicación no se quitará, únicamente se quitará el puerto de la asignación de ubicación.
-------------------------- Ejemplo 2 --------------------------
Get-CsLisPort | Where-Object {$_.HouseNumber -eq ""} | Remove-CsLisPort
En este ejemplo se quitan todas las ubicaciones de puerto que no cuenten con un número de domicilio. El ejemplo comienza con una llamada al cmdlet Get-CsLisPort que devuelve una colección de todos los puertos LIS. Dicha colección se transfiere al cmdlet Where-Object que localiza los elementos de la colección que cuentan con la propiedad HouseNumber vacía; en otras palabras, una propiedad HouseNumber que sea igual a (-eq) una cadena de caracteres vacía (“”). Por último, la colección de ubicaciones de puerto sin números de domicilio se transfiere al cmdlet Remove-CsLisPort, que elimina todo el contenido de la colección.
Tenga en cuenta que, como en el Ejemplo 1, no se quita ninguna ubicación de la base de datos de configuración de ubicaciones, sino que únicamente se quitan los puertos que hacen referencia a dichas ubicaciones. En este caso, esto significa que habrán ubicaciones no válidas que también deberán quitarse (no son válidas porque HouseNumber es una propiedad obligatoria para las ubicaciones) en la base de datos de ubicaciones. Para quitar ubicaciones, llame al cmdlet Remove-CsLisLocation.