Compartilhar via

  • Artigo

Test-CsVoiceNormalizationRule

 

Tópico modificado em: 2012-03-27

Testa um número de telefone em relação a uma regra de normalização de voz e retorna o número depois que a regra de normalização tiver sido aplicada. As regras de normalização de voz são usadas para converter um requisito de discagem por telefone (por exemplo: a discagem de 9 para acessar uma linha externa) no formato de número de telefone E.164 usado pelo Microsoft Lync Server 2010.

Sintaxe

Test-CsVoiceNormalizationRule -DialedNumber <PhoneNumber> -NormalizationRule <NormalizationRule>

Descrição Detalhada

Este cmdlet permite examinar os resultados da aplicação de uma regra de normalização de voz a um determinado número de telefone. As regras de normalização de voz são uma parte necessária de autorização de telefone e roteamento de chamada. Elas definem os requisitos para converter números de um formato normalmente inserido pelos usuários em um formato padrão (E.164). Utilize esse cmdlet para solucionar problemas de discagem ou para verificar se as regras funcionarão como esperado em relação a determinados números.

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

DialedNumber

Obrigatório

PhoneNumber

O número de telefone em relação ao qual se quer testar a regra de normalização, especificada no parâmetro NormalizationRule.

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

NormalizationRule

Obrigatório

NormalizationRule

Um objeto que contém uma referência à regra de normalização em relação à qual se quer testar o número especificado no parâmetro DialedNumber.

É possível recuperar as regras de normalização de voz disponíveis, chamando-se o cmdlet Get-CsVoiceNormalizationRule.

Tipos de Entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.NormalizationRule. Aceita entradas canalizadas dos objetos de regra de normalização de voz.

Tipos de Retorno

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

Exemplo

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

Get-CsVoiceNormalizationRule -Identity "global/11 digit number rule" | Test-CsVoiceNormalizationRule -DialedNumber 14255559999

Esse exemplo executa um teste de normalização de voz em relação à regra de normalização de voz cuja Identidade for "global/regra numérica de 11 dígitos". Primeiramente, executa-se o cmdlet Get-CsVoiceNormalizationRule, para recuperar a regra cuja Identidade for "global/regra numérica de 11 dígitos". Esse objeto de regra será então canalizado para o cmdlet Test-CsVoiceNormalizationRule, no qual a regra será testada em relação ao número de telefone 14255559999. A saída será DialedNumber, depois que tiver sido aplicada a regra de normalização de voz "global/regra numérica de 11 dígitos". Se essa regra não for aplicada ao valor de DialedNumber (por exemplo, se a regra de normalização coincidir com o padrão de um número de onze dígitos e você tiver fornecido um número de sete dígitos), nenhum valor será retornado.

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

$a = Get-CsVoiceNormalizationRule -Identity "global/11 digit number rule"
Test-CsVoiceNormalizationRule -DialedNumber 5551212 -NormalizationRule $a

O Exemplo 2 é idêntico ao Exemplo 1, exceto que em vez de canalizar os resultados da operação Get diretamente para o cmdlet Test, o objeto é inicialmente armazenado na variável $a e, em seguida, é passado como o valor para o parâmetro NormalizationRule, a ser usado como regra de normalização de voz em relação à qual o teste será executado.

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

Get-CsVoiceNormalizationRule | Test-CsVoiceNormalizationRule -DialedNumber 2065559999

Esse exemplo executa um teste de normalização de voz em relação a todas as regras de normalização de voz definidas na implantação do Lync Server 2010. Primeiramente, executa-se o cmdlet Get-CsVoiceNormalizationRule (sem parâmetros), para recuperar todas as regras de normalização de voz. A coleção de regras que for retornada será canalizada para o cmdlet Test-CsVoiceNormalizationRule, no qual cada regra na coleção será testada em relação ao número de telefone 2065559999. A saída será uma lista com os números convertidos, um para cada regra testada. Se essa regra não for aplicada ao valor de DialedNumber (por exemplo, se a regra de normalização coincidir com o padrão de um número de onze dígitos e você tiver fornecido um número de sete dígitos), a lista apresentará uma linha em branco correspondente a essa regra.