Compartilhar via

  • Artigo

Get-CsVoiceNormalizationRule

 

Tópico modificado em: 2012-03-23

Retorna as informações sobre as regras de normalização de voz usadas na sua organização. As regras de normalização de voz convertem os requisitos de discagem de telefone (por exemplo, discar 9 para acessar uma linha externa) para o formato de número de telefone E.164 usado pelo Microsoft Lync Server 2010.

Sintaxe

Get-CsVoiceNormalizationRule [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsVoiceNormalizationRule [-Filter <String>] [-LocalStore <SwitchParameter>]

Descrição Detalhada

Este cmdlet devolve uma regra de normalização de voz denominada ou uma coleção de regras de normalização de voz. Estas regras são uma parte necessária da autorização de telefone e roteamento de chamada. Elas definem os requisitos para converter--ou traduzir--números de um formato interno do Lync Server 2010 para um formato padrão (E.164). A compreensão de expressões regulares é útil a fim de definir padrões de números que serão traduzidos.

As mesmas regras acessadas por este cmdlet também podem ser acessadas pela propriedade NormalizationRules devolvida por uma chamada para o cmdlet Get-CsDialPlan.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

XdsIdentity

Um identificador único para a regra. Se um valor for especificado para este parâmetro, ele deve estar no formato escopo/nome; por exemplo, site:Redmond/Rule1, em que site:Redmond é o escopo e Rule 1 é o nome.

Filter

Opcional

XdsIdentityFilter

Usa cadeias de caracteres curingas para devolver uma coleção de regras de normalização baseadas em Identity. Observe que o Filtro funciona apenas na parte de escopo da Identity, não no nome. Por exemplo, o valor de filtro *lob* retornará todas as regras em escopo global (escopos que contenham as letras lob), mas não uma regra com Identity site:Redmond/lobby, em que lob está apenas na porção de nome da identidade, e não no escopo.

LocalStore

Opcional

SwitchParameter

Recupera a regra de normalização de voz a partir da réplica local do Repositório de Gerenciamento Central, e não do Repositório de Gerenciamento Central em si.

Tipos de Entrada

Nenhuma.

Tipos de Retorno

Get-CsVoiceNormalizationRule retorna instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.NormalizationRule.

Exemplo

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

Get-CsVoiceNormalizationRule

Este exemplo recupera todas as regras de normalização de voz definidas para a organização.

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

Get-CsVoiceNormalizationRule -Filter site*

O Exemplo 2 recupera todas as regras de normalização de voz especificadas para todos os sites.

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

Get-CsVoiceNormalizationRule -Filter *s*

O Exemplo 3 recupera todas as regras de normalização de voz com a letra s em qualquer lugar do escopo. Por exemplo, isto irá retornar todas as regras em nível de site e serviço, além das regras por usuário com um s no nome do escopo, como RedmondEastUsers.

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

Get-CsVoiceNormalizationRule | Where-Object {$_.Name -match "seattle"}

O parâmetro Filtro usado os Exemplos 2 e 3 combina somente na parte de escopo da Identidade. Este exemplo executa uma combinação na mesma parte para retornar todas as regras com um Nome contendo a cadeia de caracteres "seattle". Para fazer isto, primeiro chamamos o Get-CsVoiceNormalizationRule para recuperar todas as regras de normalização para a organização. Nós então canalizamos esta coleção para o cmdlet Where-Object para localizar todos os itens na coleção em que a propriedade Nome combina com a cadeia de caracteres "seattle".