Compartilhar via

  • Artigo

Test-CsVoiceRoute

 

Tópico modificado em: 2012-03-26

Testa um número de telefone em um padrão de número de rota de voz e retorna um valor booleano (true/false) declarando se o número fornecido corresponde ao padrão de número da rota. O padrão de número é apenas uma das propriedades que as rotas de voz usam para dizer ao Microsoft Lync Server 2010 como rotear chamadas de usuários do Enterprise Voice para números de telefone na PSTN (rede telefônica pública comutada) ou PBX (central privada de comutação telefônica).

Sintaxe

Test-CsVoiceRoute -Route <Route> -TargetNumber <PhoneNumber> [-Force <SwitchParameter>]

Descrição Detalhada

Uma rota de voz inclui uma expressão regular que identifica quais números de telefone serão roteados por uma determinada rota de voz: os números de telefone que combinam com a expressão regular serão roteados por esta rota. Este cmdlet verifica se um dado número de telefone será ou não roteado por uma rota de voz especificada com base no padrão de número da rota (a propriedade NumberPattern). O cmdlet pode ser usado para solucionar problemas de roteamento, ou simplesmente para testar números de telefone com rotas específicas para garantir que os resultados sejam os esperados.

Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Test-CsVoiceRoute localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do RBAC (controle de acesso baseado na função) atribuídas a este cmdlet (incluindo eventuais funções personalizadas do RBAC que você mesmo tenha criado), execute o comando a seguir no prompt do Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Test-CsVoiceRoute"}

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Route

Obrigatório

Rota

Um objeto que contém uma referência à rota de voz na qual o número especificado no parâmetro TargetNumber será testado. Um objeto de rota de voz pode ser obtido chamando-se o cmdlet Get-CsVoiceRoute.

Tipo de Dados Completos: Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route

TargetNumber

Obrigatório

PhoneNumber

O número de telefone com o qual a rota de voz especificada no parâmetro Route será testada. O número deve estar no formato E.164 (como +14255551212).

Tipo de Dados Completos: Microsoft.Rtc.Management.Voice.PhoneNumber

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

Objeto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route. Aceita entrada em pipeline de um objeto de rota de voz.

Tipos de Retorno

Retorna um objeto do tipo Microsoft.Rtc.Management.Voice.VoiceRouteTestResult.

Exemplo

-------------------------- Exemplo 1 --------------------------

$vr = Get-CsVoiceRoute -Identity testroute
Test-CsVoiceRoute -TargetNumber "+14255551212" -Route $vr

Este comando determina se um número fornecido corresponde ao padrão da rota especificada. Primeiro usamos o cmdlet Get-CsVoiceRoute para recuperar a rota de voz testroute. Usamos essa rota como valor do parâmetro Route do cmdlet Test-CsVoiceRoute. Também incluímos o número que queremos testar no parâmetro TargetNumber. A saída é um valor booleano que declara se o número de destino corresponde ao padrão da rota.

-------------------------- Exemplo 2 --------------------------

Get-CsVoiceRoute -Identity testroute | Test-CsVoiceRoute -TargetNumber "+14255551212"

O Exemplo 2 realiza a mesma ação do Exemplo 1. Mas, no Exemplo 2, a ação é realizada em um único comando. Primeiro chamamos Get-CsVoiceRoute para recuperar a rota de voz com a Identidade testroute. Canalizamos essa rota de voz para o cmdlet Test-CsVoiceRoute e testamos a rota com o número fornecido no parâmetro TargetNumber. Observe que não é preciso fornecer o parâmetro Route, porque a rota foi canalizada para o cmdlet.

-------------------------- Exemplo 3 --------------------------

Get-CsVoiceRoute | Test-CsVoiceRoute -TargetNumber "+14255551212"

Este exemplo recupera uma coleção de todas as rotas de voz definidas em uma implantação do Lync Server 2010 e testa os padrões de número de cada rota com o TargetNumber fornecido na chamada ao cmdlet Test-CsVoiceRoute. A saída será um valor True ou False para cada rota testada.

-------------------------- Exemplo 4 --------------------------

$z = Get-CsVoiceRoute
foreach ($x in $z){$x.Identity; Test-CsVoiceRoute -TargetNumber "+14255551212" -Route $x}

Este exemplo é semelhante ao Exemplo 3 por recuperar os resultados de um teste de rota de voz em várias rotas. Porém, a saída do Exemplo 3 será apenas uma lista de valores True/False, sem indicação clara das rotas às quais os resultados do teste se aplicam. Esse exemplo resolve o problema. (É possível melhorar a saída, mas este breve exemplo pelo menos realiza a tarefa.)

Começamos chamando Get-CsVoiceRoute para recuperar todas as rotas de voz e atribuir a coleção à variável $z. Na linha seguinte, começamos um loop foreach. O loop percorre os membros da coleção um por um, atribuindo-os à variável $x. A primeira coisa que fazemos com $x, que contém uma referência a uma única rota de voz, é exibir a identidade da rota: $x.Identity. A próxima parte do comando é uma chamada a Test-CsVoiceRoute, onde testamos a rota $x em relação ao número de destino. A saída final será uma lista (não muito bem formatada) de identidades de rota de voz seguidas por um indicador true/false apontando se o número de destino corresponde ou não ao padrão de número da rota com essa identidade.