Set-CsLisSwitch
Última modificación del tema: 2012-04-23
Crea un modificador del servidor de información de ubicación (LIS), crea una asociación entre el modificador y una ubicación (creando una ubicación nueva si la ubicación no existe) o modifica el modificador existente y su ubicación asociada. La asociación entre el modificador y la ubicación se usa en una implementación de Enhanced 9-1-1 (E9-1-1) Enterprise Voice para notificar a un operador de servicios de emergencia sobre la ubicación del autor de llamada.
Sintaxis
Set-CsLisSwitch -ChassisID <String> [-City <String>] [-CompanyName <String>] [-Confirm [<SwitchParameter>]] [-Country <String>] [-Description <String>] [-HouseNumber <String>] [-HouseNumberSuffix <String>] [-Location <String>] [-PostalCode <String>] [-PostDirectional <String>] [-PreDirectional <String>] [-State <String>] [-StreetName <String>] [-StreetSuffix <String>] [-WhatIf [<SwitchParameter>]]
Set-CsLisSwitch -ChassisID <String> [-Confirm [<SwitchParameter>]] [-Description <String>] [-WhatIf [<SwitchParameter>]]
Set-CsLisSwitch -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
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 un mapa de ubicaciones (o diagrama de cables) para determinar la ubicación del autor de una llamada. Este cmdlet permite al administrador asignar ubicaciones físicas a los modificadores de red que utiliza el cliente para establecer la conexión.
El parámetro ChassisID es el único parámetro necesario para este cmdlet. Si escribe un valor de ChassisID que ya existe, el cmdlet actualizará la ubicación para este modificador basándose en los parámetros de ubicación proporcionados. Si ChassisID no existe, se creará una nueva ubicación del modificador.
Si una ubicación con una dirección que coincide perfectamente con los parámetros de la dirección especificada aquí (incluidos los valores NULL) no existe en la base de datos de ubicación, se creará una dirección nueva basada en los parámetros definidos con este cmdlet. (Puede recuperar una lista de ubicaciones llamando al cmdlet Get-CsLisLocation.) El cmdlet Set-CsLisSwitch no requiere ni solicita parámetros de ubicación. Puede crear una entrada de modificador sin asociarla a una ubicación. También se puede 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, puede que las llamadas que reciba el modificador de referencia no contengan la información requerida por el operador de servicios de emergencia (en función de si está disponible la configuración válida para un punto de acceso inalámbrico o subred que se pueda usar en lugar de la configuración del modificador). Se recomienda que sea tan específico como pueda respecto a los parámetros de ubicación y que rellene tantos como sea posible.
Tenga en cuenta que también se pueden crear entradas de modificadores llamando al cmdlet Set-CsLisPort. Si llama al cmdlet Set-CsLisPort con un valor de ChassisID que no tenga una entrada de modificador, se creará este modificador.
Es importante tener en cuenta que estos cambios surtirán efecto únicamente si se ha configurado la propiedad MACResolverUrl mediante el cmdlet New-CsWebServiceConfiguration o Set-CsWebServiceConfiguration. La propiedad MACResolverUrl especifica la dirección URL de un servicio web que puede tomar una dirección IP y determinar la dirección Media Access Control (MAC) de la tarjeta de red asociada a esa dirección IP.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Set-CsLisSwitch 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 "Set-CsLisSwitch"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
ChassisID |
Requerido |
Cadena de caracteres |
La dirección de control de acceso a medios (MAC) del conmutador de red. Este valor debe tener el formato nn-nn-nn-nn-nn-nn, por ejemplo, 12-34-56-78-90-ab, o el formato de una dirección IP. Si una entrada con el valor de ChassisID especificado no existe, se creará una nueva ubicación del modificador. Si existe una entrada con el valor de ChassisID especificado, ésta se reemplazará. |
City |
Requerido |
Cadena de caracteres |
La ciudad de la ubicación. Longitud máxima: 64 caracteres. |
CompanyName |
Requerido |
Cadena de caracteres |
El nombre de la compañía que se encuentra en esa ubicación. Longitud máxima: 60 caracteres |
Country |
Requerido |
Cadena de caracteres |
País/región de la ubicación. Longitud máxima: 2 caracteres |
Description |
Opcional |
Cadena de caracteres |
Una descripción detallada esta ubicación del modificador de red. |
HouseNumber |
Requerido |
Cadena de caracteres |
Número de calle de la ubicación. En el caso de una empresa, es el número de la calle en el que se encuentra. Longitud máxima: 10 caracteres. |
HouseNumberSuffix |
Requerido |
Cadena de caracteres |
Información adicional sobre el número del edificio, como 1/2 o A. Por ejemplo, 1234 1/2 Oak Street o 1234 A Elm Street. Nota: Para designar un número de apartamento o complejo de oficinas, se debe utilizar el parámetro Location. Por ejemplo, -Location "Suite 100/Office 150". Longitud máxima: 5 caracteres |
Location |
Requerido |
Cadena de caracteres |
El nombre de la ubicación. Este valor suele ser el nombre de una ubicación más concreta que la dirección postal como, por ejemplo, un número de oficina, pero puede contener cualquier valor de cadena. Longitud máxima: 20 caracteres |
PostalCode |
Requerido |
Cadena de caracteres |
El código postal asociado a la ubicación. Longitud máxima: 10 caracteres |
PostDirectional |
Requerido |
Cadena de caracteres |
La designación de dirección del nombre de una calle. Por ejemplo, NE o NO en Main Street NE o 7th Avenue NO. Longitud máxima: 2 caracteres |
PreDirectional |
Requerido |
Cadena de caracteres |
La designación de dirección del nombre de una calle que precede al nombre de la calle. Por ejemplo, NE o NW para NE Main Street o NW 7th Avenue. Longitud máxima: 2 caracteres |
State |
Requerido |
Cadena de caracteres |
La provincia o el estado asociado a la ubicación. Longitud máxima: 2 caracteres |
StreetName |
Requerido |
Cadena de caracteres |
El nombre de la calle de la ubicación. Longitud máxima: 60 caracteres |
StreetSuffix |
Requerido |
Cadena de caracteres |
El tipo de calle, como Calle, Avenida o Paseo. 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 la entrada transferida de objetos de conmutación LIS.
Tipos de valores devueltos
Este cmdlet crea o modifica un objeto de tipo System.Management.Automation.PSCustomObject.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Set-CsLisSwitch -ChassisID 99-99-99-99-99-99
En el Ejemplo 1 se crea o actualiza una entrada de ubicación de modificador del servidor LIS. El comando del ejemplo incluye únicamente un parámetro (obligatorio): ChassisID. El valor de ChassisID es la dirección MAC del modificador; en este caso será 99-99-99-99-99-99.
Tenga en cuenta que este ejemplo no incluye ninguna información de dirección. Se puede crear una entrada de modificador en el servidor de información de ubicación sin necesidad de asociarla a una dirección. Sin embargo, puede que las llamadas de emergencia enrutadas a través de este modificador (en función de las ubicaciones del puerto o subred que se hayan definido) contengan información suficiente para que el operador del servicio de emergencia pueda identificar una ubicación.
IMPORTANTE: Si ya existe una ubicación del modificador del servidor LIS con este valor de ChassisID, se reemplazará por los valores de este comando. Esto quiere decir que si el modificador está asociado a una dirección (una ubicación física), tal asociación dejará de existir porque no se incluyó ninguna información de ubicación en este comando. La ubicación seguirá existiendo en la base de datos de ubicación, pero no estará asociada al modificador.
-------------------------- Ejemplo 2 --------------------------
Set-CsLisSwitch -ChassisID 99-99-99-99-99-99 -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 modificador creado en el Ejemplo 1 agregando información de dirección. (Esto en realidad quiere decir que se elimina la entrada existente y se reemplaza con la nueva entrada). Si la dirección no existe en la base de datos de ubicación, el cmdlet creará la ubicación.
Vea también
Otros recursos
Remove-CsLisSwitch
Get-CsLisSwitch
Get-CsLisLocation
Set-CsLisPort
Get-CsLisPort