Testar regras de voz, rotas e políticas no Lync Server 2013
Tópico última modificação: 2014-05-20
Agendamento de verificação |
Mensal |
Ferramenta de teste |
Windows PowerShell |
Permissões necessárias |
Quando executados localmente usando o Shell de Gerenciamento do Lync Server, os usuários devem ser membros do grupo de segurança RTCUniversalServerAdmins. Ao executar usando uma instância remota do Windows PowerShell, os usuários devem receber uma função RBAC que tenha permissão para executar o cmdlet Test-CsVoiceUser aplicativo. Para ver uma lista de todas as funções RBAC que podem usar esse cmdlet, execute o seguinte comando Windows PowerShell prompt:
|
Descrição
Quando um usuário faz uma chamada telefônica, a rota que a chamada usa para alcançar seu destino depende das políticas e dos planos de discagem atribuídos a esse usuário. Dado o endereço SIP de um usuário e um número de telefone, o cmdlet Test-CsVoiceUser verifica se o usuário em questão pode concluir uma chamada para esse número. Se o teste for bem-sucedido, Test-CsVoiceUser retornará o seguinte:
O número traduzido para o formato E.164 (com base no plano de discagem do usuário)
A regra de normalização que forneceu essa tradução
A rota de voz usada (com base na prioridade da rota);
O uso de telefone que vinculado a política de voz do usuário à rota de voz.
Test-CsVoiceUser permite determinar se um número de telefone específico será roteado e traduzido conforme o esperado e pode ajudar a solucionar problemas relacionados a chamadas que são enfrentados por usuários individuais.
Executando o teste
Ao executar o cmdlet Test-CsVoiceUser, você deve fornecer duas informações: o número que está sendo discado (DialedNumber) e a identidade da conta de usuário que está sendo testada. Por exemplo, esse comando testa a capacidade do usuário que tem o endereço SIP sip:kenmyer@litwareinc.com fazer uma chamada para o número de telefone +1206555-1219:
Test-CsVoiceUser -DialedNumber "12065551219" -SipUri "sip:kenmyer@litwareinc.com"
O número de telefone deve ser formatado da maneira que você espera que ele seja discado. Por exemplo, se os usuários normalmente não discam o 1 antes de fazer uma chamada de longa distância, você deve usar este formato:
-DialedNumber "2065551219"
É claro que, nesse caso, o teste falhará se você não tiver uma regra de normalização que possa traduzir corretamente o número 2065551219 para o formato de telefone E.164 usado pelo Lync Server. Para obter mais informações, consulte o tópico de ajuda New-CsVoiceNormalizationRule cmdlet.
Se você quiser executar esse mesmo teste em cada uma de suas contas de usuário, poderá usar um comando semelhante ao seguinte:
Get-CsUser | ForEach-Object {$_.DisplayName; Test-CsVoiceUser -DialedNumber "+12065551219" -SipUri $_.SipAddress} | Format-List
Para obter mais informações, consulte a documentação da Ajuda para Test-CsVoiceUser cmdlet.
Determinando êxito ou falha
Se o teste for concluído com êxito (ou seja, se o usuário puder fazer uma chamada telefônica para o número especificado), a saída mostrará informações como o número de telefone traduzido e a regra de normalização correspondente e rota de voz:
TranslatedNumber MatchingRule FirstMatchingRoute MatchingUsage
---------------- ------------ ------------------ -------------
+12065551219 Descripti... LocalRoute Local
Devido às limitações da tela Windows PowerShell, pelo menos algumas informações retornadas (principalmente a descrição completa da regra de normalização correspondente) podem não aparecer na tela. Se você estiver interessado apenas no sucesso ou na falha do teste, isso pode não ser importante. Se você preferir ver os detalhes completos dos dados retornados, redireire a saída para o cmdlet Format-List ao executar o teste:
Test-CsVoiceUser -DialedNumber "+12065551219" -SipUri "sip:kenmyer@litwareinc.com" -Verbose | Format-List
Isso exibirá a saída em um formato mais amigável para o leitor:
TranslatedNumber: +12065551219
MatchingRule: Description=; Pattern=^(\d{11})$; Translation=+$1;
Name=Prefix All;IsInternalExtension=False
FirsMatchingRoute : LocalRoute
MatchingUsage: Local
Se o teste falhar, Test-CsVoiceUser retornará um conjunto vazio de valores de propriedade:
TranslatedNumber MatchingRule FirstMatchingRoute MatchingUsage
---------------- ------------ ------------------ -------------
Motivos pelos quais o teste pode ter falhado
Há vários motivos pelos quais o cmdlet Test-CsVoiceUser pode falhar: pode não haver uma regra de normalização que possa traduzir o número de telefone fornecido. Pode haver problemas com a rota de voz. Pode haver um problema de configuração com o plano de discagem atribuído ao usuário em questão. Por isso, talvez você queira incluir o parâmetro Detalhado quando estiver executando o cmdlet Test-CsVoiceUser:
Test-CsVoiceUser -DialedNumber "+12065551219" -SipUri "sip:kenmyer@litwareinc.com" -Verbose
Quando o cmdlet Detalhado for incluído, Test-CsVoiceUser emitirá uma conta detalhada de todas as etapas executadas ao realizar suas verificações. Por exemplo, você pode ver etapas semelhantes a estas:
VERBOSE: Localizando o usuário com a identidade "sip:kenmyer@litwareinc.com"
VERBOSE: Carregando plano de discagem: "RedmondDialPlan"
Essas informações adicionais podem fornecer dicas sobre as etapas que você pode seguir para identificar a causa da falha. Por exemplo, a saída detalhada mostrada aqui nos informa que o usuário que está sendo testado foi atribuído ao plano de discagem RedmondDialPlan. Se o teste tiver falhado, uma próxima etapa lógica seria verificar se RedmondDialPlan pode traduzir o número de telefone fornecido.
Confira também