Test-CsLisCivicAddress
Tópico modificado em: 2012-03-25
Testa um ou mais endereços residenciais no Guia principal de endereços de ruas.
Sintaxe
Test-CsLisCivicAddress [-City <String>] [-Confirm [<SwitchParameter>]] [-Country <String>] [-HouseNumber <String>] [-HouseNumberSuffix <String>] [-PostalCode <String>] [-PostDirectional <String>] [-PreDirectional <String>] [-State <String>] [-StreetName <String>] [-StreetSuffix <String>] [-UpdateValidationStatus <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
Em uma implementação do Enterprise Voice com o Enhanced 9-1-1 (E9-1-1), os locais de usuários são determinados com base em mapas de locais que representam a sub-rede, porta, comutador ou ponto de acesso sem fio de um local. (na ausência de conexão com um local mapeado, o usuário pode ser solicitado a digitar manualmente a sua localização.) Os endereços desses locais devem ser validados no Guia principal de endereços de ruas (MSAG) pelo provedor de roteamento de rede E9-1-1. Este cmdlet utiliza o serviço web deste provedor para validar endereços mapeados. Pode-se inicializar um provedor de serviço chamando-se o cmdlet Set-CsLisServiceProvider.
Caso se deseje atualizar a propriedade MSAGValid do endereço residencial, é necessário certificar-se de incluir o parâmetro UpdateValidationStatus na chamada a Test-CsLisCivicAddress. Use o cmdlet Get-CsLisCivicAddress para recuperar endereços residenciais.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Test-CsLisCivicAddress 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 "Test-CsLisCivicAddress"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
City |
Opcional |
Cadeia de caracteres |
A cidade do local. Comprimento máximo: 64 caracteres. |
Country |
Opcional |
Cadeia de caracteres |
O país/região em que se situa este local. Comprimento máximo: 2 caracteres |
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. Comprimento máximo: 5 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 |
UpdateValidationStatus |
Opcional |
SwitchParameter |
A inclusão deste parâmetro mudará a propriedade MSAGValid do endereço residencial, em função deste endereço ser validado ou não por deste cmdlet. Se o endereço for válido, MSAGValid será definido como True. A omissão deste parâmetro deixará inalterado o valor de MSAGValid. |
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 entrada canalizada contendo um objeto de endereço residencial do Servidor de Informações de Local (LIS).
Tipos de Retorno
Este cmdlet não retorna um valor.
Exemplo
-------------------------- Exemplo 1 --------------------------
Test-CsLisCivicAddress -HouseNumber 1234 -HouseNumberSuffix "" -PreDirectional "" -StreetName Main -StreetSuffix St -PostDirectional "" -City Redmond -State WA -PostalCode 99999 -Country US -UpdateValidationStatus
Este comando valida o endereço com as propriedades correspondentes aos valores especificados nesses parâmetros, mediante consulta ao Guia principal de endereços de ruas. Observe a inclusão do parâmetro UdateValidationStatus no final: isto atualizará a propriedade MSAGValid do endereço.
-------------------------- Exemplo 2 --------------------------
Get-CsLisCivicAddress | Test-CsLisCivicAddress -UpdateValidationStatus
Este exemplo mostra como testar todos os endereços residenciais LIS. O exemplo efetua inicialmente uma chamada a Get-CsLisCivicAddress para recuperar todos os endereços residenciais definidos no banco de dados de locais. Esses endereços serão canalizados para Test-CsLisCivicAddress, que utilizará o serviço web do provedor de roteamento de rede E9-1-1 para validar cada endereço.