Set-CsLisSubnet
Tópico modificado em: 2012-03-27
Cria uma sub-rede de LIS (servidor de informações de local), cria uma associação entre uma sub-rede e um local (criando um novo local, caso não exista) ou modifica uma sub-rede existente e seu local associado. A associação entre uma sub-rede e um local é usada 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-CsLisSubnet -Subnet <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-CsLisSubnet -Subnet <String> [-Confirm [<SwitchParameter>]] [-Description <String>] [-WhatIf [<SwitchParameter>]]
Set-CsLisSubnet -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 a sub-rede à qual o cliente estiver conectado.
O parâmetro Subnet é o único parâmetro necessário a esse cmdlet. Se você inserir um valor de Subnet que já existe, esse cmdlet atualizará o local dessa sub-rede com base nos parâmetros do local que forem fornecidos. Se o Subnet não existir, será criado um novo local de sub-rede.
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-CsLisSubnet não exige ou solicita parâmetros de local. É possível criar uma entrada de sub-rede 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, Número da casa, Nome da rua, Cidade, Estado e País. Se você não fornecer todos estes parâmetros, é possível que as chamadas originadas da sub-rede especificada não contenham as informações necessárias ao operador de emergência (dependendo da disponibilidade das definições válidas para um comutador, porta ou ponto de acesso à rede sem fio que possam ser usadas em vez das definições de sub-rede). É recomendável ser o mais específico possível com os parâmetros de local e preencher o máximo possível.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Set-CsLisSubnet 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-CsLisSubnet"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
Subnet |
Obrigatório |
Cadeia de caracteres |
O endereço IP da sub-rede. Esse valor deve ser inserido como um endereço IPv4 (dígitos separados por pontos, como 192.0.2.0, por exemplo). |
City |
Opcional |
Cadeia de caracteres |
A cidade do local. Comprimento máximo: 64 caracteres. |
CompanyName |
Opcional |
Cadeia de caracteres |
O nome da companhia neste local. Comprimento máximo: 60 caracteres |
Country |
Opcional |
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 desse local de sub-rede. |
HouseNumber |
Opcional |
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 |
Opcional |
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 |
Opcional |
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 |
Opcional |
Cadeia de caracteres |
O código postal associado a este local. Comprimento máximo: 10 caracteres |
PostDirectional |
Opcional |
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 |
Opcional |
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 |
Opcional |
Cadeia de caracteres |
O estado ou província associada a este local. Comprimento máximo: 2 caracteres |
StreetName |
Opcional |
Cadeia de caracteres |
O nome da rua deste local. Comprimento máximo: 60 caracteres |
StreetSuffix |
Opcional |
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 sub-rede de LIS.
Tipos de Retorno
Este cmdlet modifica um objeto do tipo System.Management.Automation.PSCustomObject.
Exemplo
-------------------------- Exemplo 1 --------------------------
Set-CsLisSubnet -Subnet 192.10.10.0
O Exemplo 1 cria ou atualiza uma entrada de local de sub-rede LIS. O comando neste exemplo inclui apenas um parâmetro (obrigatório): Subnet. O valor de Subnet nesse exemplo é um endereço IPv4 (192.10.10.0).
Observe que este exemplo não inclui qualquer informação de endereço. É possível criar uma entrada de sub-rede no Servidor de Informações de Local sem associá-la a um endereço. No entanto, as chamadas de emergência roteadas por esta sub-rede, dependendo da porta ou dos locais de comutador que tiverem sido 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 sub-rede LIS com este Subnet, ele será substituído pelos valores deste comando. Isso significa que se esta sub-rede tiver sido associada a um endereço (um local físico), esta associação deixará de existir porque não incluímos nenhuma informação sobre local neste comando. O local ainda constará do banco de dados de local, mas não estará associado a esta sub-rede.