Compartilhar via

  • Artigo

Set-CsLisLocation

 

Tópico modificado em: 2012-03-26

Cria um novo local ou modifica um existente no banco de dados de configuração de localizações do Enhanced 9 (E9-1-1).

Sintaxe

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

Descrição Detalhada

O E9-1-1 permite que os usuários que atendem a chamadas de emergência determinem o local geográfico do chamador, sem ter de indagar-lhe essa informação. No Microsoft Lync Server 2010, o local é determinado com base no mapeamento da porta do chamador, na sub-rede, no comutador ou no ponto de acesso sem fio de um local específico (este mapa é conhecido como mapa de conexões.) Este cmdlet adiciona um novo endereço ou modifica um endereço existente à lista de locais armazenada no banco de dados de configuração de locais do Servidor de informações de local (LIS). Os locais são subsequentemente confrontados com uma lista de endereços válidos fornecida pelo provedor de serviços de emergência que trabalha com a empresa.

A combinação de todos os parâmetros necessários (além do Instance) para este cmdlet constitui uma entrada única. A mudança de quaisquer desses parâmetros criará um novo local, em vez de modificar um existente. Observe que embora todos esses parâmetros sejam necessários, alguns podem conter valores nulos. Os parâmetros que devem conter valores não-nulos são: Location, HouseNumber, StreetName, City, State e Country. Para modificar um valor existente, deve-se usar o parâmetro Instance (ou canalizar uma instância para o cmdlet).

