Compartilhar via

  • Artigo

Test-CsVoicePolicy

 

Tópico modificado em: 2012-03-26

Testa um número telefônico contra a política de voz e determina qual rota de voz seria usada contra a política de voz para esse número.

Sintaxe

Test-CsVoicePolicy -TargetNumber <PhoneNumber> -VoicePolicy <VoicePolicy> [-Force <SwitchParameter>] [-RouteSettings <PstnRoutingSettings>]

Descrição Detalhada

As políticas de voz são vinculadas a rotas de voz através de usos de PSTN (rede telefônica pública comutada). Uma chamada de um usuário a quem foi designada uma política de voz específica pode apenas ser enviada através de uma rota que tem uso PSTN combinando com um uso na política, além de um padrão de número que combina com o número discado. Chame o cmdlet Test-CsVoicePolicy para determinar qual (se alguma) rota vai ser usada para encaminhar uma chamada de um usuário com uma política de voz específica, assim como qual uso de telefone vincula a política à rota.

Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Test-CsVoicePolicy 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-CsVoicePolicy"}

Parâmetros

Parâmetro Obrigatório Tipo Descrição

TargetNumber

Obrigatório

PhoneNumber

O número de telefone contra o qual executar o teste. Este número deveria estar no formato E.164 (assim como +14255551212).

Tipo de dado completo: Microsoft.Rtc.Management.Voice.PhoneNumber

VoicePolicy

Obrigatório

VoicePolicy

Uma referência ao objeto de diretiva de voz contra a qual o teste será executado. Os objetos da diretiva de voz podem ser recuperados chamando-se o cmdlet Get-CsVoicePolicy.

Tipo de dado completo: Microsoft.Rtc.Management.WritableConfig.Policy.Voice.VoicePolicy

RouteSettings

Opcional

PstnRoutingSettings

Configurações de rota contra as quais executar o teste. As configurações de rota podem ser recuperadas com uma chamada ao cmdlet Get-CsRoutingConfiguration.

Tipo de dado completo: Microsoft.Rtc.Management.WritableConfig.Policy.Voice.PstnRoutingSettings

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.VoicePolicy. Aceita entrada em pipeline dos objetos de diretiva de voz.

Tipos de Retorno

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

Exemplo

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

Get-CsVoicePolicy -Identity site:Redmond | Test-CsVoicePolicy -TargetNumber "+14255559999"

Este exemplo executa um teste da política de voz contra a política de voz com Identity site:Redmond. Primeiro o cmdlet Get-CsVoicePolicy é executado para recuperar a diretiva com a Identidade site:Redmond. Este objeto de diretiva é então direcionado para o cmdlet Test-CsVoicePolicy, onde a diretiva é testada contra o número de telefone +14255559999. A saída vai ser a primeira rota de voz (baseada na propriedade Priority da rota) que tem um padrão de número combinando com o valor TargetNumber e um uso de telefone combinando com um uso de telefone na diretiva. Se nenhuma rota correspondente for encontrada (por exemplo, se o padrão de número corresponde ao padrão para um número de 11 dígitos e você fornece um número de 7 dígitos) um valor nulo vai ser retornado.

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

$a = Get-CsVoicePolicy -Identity site:Redmond
Test-CsVoicePolicy -TargetNumber "+14255559999" -VoicePolicy $a

Exemplo 2 é idêntico ao Exemplo 1, exceto que ao invés de direcionar os resultados da operação Get diretamente para o cmdlet Test, o objeto é primeiro armazenado na variável $a e passado como o valor para o parâmetro VoicePolicy para ser usado como a política contra a qual o teste vai ser executado.

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

Get-CsVoicePolicy | Test-CsVoicePolicy -TargetNumber "+12065559999"

Este exemplo executa um teste da política de voz contra todas as políticas de voz definidas na implantação Lync Server 2010. Primeiro o cmdlet Get-CsVoicePolicy é executado (sem nenhum parâmetro) para recuperar todas as diretivas de voz. A coleção de diretivas que é retornada é então direcionada ao cmdlet Test-CsVoicePolicy, onde cada diretiva na coleção é verificada para uma rota correspondente, baseado no número de telefone de destino fornecido (+12065559999) e nos usos de telefones. A saída será uma lista de rotas correspondentes junto com os usos de telefone que foram correspondidos.