Compartilhar via

  • Artigo

New-CsVoiceNormalizationRule

 

Tópico modificado em: 2012-03-26

Cria uma nova 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

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

New-CsVoiceNormalizationRule -Name <String> -Parent <String> [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-IsInternalExtension <$true | $false>] [-Pattern <String>] [-Priority <Int32>] [-Translation <String>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Este cmdlet cria uma regra de normalização de voz nomeada. 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 criadas por 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 através da propriedade NormalizationRules retornada por uma chamada ao cmdlet Get-CsDialPlan. Não se pode criar uma regra de normalização, a menos que exista um plano de discagem cuja identidade corresponda ao escopo especificado na identidade da regra de normalização. Por exemplo, não se pode criar uma regra de normalização com a identidade site:Redmond/RedmondNormalizationRule, a menos que já exista um plano de discagem para site:Redmond.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

XdsIdentity

Um identificador exclusivo para a regra. A identidade especificada deve incluir o escopo, seguido por uma barra invertida e pelo nome. Por exemplo: site:Redmond/Rule1, onde site:Redmond é o escopo e Rule1 é o nome. A parte correspondente ao nome será automaticamente armazenada na propriedade Name. Não se pode especificar valores para Identity e Name no mesmo comando.

As regras de normalização de voz podem ser criadas nos seguintes escopos: global, site, serviço (Registrador e apenas PSTNGateway) e por usuário. É necessário que já haja um plano de discagem com uma Identidade que corresponda ao escopo da regra de normalização, para que se possa criar uma nova regra. (para recuperar uma lista dos planos de discagem, chame o cmdlet Get-CsDialPlan).

O parâmetro Identity é obrigatório, a menos que o parâmetro Parent seja especificado. Não se pode incluir o parâmetro Identity e o parâmetro Parent no mesmo comando.

Name

Obrigatório

Cadeia de caracteres

O nome da regra. Este parâmetro é obrigatório, se houver sido especificado um valor para o parâmetro Parent. Se nenhum valor tiver sido especificado para o parâmetro Parent, Name assumirá o nome que tiver sido especificado no parâmetro Identity. Por exemplo, se uma regra for criada com a Identidade site:Redmond/RedmondRule, o Nome assumirá o valor RedmondRule. O parâmetro Nome e o parâmetro Identidade não podem ser usados no mesmo comando.

Parent

Obrigatório

Cadeia de caracteres

O escopo no qual a nova regra de normalização será criada. Este valor deve ser global: site:<sitename>, onde <sitename> é o nome do site Lync Server; serviço de gateway PSTN ou Registrador, como PSTNGateway:redmond.litwareinc.com; ou uma cadeia de caracteres designando uma regra por usuário. Deve existir um plano de discagem com o escopo especificado, senão o comando falhará.

O parâmetro Parent é obrigatório, a menos que o parâmetro Identity seja especificado. Não se pode incluir o parâmetro Identity e o parâmetro Parent no mesmo comando. Caso o parâmetro Parent seja incluído, o parâmetro Name também será obrigatório.

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 à organização. 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.

Padrão: False

Pattern

Opcional

Cadeia de caracteres

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

Padrão: ^(\d{11})$ (o padrão representa qualquer conjunto de números até onze dígitos.)

Priority

Opcional

Int32

A ordem na qual serão aplicadas as regras. Um número de telefone poderia corresponder a mais de uma regra. Este parâmetro define a ordem na qual as regras testarão o número.

Translation

Opcional

Cadeia de caracteres

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

Padrão: +$1(o padrão prefixa o número com um sinal de adição [+]).

Force

Opcional

SwitchParameter

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

InMemory

Opcional

SwitchParameter

Cria uma referência de objeto, sem na verdade executar o objeto como uma alteração permanente. Se a saída deste cmdlet for atribuída, chamando-o com este parâmetro a uma variável, você poderá realizar alterações às propriedades da referência do objeto e executar estas alterações, chamando-se o cmdlet coincidente Set- deste cmdlet.

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

Nenhuma.

Tipos de Retorno

Este cmdlet cria um objeto do tipo Microsoft.Rtc.Management.WritableConfig.Policy.Voice.NormalizationRule.

Exemplo

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

New-CsVoiceNormalizationRule -Identity "site:Redmond/Prefix Redmond"

Este exemplo cria uma nova regra de normalização de voz para o site de Redmond denominado Prefix Redmond. Como nenhum outro parâmetro é especificado, a regra é criada com os valores padrão. Observe que o valor passado ao parâmetro Identity está entre aspas duplas; isto ocorre porque o nome da regra (Prefix Redmond) contém um espaço. Se o nome de regra não contiver espaços, não será necessário colocar a identidade entre aspas duplas.

Tenha em mente que, para que este comando funcione, deve existir um plano de discagem para o site de Redmond. Pode-se criar um novo plano de discagem, chamando-se o cmdlet New-CsDialPlan.

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

New-CsVoiceNormalizationRule -Parent SeattleUser -Name SeattleFourDigit -Description "Dialing with internal four-digit extension" -Pattern '^(\d{4})$' -Translation '+1206555$1'

Este exemplo cria uma nova regra de normalização de voz, denominada SeattleFourDigit, que se aplica ao plano de discagem por usuário cuja identidade é SeattleUser. (Observação: em vez de especificar um Parent e um Name, poderia ter sido criada esta mesma regra especificando-se -Identity SeattleUser/SeattleFourDigit.) Incluiu-se uma descrição explicando que esta regra serve para converter números de ramal discados internamente com apenas quatro dígitos. Além disso, os valores Pattern e Translation foram especificados. Esses valores convertem um número de quatro dígitos (especificado pela expressão regular em Pattern) no mesmo número de quatro dígitos, mas prefixado pelo valor de Translation (+1206555). Por exemplo, se o ramal 1234 fosse digitado, esta regra converteria esse ramal no número +12065551234.

Observe as aspas simples nos valores de Pattern e Translation. As aspas simples são necessárias para esses valores. O uso de aspas duplas ou a sua ausência não funcionará nessa instância.

Como no Exemplo 1, deve existir um plano de discagem com o escopo dado. Neste caso, isso significa que já deve existir um plano de discagem com a identidade SeattleUser.