Set-CsLisPort
Última modificación del tema: 2012-03-26
Crea un puerto de servidor de información de ubicaciones (LIS), crea una asociación entre un puerto y una ubicación (crea una nueva ubicación si esa ubicación no existe), o modifica un puerto existente y su ubicación asociada. La asociación entre un puerto y una ubicación se usa en una implementación de 9-1-1 mejorado (E9-1-1) de Telefonía IP empresarial para informar un operador de servicios de emergencia sobre la ubicación del autor de la llamada.
Sintaxis
Set-CsLisPort -ChassisID <String> -PortID <String> [-City <String>] [-CompanyName <String>] [-Confirm [<SwitchParameter>]] [-Country <String>] [-Description <String>] [-HouseNumber <String>] [-HouseNumberSuffix <String>] [-Location <String>] [-PortIDSubType <InterfaceAlias | InterfaceName | LocallyAssigned>] [-PostalCode <String>] [-PostDirectional <String>] [-PreDirectional <String>] [-State <String>] [-StreetName <String>] [-StreetSuffix <String>] [-WhatIf [<SwitchParameter>]]
Set-CsLisPort -ChassisID <String> -PortID <String> [-Confirm [<SwitchParameter>]] [-Description <String>] [-PortIDSubType <InterfaceAlias | InterfaceName | LocallyAssigned>] [-WhatIf [<SwitchParameter>]]
Set-CsLisPort -City <String> -CompanyName <String> -Country <String> -HouseNumber <String> -HouseNumberSuffix <String> -Location <String> -PostalCode <String> -PostDirectional <String> -PreDirectional <String> -State <String> -StreetName <String> -StreetSuffix <String> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
Descripción detallada
El 9-1-1 mejorado le 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 realiza la llamada 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 (denominado gráfico de cableado) que determinará la ubicación del autor de la llamada. El cmdlet le permite al administrador asignar ubicaciones físicas al puerto mediante el que está conectado el cliente.
La combinación de ChassisID, PortID y PortIDSubType conforman una única ubicación de puerto. Si escribe una combinación de teclas ChassisID/PortID/PortIDSubType que ya existe, este cmdlet actualizará la ubicación de ese puerto en base a los parámetros de ubicación proporcionados. Si la combinación de teclas no existe, se creará una nueva ubicación de puerto.
Si la ubicación con dirección que coincide exactamente con los parámetros de direcciones escritos aquí (incluidos los valores nulos) no existe en la base de datos de la ubicación, se creará una nueva dirección en base a los parámetros escritos con este cmdlet. (Puede recuperar una lista de ubicaciones llamando al cmdlet Get-CsLisLocation). El cmdlet Set-CsLisPort no requiere ni pide confirmación de parámetros de ubicación, puede crear una entrada de puerto sin asociarla con una ubicación. Además es posible crear una ubicación no válida con este cmdlet. Una ubicación válida debe tener, al menos, un valor de ubicación (Location), número (HouseNumber), calle (StreetName), ciudad (City), estado (State) y país (Country). Si no proporciona todos estos parámetros, las llamadas recibidas por el puerto de referencia posiblemente no contengan la información requerida por el operador de emergencia (según si las configuraciones válidas están disponibles para el conmutador, la subred o el punto de acceso inalámbrico que se puede usar en lugar de las configuraciones del puerto). Le recomendamos que sea lo más específico posible con los parámetros de la ubicación y que complete la mayor cantidad posible.
Uno de los parámetros requeridos de este cmdlet es ChassisID. ChassisID es la dirección Media Access Control (MAC) del conmutador de red del puerto. Si el conmutador no existe en la base de datos de la ubicación, el cmdlet creará ese conmutador. Puede recuperar los conmutadores existentes al llamar al cmdlet Get-CsLisSwitch. Recuerde que aunque se creará una nueva entrada de conmutadores, ese conmutador no se asociará automáticamente con la información de ubicación escrita con el cmdlet Set-CsLisPort; debe configurar la ubicación del conmutador con el cmdlet Set-CsLisSwitch.
Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los grupos siguientes están autorizados a ejecutar el cmdlet Set-CsLisPort en forma local: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en roles (RBAC) que se han asignado a este cmdlet (incluidos los roles personalizados RBAC que haya creado usted), ejecute el siguiente comando en el aviso de Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsLisPort"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
ChassisID |
Requerido |
Cadena de caracteres |
Dirección MAC del conmutador del puerto. Este valor debe tener un formato nn-nn-nn-nn-nn-nn, por ejemplo, 12-34-56-78-90-ab, o como una dirección IP. Si la combinación de ChassisID, PortID y PortIDSubType es única, se creará una nueva ubicación de puerto única. Si esta combinación no es única, la ubicación del puerto con esa combinación de teclas se actualizará con los valores de parámetros provistos con el comando. |
City |
Requerido |
Cadena de caracteres |
Ciudad de ubicación de este puerto. Longitud máxima: 64 caracteres. |
CompanyName |
Requerido |
Cadena de caracteres |
Nombre de la empresa en esta ubicación. Longitud máxima: 60 caracteres. |
Country |
Requerido |
Cadena de caracteres |
País o región donde se encuentra el puerto. Longitud máxima: 2 caracteres. |
Description |
Opcional |
Cadena de caracteres |
Descripción detallada de la ubicación de este puerto. |
HouseNumber |
Requerido |
Cadena de caracteres |
Número de casa de la ubicación del puerto. En el caso de una empresa, se trata de la numeración de la calle en la que está ubicada la compañía. Longitud máxima: 10 caracteres. |
HouseNumberSuffix |
Requerido |
Cadena de caracteres |
Información adicional del número de la casa, por ejemplo, 1/2 o A. Por ejemplo, 1234 1/2 Oak Street o 1234 A Elm Street. Nota: para designar un número de departamento u oficina, debe usar el parámetro Location (ubicación). Por ejemplo, -Location "Suite 100/Oficina 150". Longitud máxima: 5 caracteres. |
Location |
Requerido |
Cadena de caracteres |
Nombre de esta ubicación. Habitualmente, este valor es el nombre de una ubicación más específica que el domicilio real, por ejemplo, número de oficina, pero puede ser cualquier valor de cadena. Longitud máxima: 20 caracteres. |
PortID |
Requerido |
Cadena de caracteres |
Identificación del puerto asociado con esta ubicación. |
PortIDSubType |
Opcional |
PortIDSubType |
Subtipo del puerto. Este valor se puede escribir como una cadena o un valor numérico, pero debe ser un subtipo válido. Los subtipos válidos son: 1: InterfaceAlias 5: InterfaceName 7: LocallyAssigned Valor predeterminado: 7 (LocallyAssigned) |
PostalCode |
Requerido |
Cadena de caracteres |
Código postal asociado con esta ubicación. Longitud máxima: 10 caracteres. |
PostDirectional |
Requerido |
Cadena de caracteres |
Designación de orientación del nombre de una calle. Por ejemplo, NE o NW, en las calles Main Street NE o 7th Avenue NW. Longitud máxima: 2 caracteres. |
PreDirectional |
Requerido |
Cadena de caracteres |
Designación de orientación del nombre de una calle que precede al nombre de la calle. Por ejemplo, NE (Noreste) o NW (Noroeste) para NE Main Street o NW 7th Avenue. Longitud máxima: 2 caracteres. |
State |
Requerido |
Cadena de caracteres |
Estado o provincia asociada con esta ubicación. Longitud máxima: 2 caracteres. |
StreetName |
Requerido |
Cadena de caracteres |
Nombre de la calle de esta ubicación. Longitud máxima: 60 caracteres. |
StreetSuffix |
Requerido |
Cadena de caracteres |
Tipo de calle designado en el nombre de la calle, por ejemplo, Street, Avenue o Court. Longitud máxima: 10 caracteres. |
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 entradas canalizadas de los objetos del puerto de LIS.
Tipos de valores devueltos
Este cmdlet crea o modifica un objeto de tipo System.Management.Automation.PSCustomObject.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Set-CsLisPort -ChassisID 99-99-99-99-99-99 -PortID 4200 -PortIDSubType 1
En el ejemplo 1 se crea o se actualiza una entrada de ubicación de puerto LIS. El comando de este ejemplo comprende tres parámetros: ChassisID, PortID y PortIDSubtype. El valor de ChassisID es la dirección MAC 99-99-99-99-99-99, el valor del PortID es 4200 y el valor del PortIDSubType es 1. (Recuerde que el valor de 1 para PortIDSubType se traduce en un valor de InterfaceAlias. Este parámetro y este valor además se podrían haber escrito de la siguiente manera: -PortIDSubType InterfaceAlias.) Estos tres parámetros son necesarios para crear una instancia única de ubicación de puerto.
Este ejemplo no incluye ningún tipo de información de dirección. Es posible crear una entrada de puerto en el servidor de información de ubicaciones sin asociarlo con una dirección. Sin embargo, según la subred o las ubicaciones de conmutadores que se han definido, las llamadas de emergencia que se enrutan por este puerto podrían no contener información suficiente para que el operador de emergencia identifique una ubicación.
IMPORTANTE: Si ya existe la ubicación del puerto LIS con esta combinación de teclas, será reemplazada por los valores de este comando. Eso significa que si el puerto se asociara con una dirección (una ubicación física), esa asociación ya no existiría porque no incluimos información de ubicación en este comando. La ubicación aún existirá en la base de datos de la ubicación, pero no estará asociada con este puerto.
-------------------------- Ejemplo 2 --------------------------
Set-CsLisPort -ChassisID 99-99-99-99-99-99 -PortID 4200 -PortIdSubType 1 -Location "30/1000" -HouseNumber 1234 -PreDirectional NE -StreetName First -StreetSuffix Avenue -City Redmond -State WA -Country US -PostalCode 99999
En el ejemplo 2 se actualiza el puerto creado en el Ejemplo 1 al agregar la información de direcciones. Si la dirección no existe en la base de datos de la ubicación, el cmdlet creará esa ubicación.
-------------------------- Ejemplo 3 --------------------------
$a = Get-CsLisPort | Where-Object {$_.ChassisID -eq "99-99-99-99-99-88"}
$a | Set-CsLisPort -Location "30/1000" -HouseNumber 1234 -StreetName First -StreetSuffix Avenue -City Redmond -State WA -Country US -PostalCode 99999
En este ejemplo, se actualizan todas las ubicaciones definidas para los puertos con una dirección MAC (ChassisID) de 99-99-99-99-99-88. La primera línea de este ejemplo comienza con una llamada a Get-CsLisPort, que recupera todos los puertos que se han definido en el servicio LIS. La colección de puertos es canalizada al cmdlet Where-Object, que encuentra todos los elementos de la colección con un ChassisID igual a (-eq) 99-99-99-99-99-88. Esta colección de puertos con ChassisID 99-99-99-99-99-88 se asigna a la variable $a.
En la segunda línea de este ejemplo, canalizamos los contenidos de la variable $a (colección de puertos LIS con ChassisID 99-99-99-99-99-88) al cmdlet Set-CsLisPort. Este cmdlet tomará cada elemento de esa recopilación y lo actualizará con los valores en los parámetros especificados (ubicación, número de casa, nombre de la calle, sufijo de la calle, ciudad, estado, país y código postal).