Compartir a través de

  • Artículo

Set-CsLisLocation

 

Última modificación del tema: 2012-03-26

Crea una ubicación nueva o modifica una ubicación existente en la base de datos de configuración de ubicaciones de Enhanced 9-1-1 (E9-1-1).

Sintaxis

Set-CsLisLocation -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>]]

Set-CsLisLocation -Instance <PSObject> [-City <String>] [-CompanyName <String>] [-Confirm [<SwitchParameter>]] [-Country <String>] [-HouseNumber <String>] [-HouseNumberSuffix <String>] [-Location <String>] [-PostalCode <String>] [-PostDirectional <String>] [-PreDirectional <String>] [-State <String>] [-StreetName <String>] [-StreetSuffix <String>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

E9-1-1 permite a los servicios receptores de llamadas de emergencia calcular la ubicación geográfica del autor de la llamada sin preguntarle. En Microsoft Lync Server 2010, la ubicación se calcula por la asignación del puerto, la subred, el conmutador o el punto de acceso inalámbrico del autor de la llamada a cierta ubicación. (Este mapa se denomina diagrama de cables). Este cmdlet agrega una dirección nueva o modifica una dirección existente en la lista de ubicaciones almacenadas en la base de datos de configuración de ubicaciones del servidor de información de ubicación (LIS). A continuación, las ubicaciones se asocian a una lista de direcciones válidas proporcionada por el proveedor de servicios de emergencia que trabaje con la compañía.

La combinación de todos los parámetros necesarios (aparte de Instance) de este cmdlet constituye una sola entrada. Al cambiar cualquiera de los parámetros, se creará una ubicación nueva en lugar de modificarse una existente. Tenga en cuenta que, aunque todos estos parámetros son necesarios, algunos pueden contener valores nulos. Los parámetros que no deben contener valores nulos son: Location, HouseNumber, StreetName, City, State y Country. Para cambiar un valor existente, debe usar el parámetro Instance (o transferir una instancia al cmdlet).

Además de usar este cmdlet para crear una ubicación, también se creará automáticamente una ubicación al introducir una nueva dirección en la información de puerto, subred, conmutador o punto de acceso inalámbrico. Esta información se puede introducir mediante los cmdlets Set-CsLisPort, Set-CsLisSubnet, Set-CsLisSwitch y Set-CsLisWirelessAccessPoint.

Quién puede ejecutar este cmdlet: De manera predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar localmente el cmdlet Set-CsLisLocation: 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-CsLisLocation"}

Parámetros

Parámetro Requerido Tipo Descripción

Instance

Requerido

PSObject

Una referencia a un objeto de ubicación. Este objeto debe contener las propiedades necesarias para crear una ubicación. Para recuperar un objeto de este tipo, puede llamar a Get-CsLisLocation.

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

HouseNumber

Requerido

Cadena de caracteres

El número de edificio 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 de datos transmitidos de objetos de ubicación LIS.

Tipos de valores devueltos

Este cmdlet no devuelve un valor ni un objeto. Crea o modifica un objeto de tipo System.Management.Automation.PSCustomObject.

Ejemplo

-------------------------- Ejemplo 1 --------------------------

Set-CsLisLocation -Location Bldg30NEWing -HouseNumber 1000 -StreetName Main -City Redmond -State WA -Country US

En el Ejemplo 1 se crea una ubicación nueva llamada Bldg30NEWing. Este comando rellena todos los parámetros que necesitan tener algún valor para poder crear una ubicación. En este ejemplo, la dirección de la ubicación es 1000 Main, Redmond, WA, US. Para introducir esa dirección, se especifica el valor 1000 para el parámetro HouseNumber; el valor Main para el parámetro StreetName; el valor Redmond para el parámetro City, y el valor US para el parámetro Country.

Tenga en cuenta que, si ejecuta un comando con los parámetros que se muestran aquí, se le solicitará que introduzca más parámetros. Sin embargo, puede presionar Entrar en cada aviso sin especificar ningún valor y se creará la ubicación.

-------------------------- Ejemplo 2 --------------------------

Set-CsLisLocation -Location "Suite 100/Office 20" -CompanyName "Litware, Inc." -HouseNumber 1234 -HouseNumberSuffix "" -PreDirectional "" -StreetName Main -StreetSuffix St -PostDirectional "" -City Redmond -State WA -PostalCode 99999 -Country US

Este ejemplo, igual que el Ejemplo 1, crea una ubicación nueva. Sin embargo, en este caso, el comando especifica todos los parámetros del cmdlet. Así se evitan los avisos que siguen al comando del Ejemplo 1 porque, en este ejemplo, se asignan cadenas vacías a los valores que queremos dejar en blanco.

-------------------------- Ejemplo 3 --------------------------

$a = Get-CsLisLocation | Where-Object {$_.Location -ceq "Bldg30NEWing"}
Set-CsLisLocation -Instance $a -StreetSuffix Street

Este ejemplo modifica la ubicación que se creó en el Ejemplo 1. La primera línea del ejemplo comienza con una llamada al cmdlet Get-CsLisLocation. Esta acción devuelve una colección de todas las ubicaciones definidas dentro de la implementación de Lync Server 2010. A continuación, la colección se transfiere al cmdlet Where-Object. Where-Object recupera todos los elementos de la colección cuya propiedad Location es igual a (-ceq, igual incluyendo mayúsculas y minúsculas) Bldg30NEWing. El objeto que coincide con este criterio se asigna a la variable $a.

En la línea 2, llamamos a Set-CsLisLocation. El primer parámetro es el parámetro Instance. Pasamos a este parámetro la variable ($a) que contiene el objeto que recuperamos en la línea 1, que es el objeto que queremos modificar. A continuación, especificamos el parámetro StreetSuffix y le pasamos el valor de Street. Esta acción cambiará el valor de la propiedad StreetSuffix de la ubicación de la variable $a a Street.

Recuerde que, ya que Location no es una propiedad única, el cmdlet Where-Object podría devolver más de una ubicación. Si esto sucede, no funcionará este ejemplo. Si quiere modificar varias ubicaciones al mismo tiempo, consulte el Ejemplo 4.

-------------------------- Ejemplo 4 --------------------------

$a = Get-CsLisLocation | Where-Object {$_.Location -ceq "NorthCampus"}
$a | Set-CsLisLocation -StreetSuffix Avenue

El Ejemplo 4 modifica la propiedad StreetSuffix de uno o más objetos de ubicación. Este ejemplo comienza igual que el Ejemplo 3: llamamos a Get-CsLisLocation para recuperar todas las ubicaciones. Transferimos esta colección de ubicaciones a Where-Object, que filtra la colección para incluir solo las ubicaciones cuya propiedad Location es igual a NorthCampus. Esta nueva colección se almacena en la variable $a. En la línea 2, transferimos el contenido de $a al cmdlet Set-CsLisLocation. Este cmdlet modificará cada uno de los objetos (cada ubicación) que se almacenó en $a. En este caso, la modificación consiste en cambiar la propiedad StreetSuffix de cada objeto a Avenue.

Los comandos de este ejemplo se pueden ejecutar también sin usar ninguna variable. Solo es necesario transferir los resultados del comando Where-Object al comando Set-CsLisLocation, así:

Get-CsLisLocation | Where-Object {$_.Location -ceq "NorthCampus"} | Set-CsLisLocation -StreetSuffix Avenue