Além de usar este cmdlet para criar um local, também se criará automaticamente um local quando se digitar um novo endereço relativo a uma porta, sub-rede, comutador ou ponto de informação de acesso sem fio. Estas informações podem ser digitadas utilizando-se os cmdlets Set-CsLisPort, Set-CsLisSubnet, Set-CsLisSwitch e Set-CsLisWirelessAccessPoint.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Set-CsLisLocation localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet tiver sido atribuído (inclusive qualquer função RBAC personalizada que tiver sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsLisLocation"}

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Instance

Obrigatório

PSObject

Uma referência a um objeto de local. Este objeto deve conter as propriedades necessárias à criação de um local. É possível recuperar um objeto deste tipo chamando-se Get-CsLisLocation.

City

Obrigatório

Cadeia de caracteres

A cidade do local.

Comprimento máximo: 64 caracteres.

CompanyName

Obrigatório

Cadeia de caracteres

O nome da companhia neste local.

Comprimento máximo: 60 caracteres

Country

Obrigatório

Cadeia de caracteres

O país/região em que se situa este local.

Comprimento máximo: 2 caracteres

HouseNumber

Obrigatório

Cadeia de caracteres

O número da residência do local. No caso de uma empresa, esse é o número na rua da empresa.

Comprimento máximo: 10 caracteres

HouseNumberSuffix

Obrigatório

Cadeia de caracteres

Informações adicionais sobre o número da residência, como fundos ou a. Por exemplo, Avenida Paraná, 1234 fundos ou Rua dos Jequitibás, 123a.

Observação: Para designar um número de apartamento ou sala de escritório, é necessário utilizar o parâmetro Location. Por exemplo, -Location "Conjunto 100/Escritório 150".

Comprimento máximo: 5 caracteres

Location

Obrigatório

Cadeia de caracteres

O nome deste local. Normalmente, este valor é o nome de um local mais específico que o endereço residencial, como o número do escritório, mas pode ser qualquer valor de cadeia de caracteres.

Comprimento máximo: 20 caracteres

PostalCode

Obrigatório

Cadeia de caracteres

O código postal associado a este local.

Comprimento máximo: 10 caracteres

PostDirectional

Obrigatório

Cadeia de caracteres

A indicação direcional para o nome de uma rua. Por exemplo, NE ou NW (nordeste ou noroeste) para Main Street NE ou 7th Avenue NW.

Comprimento máximo: 2 caracteres

PreDirectional

Obrigatório

Cadeia de caracteres

A indicação direcional para o nome de uma rua que precede o nome da rua. Por exemplo, NE ou NW (nordeste ou noroeste) para NE Main Street ou NW 7th Avenue.

Comprimento máximo: 2 caracteres

State

Obrigatório

Cadeia de caracteres

O estado ou província associada a este local.

Comprimento máximo: 2 caracteres

StreetName

Obrigatório

Cadeia de caracteres

O nome da rua deste local.

Comprimento máximo: 60 caracteres

StreetSuffix

Obrigatório

Cadeia de caracteres

O tipo de rua designado no nome de uma rua, como Rua, Avenida ou Quadra.

Comprimento máximo: 10 caracteres

WhatIf

Opcional

SwitchParameter

Descreve o que aconteceria se o comando fosse executado sem ser executado de fato.

Confirm

Opcional

SwitchParameter

Solicita confirmação antes da execução do comando.

Tipos de Entrada

Aceita entradas canalizadas de objetos de local de LIS.

Tipos de Retorno

Este cmdlet não retorna um valor ou objeto. Ele cria ou modifica um objeto do tipo System.Management.Automation.PSCustomObject.

Exemplo

-------------------------- Exemplo 1 --------------------------

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

O Exemplo 1 cria um novo local, denominado Bldg30NEWing. Este comando preenche todos os parâmetros nos quais se esperam valores, para se criar um local. Neste exemplo, o endereço do local é 1000 Main, Redmond, WA, EUA. Este endereço é digitado especificando-se o parâmetro HouseNumber com o valor 1000; o parâmetro StreetName com o valor Main; o parâmetro City com o valor Redmond; e o o parâmetro Country com o valor EUA.

Observe que, executando-se um comando com os parâmetros mostrados, surgirá um aviso solicitando a entrada de mais parâmetros. Contudo, pode-se simplesmente pressionar Enter a cada aviso, sem fornecer valor algum, e o local será criado.

-------------------------- Exemplo 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 exemplo é similar ao Exemplo 1 pelo fato de que ele cria um local. Contudo, neste exemplo, o comando especifica todos os parâmetros do cmdlet. Isto evitará os avisos que se sucedem ao comando no Exemplo 1 porque neste exemplo, ao contrário, quaisquer valores que se deseja deixar sem valor serão definidos como cadeias de caracteres vazias.

-------------------------- Exemplo 3 --------------------------

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

Este exemplo modifica o local criado no Exemplo 1. A primeira linha do exemplo começa com uma chamada ao cmdlet Get-CsLisLocation. Isto retorna uma coleção de todos os locais definidos na implantação do Lync Server 2010. Esta coleção será então canalizada para o cmdlet Where-Object. Where-Object recupera todos os itens da coleção cuja propriedade Location for igual a (-ceq, igual a diferenciação entre maiúsculas e minúsculas) Bldg30NEWing. O objeto que atende a este critério será atribuído à variável $a.

Na linha 2, chama-se Set-CsLisLocation. O primeiro parâmetro é Instance. Passa-se este parâmetro à variável ($a), que contém o objeto recuperado na linha 1, que é exatamente o objeto que se quer modificar. Em seguida, especifica-se o parâmetro StreetSuffix, passando a ele o valor Street. Isto atualizará como Street o valor da propriedade StreetSuffix do local na variável $a.

Lembre-se de que, como Location não é uma propriedade exclusiva, o cmdlet Where-Object pode retornar mais de um local. Se isso acontecer, este exemplo não funcionará. Para modificar diversos locais de uma vez, consulte o Exemplo 4.

-------------------------- Exemplo 4 --------------------------

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

O Exemplo 4 modifica a propriedade StreetSuffix de um ou mais objetos de local. O exemplo começa de maneira muito similar ao Exemplo 3. Chama-se inicialmente Get-CsLisLocation, para recuperar todos os locais. Canaliza-se esta coleção de locais para Where-Object, que restringe a coleção somente àqueles locais cuja propriedade Location for igual a NorthCampus. Esta nova coleção será armazenada na variável $a. Na linha 2, canaliza-se o conteúdo de $a para o cmdlet Set-CsLisLocation. Este cmdlet modificará cada objeto (cada local) armazenado em $a. Nesse caso a modificação é a alteração da propriedade StreetSuffix de cada objeto para Avenue.

Os comandos deste exemplo também podem ser realizados sem o uso de uma variável. Basta canalizar os resultados do comando Where-Object para o comando Set-CsLisLocation. Da seguinte maneira:

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