Set-CsLisSwitch
Tópico modificado em: 2012-04-23
Cria um comutador do LIS (Servidor de Informações de Local), cria uma associação entre um comutador e um local (criando um novo local, se esse local não existir) ou modifica um comutador existente e seu local associado. Utiliza-se a associação entre um comutador e um local na implementação de um Enhanced 9-1-1 (E9-1-1) Enterprise Voice, para notificar um operador de serviços de emergência sobre o local do chamador.
Sintaxe
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>]]
Descrição Detalhada
O Enhanced 9-1-1 permite que um operador de emergência identifique o local de um chamador sem ter de pedir essa informação ao chamador. Caso o chamador esteja chamando de uma conexão VoIP, essa informação deve ser extraída com base em diversos fatores de conexão. O administrador VoIP deve configurar um mapa de local (denominado wiremap) que determinará o local de um chamador. Este cmdlet permite que o administrador mapeie locais físicos para o comutador de rede ao qual o cliente estiver conectado.
O parâmetro ChassisID é o único parâmetro necessário a esse cmdlet. Se você inserir um valor de ChassisID que já existe, esse cmdlet atualizará o local desse comutador com base nos parâmetros do local que forem fornecidos. Se o ChassisID não existir, será criado um novo local de comutador.
Se não existir um local com um endereço que corresponda exatamente aos parâmetros de endereço inseridos aqui (incluindo valores nulos) no banco de dados local, será criado um novo endereço com base nos parâmetros inseridos por intermédio deste cmdlet. É possível recuperar uma lista de locais, chamando-se o cmdlet Get-CsLisLocation. O cmdlet Set-CsLisSwitch não exige ou solicita parâmetros de local. É possível criar uma entrada de comutador sem associá-la a um local. Este cmdlet também permite criar um local inválido. Um local válido consiste em, no mínimo, um Local, Nome da rua, Número da casa, Cidade, Estado e País. Se você não fornecer todos estes parâmetros, é possível que as chamadas recebidas pelo comutador referenciado não contenham as informações necessárias ao operador de emergência (dependendo da disponibilidade das definições válidas para uma sub-rede ou ponto de acesso à rede sem fio que possam ser usadas em vez das definições do comutador). É recomendável ser o mais específico possível com os parâmetros de local e preencher o máximo possível.
Observe que as entradas de comutador também podem ser criadas chamando-se o cmdlet Set-CsLisPort. Se Set-CsLisPort for chamado com um valor de ChassisID que não esteja associado a uma entrada existente de comutador, este comutador será criado.
É importante observar que essas alterações terão efeito apenas se você configurou a propriedade MACResolverUrl utilizando o cmdlet New-CsWebServiceConfiguration ou Set-CsWebServiceConfiguration. A propriedade MACResolverUrl especifica a URL de um web service que é capaz de pegar um endereço IP e determinar o endereço MAC (Media Access Control) da placa de rede associada ao endereço IP.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Set-CsLisSwitch localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet foi atribuído (inclusive qualquer função RBAC personalizada que tenha sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsLisSwitch"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
ChassisID |
Obrigatório |
Cadeia de caracteres |
O endereço MAC (Controle de Acesso de Mídia) do comutador de rede. Esse valor deverá estar no formato nn-nn-nn-nn-nn-nn (como 12-34-56-78-90-ab, por exemplo) ou na forma de um endereço IP. Se não existir uma entrada com o ChassisID especificado, será criado um novo local de comutador. Se não existir uma entrada com o ChassisID especificado, esta entrada será substituída. |
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 |
Description |
Opcional |
Cadeia de caracteres |
Uma descrição detalhada do local do comutador dessa rede. |
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 usar o parâmetro Local. 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 comutador de LIS.
Tipos de Retorno
Este cmdlet modifica um objeto do tipo System.Management.Automation.PSCustomObject.
Exemplo
-------------------------- Exemplo 1 --------------------------
Set-CsLisSwitch -ChassisID 99-99-99-99-99-99
O Exemplo 1 cria ou atualiza uma entrada de local de comutador LIS. O comando neste exemplo inclui apenas um parâmetro (obrigatório): ChassisID. O valor de ChassisID é o endereço MAC do comutador. Neste caso, 99-99-99-99-99-99.
Observe que este exemplo não inclui nenhuma informação de endereço. É possível criar uma entrada de comutador no Servidor de Informações de Local sem associá-lo a um endereço. No entanto, as chamadas de emergência roteadas por este comutador, dependendo da sub-rede ou dos locais da porta que foram definidos, podem não conter informações suficientes para que o operador de emergência seja capaz de identificar um local.
IMPORTANTE: Se já existir um local de comutador LIS com este ChassisID, ele será substituído pelos valores neste comando. Isso significa que se este comutador tiver sido associado a um endereço (um local físico), esta associação deixará de existir porque não incluímos nenhuma informação de local neste comando. O local ainda constará do banco de dados de local, mas não estará associado a este comutador.
-------------------------- Exemplo 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
O Exemplo 2 atualiza o comutador criado no Exemplo 1, adicionando informações de endereço (na verdade, isso significa excluir a entrada existente e substitui-la por essa nova entrada). Se o endereço não existir no banco de dados de local, este cmdlet criará este local.
Consulte Também
Outros Recursos
Remove-CsLisSwitch
Get-CsLisSwitch
Get-CsLisLocation
Set-CsLisPort
Get-CsLisPort