Compartilhar via

  • Artigo

New-CsOutboundTranslationRule

 

Tópico modificado em: 2012-03-26

Cria uma nova regra de conversão de saída. Uma regra de conversão de saída converte números de telefones para o formato de discagem local, para a interação com sistemas de PBX (Central privada de comutação).

Sintaxe

New-CsOutboundTranslationRule -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Pattern <String>] [-Priority <Int32>] [-Translation <String>] [-WhatIf [<SwitchParameter>]]

New-CsOutboundTranslationRule -Name <String> -Parent <String> [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Pattern <String>] [-Priority <Int32>] [-Translation <String>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Chame esse cmdlet para criar uma nova regra de conversão de saída. O Microsoft Lync Server 2010 normaliza números de telefone para o formato E.164. No entanto, muitos sistemas de PBX não conseguem lidar com esse formato. As regras de conversão de saída convertem o número para o formato de discagem local antes de enviá-lo para o Servidor de Mediação ou Gateway.

Cada regra de conversão de saída é associada a uma configuração de tronco. É possível associar mais de uma regra de conversão de saída a cada configuração. Portanto, a Identidade de cada regra consiste em um escopo, juntamente com um nome que seja exclusivo no âmbito do escopo (no formato escopo/nome. Por exemplo site:Redmond/OBR1). A regra é automaticamente associada à configuração de tronco com o mesmo escopo. Se você chamar New-CsOutboundTranslationRule e especificar um escopo no qual a configuração de tronco ainda não tiver sido definida, a configuração de tronco será criada com o escopo, a regra de conversão de saída e os valores padrão determinados.

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Obrigatório

XdsIdentity

Um identificador exclusivo para a regra de conversão de saída. A Identidade inclui o escopo no qual se aplica a regra, assim como o nome desta, e deve estar no escopo global, de site ou de serviço (somente PSTNGateway). Por exemplo, site:Redmond/OutboundRule1 e PstnGateway:Redmond.litwareinc.com/OutboundRule2.

Se o parâmetro Identidade for especificado, não será possível especificar valores para os parâmetros Nome ou Pai.

Parent

Obrigatório

Cadeia de caracteres

O escopo da regra de conversão de saída. Se for especificado um valor para esse parâmetro, também será necessário especificar um valor para o parâmetro Nome. No entanto, o parâmetro Identidade não pode ser especificado. Se os parâmetros Pai e Nome não forem especificados, a Identidade deverá ser.

Name

Obrigatório

Cadeia de caracteres

O nome da regra de conversão de saída. Se nenhum Nome for fornecido, deverá se especificar uma Identidade que consista no escopo e no nome. Se for fornecido um Nome, o parâmetro Pai também será necessário, mas não será possível especificar uma Identidade.

Description

Opcional

Cadeia de caracteres

Uma descrição da regra de conversão de saída. Essa descrição ajudará a identificar a finalidade da regra.

Pattern

Opcional

Cadeia de caracteres

Uma expressão regular que representa o padrão numérico ao qual a Conversão será aplicada.

Padrão: ^\+(\d*)$

Priority

Opcional

Int32

Se um número corresponder ao Padrão de mais de uma regra de conversão de saída, as regras serão aplicadas por ordem de prioridade. Use esse parâmetro para atribuir uma prioridade à regra.

Translation

Opcional

Cadeia de caracteres

Uma expressão regular que será aplicada ao número que corresponde ao Padrão, para preparar esse número para roteamento de saída.

Padrão: $1

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.Settings.TrunkConfiguration.TranslationRule.

Exemplo

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

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

Este exemplo cria uma nova regra de conversão de saída 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 Identidade 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 um espaço, não será necessário colocar a Identidade entre aspas duplas.

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

New-CsOutboundTranslationRule -Parent global -Name SeattleSevenDigit -Description "Convert to seven digits" -Pattern '^\+1425(\d{7})$' -Translation '$1'

Este exemplo cria uma nova regra de conversão de saída global denominada SeattleSevenDigit. (Observação: Em vez de especificar um Pai e um Nome, podemos criar esta mesma regra especificando - Identidade global/SeattleSevenDigit.) Incluímos uma Descrição que explica que esta regra deve converter números do formato E.164 para um formato de sete dígitos. Além disso, os valores Padrão e Tradução foram especificados. Esses valores convertem um número E.164 (nesse caso, 12 dígitos começando com +1425), especificado pela expressão regular no Padrão, em um número de sete dígitos, removendo os cinco primeiros dígitos. Por exemplo, o número +14255551212 seria convertido no número 5551212.