Compartilhar via

  • Artigo

Set-CsVoiceNormalizationRule

 

Tópico modificado em: 2012-03-27

Modifica uma regra de normalização de voz. As regras de normalização de voz são usadas para converter um requisito de discagem de 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

Set-CsVoiceNormalizationRule [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-IsInternalExtension <$true | $false>] [-Pattern <String>] [-Priority <Int32>] [-Translation <String>] [-WhatIf [<SwitchParameter>]]

Set-CsVoiceNormalizationRule [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-IsInternalExtension <$true | $false>] [-Pattern <String>] [-Priority <Int32>] [-Translation <String>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Este cmdlet modifica uma regra chamada normalização de voz. Essas regras fazem parte integrante da autorização de telefones e do roteamento de chamadas. Elas definem os requisitos para converter (ou traduzir) números de um formato interno Lync Server 2010 para um formato padrão (E.164). A compreensão de expressões regulares é útil na definição de padrões de números que serão convertidos.

As regras que são modificadas usando este cmdlet fazem parte do plano de discagem e, além de serem acessíveis através do cmdlet Get-CsVoiceNormalizationRule, também podem ser acessadas pela propriedade NormalizationRules devolvida por uma chamada para o cmdlet Get-CsDialPlan.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Set-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 (incluindo qualquer função RBAC personalizada criada por você), execute o seguinte comando do prompt Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsVoiceNormalizationRule"}

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

XdsIdentity

Um identificador exclusivo para a regra. A identidade especificada deve incluir o escopo seguido por uma barra invertida seguida pelo nome; por exemplo: site:Redmond/Rule1, onde site:Redmond é o escopo e Rule1 é o nome.

Instance

Opcional

NormalizationRule

Permite passar uma referência a um objeto para o cmdlet, em vez de definir valores de parâmetros individuais. Este objeto deve ser do tipo NormalizationRule e pode ser recuperado chamando-se Get-CsVoiceNormalizationRule

Description

Opcional

Cadeia de caracteres

Uma descrição intuitiva da regra de normalização.

Comprimento máximo da cadeia de caracteres: 512 caracteres.

IsInternalExtension

Opcional

Booleano

Se for definido como True, o resultado da aplicação desta regra será um número interno à empresa. Se for definido como False, a aplicação da regra resultará em um número externo. Esse valor será ignorado se o valor da propriedade OptimizeDeviceDialing do plano de discagem associado for definido como False.

Priority

Opcional

Int32

A ordem na qual serão aplicadas as regras. É possível que um número coincida com mais de uma regra. Este parâmetro define a ordem na qual as regras testarão o número.

Pattern

Opcional

Cadeia de caracteres

Uma expressão regular à qual o número discado deve corresponder, para que esta regra seja aplicada.

Translation

Opcional

Cadeia de caracteres

O modelo de expressão regular que será aplicado ao número para convertê-lo no formato E.164.

Force

Opcional

SwitchParameter

Suprime qualquer aviso de confirmação que, de outra maneira, seria exibido antes de se realizar as alterações.

WhatIf

Opcional

SwitchParameter

Descreve o que aconteceria se o comando fosse executado sem ser executado de fato.

Confirm

Opcional

SwitchParameter

Solicita confirmação antes da execução do comando.

Tipos de Entrada

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

Tipos de Retorno

Set-CsVoiceNormalizationRule não retorna um valor ou objeto. Em vez disso, o cmdlet configura instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.NormalizationRule.

Exemplo

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

Set-CsVoiceNormalizationRule -Identity "site:Redmond/Prefix Redmond" -Description "Add a prefix to all numbers on site Redmond"

Este exemplo define a descrição da regra Prefix Redmond no site de Redmond para "Adicionar um prefixo a todos os números no site de Redmond".

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

Set-CsVoiceNormalizationRule -Identity global/SeattleFourDigit -Description "Translate an internal four-digit extension" -Translation '+1206556$1'

Este exemplo modifica a regra de normalização de voz com a Identidade global/SeattleFourDigit. A nova Descrição foi especificada para refletir as modificações à regra. Além disso, um valor de Tradução foi especificado que modifica a regra para traduzir qualquer número que combina com o modelo existente desta regra para o mesmo número, mas com o prefixo +1206556. Por exemplo, se o modelo existente combinasse com qualquer número de quatro dígitos e o número 1234 fosse inserido, esta regra traduziria aquele ramal ao número +12065561234.

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

$a = Get-CsVoiceNormalizationRule -Identity global/RedmondFourDigit
$a.name = "RedmondRule"
Set-CsVoiceNormalizationRule -Instance $a

O Exemplo 3 altera o nome da regra de normalização. Tenha em mente que a alteração do nome também alterará a parte do nome da identidade. O cmdlet Set-CsVoiceNormalizationRule não possui um parâmetro Name. Portanto, para modificar o nome, chamaremos primeiramente Get-CsVoiceNormalizationRule, para recuperar a regra cuja Identidade for global/RedmondFourDigit e atribuir o objeto retornado à variável $a. Em seguida, designaremos a cadeia de caracteres RedmondRule à propriedade Name do objeto. A seguir, passaremos a variável para o parâmetro Instance de Set-CsVoiceNormalizationRule, para tornar a modificação permanente.