Test-CsVoiceUser
Tópico modificado em: 2012-03-26
Identifica a rota que uma chamada telefônica de um determinado usuário percorreria para ser concluída, com base em regras de voz, rotas e políticas.
Sintaxe
Test-CsVoiceUser -DialedNumber <PhoneNumber> -SipUri <UserIdParameter> [-Force <SwitchParameter>]
Descrição Detalhada
Quando um usuário realiza uma chamada telefônica, a rota utilizada pela chamada para alcançar o seu destino depende das políticas e dos planos de discagem atribuídos a este usuário. Com um endereço SIP e o número de telefone de um usuário, esse cmdlet retorna o número convertido para o formato E.164 (com base no plano de discagem do usuário), a regra de normalização que forneceu essa conversão, a primeira rota (com base na Prioridade de rotas) com um padrão de número que corresponde a esse número de telefone e o uso do telefone que vincula a política de voz desse usuário à rota de voz.
Esse cmdlet pode ser utilizado para determinar se um número de telefone específico irá rotear e efetuar a conversão conforme o esperado, com base nas definições de usuário, e pode contribuir para solucionar problemas enfrentados por determinados usuários.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Test-CsVoiceUser localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do controle de acesso baseado em função (RBAC) que receberam a atribuição desse cmdlet (inclusive qualquer função RBAC personalizada criada por você), execute o seguinte comando no prompt do Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Test-CsVoiceUser"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
DialedNumber |
Obrigatório |
PhoneNumber |
O número de telefone a ser de testado. Tipo de dados completos: Microsoft.Rtc.Management.Voice.PhoneNumber |
SipUri |
Obrigatório |
Cadeia de caracteres |
O URI do SIP do usuário em relação ao qual se realizará o teste. Essa é Identidade do usuário, conforme utilização pelos cmdlets CsUser. É possível especificar a identidade de um usuário usando-se um dos quatro formatos: 1) O endereço SIP do usuário, 2) o UPN (nome principal de usuário), 3) o nome de domínio e nome de logon do usuário, na forma domínio\logon (por exemplo: litwareinc\kenmyer) e 4) o nome de exibição do usuário no Active Directory (por exemplo: Ken Myer). Observe que SAMAccountName não pode ser usado como uma identidade. |
Force |
Opcional |
Parâmetro de opção |
Suprime os prompts de confirmação ou mensagens de erro não fatal que podem ocorrer quando você executa o cmdlet. |
Tipos de Entrada
Nenhuma.
Tipos de Retorno
Retorna um objeto do tipo Microsoft.Rtc.Management.Voice.OcsVoiceUserTestResult.
Exemplo
-------------------------- Exemplo 1 --------------------------
Test-CsVoiceUser -DialedNumber "+14255559999" -SipUri "sip:kmyer@litwareinc.com" -Verbose
Esse exemplo executa um teste de usuário de voz em relação ao usuário com o endereço SIP sip:kmyer@litwareinc.com. O teste é realizado em relação ao número de telefone fornecido pelo parâmetro DialedNumber ("+14255559999"). Se nenhuma regra ou rota correspondente for identificada, esse cmdlet retornará um valor nulo. Observe que também incluímos o parâmetro Verbose. Verbose é um parâmetro comum do Windows PowerShell que exibirá informações adicionais enquanto o teste estiver sendo conduzido, como os planos de discagem e a política de voz que estão sendo carregados para o teste, por exemplo.
-------------------------- Exemplo 2 --------------------------
Get-CsUser | ForEach-Object {$_.DisplayName; Test-CsVoiceUser -DialedNumber "+14255559999" -SipUri $_.SipAddress} | Format-List
Esse exemplo executa um teste de roteamento de voz para todos os usuários habilitados para o Lync Server 2010 ou Office Communications Server. O comando começa com uma chamada a Get-CsUser, que retorna uma coleção de todos os usuários habilitados para o Lync Server 2010 ou Office Communications Server. Em seguida, esse exemplo canaliza a coleção de usuários para o cmdlet ForEach-Object. Esse cmdlet irá procurar cada objeto de usuário individual e realizará as ações que especificamos entre chaves ({}).
A primeira ação consiste em fornecer a saída do nome de exibição do usuário. (este usuário é representado pelos caracteres $_. Portanto, o nome de exibição está na propriedade DisplayName de $_.) Agora, podemos ver qual conta de usuário está sendo testada. A seguir, chamamos o cmdlet Test-CsVoiceUser, passando-lhe DialedNumber ("+14255559999") e SipUri do usuário atual. Nesse exemplo, estamos usando o endereço SIP do usuário ($_.SipAddress).
Finalmente, como a saída, por padrão, está no formato de tabela e pode ser cortada para se ajustar à tela, canalizamos os resultados dos testes para o cmdlet Format-List, de forma que veremos o nome de exibição de cada usuário seguido de uma linha correspondente a cada campo de saída.