Compartilhar via

  • Artigo

Set-CsOutboundTranslationRule

 

Tópico modificado em: 2012-03-26

Modifica uma regra existente 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

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

Set-CsOutboundTranslationRule [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Pattern <String>] [-Priority <Int32>] [-Translation <String>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

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. Chame esse cmdlet para modificar uma regra de conversão de saída existente.

Cada regra de conversão de saída é associada a uma configuração de tronco. Isso significa que a utilização desse cmdlet para modificar uma regra afetará a configuração de tronco correspondente. É 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. O ato de chamar Set-CsOutboundTranslationRule é a maneira recomendada de alterar as regras de conversão de saída em uma configuração de tronco.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Set-CsOutboundTranslationRule localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet tiver sido atribuído (inclusive qualquer função RBAC personalizada que tiver sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

Cadeia de caracteres

O identificador exclusivo da regra de conversão de saída que se deseja modificar. A Identidade consiste no escopo, seguido de um nome exclusivo ao âmbito de cada escopo. Por exemplo, site:Redmond/OutboundRule1.

Instance

Opcional

TranslationRule

Uma referência de objeto a uma regra de conversão de saída. Este objeto deve ser do tipo Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TranslationRule, que pode ser recuperado chamando-se Get-CsOutboundTranslationRule.

Description

Opcional

Cadeia de caracteres

Uma descrição intuitiva da regra de conversão de saída. Essa descrição pode ser usada para ajudar os administradores a identificar claramente o propósito 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.

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.

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.Settings.TrunkConfiguration.TranslationRule. Aceita entradas canalizadas dos objetos de regra de conversão de saída.

Tipos de Retorno

Este cmdlet não retorna um valor. Ele modifica um objeto do tipo Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TranslationRule.

Exemplo

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

Set-CsOutboundTranslationRule -Identity "site:Redmond/Prefix Redmond" -Description "Convert to seven digits" -Pattern '^\+1425(\d{7})$' -Translation '$1'

Este exemplo modifica a regra de conversão de saída cuja identidade for site:Redmond/Prefix Redmond. Incluímos uma Descrição, que explica que esta regra deve converter números do formato E.164 em um número de telefone de sete dígitos. Além disso, especificaram-se os valores de Pattern e Translation, o que modificará os valores existentes dessas propriedades. 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.

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

$a = Get-CsOutboundTranslationRule -Identity "site:Redmond/OBR1"
$a.Name = "Outbound Rule 1"
Set-CsOutboundTranslationRule -Instance $a

Esse exemplo modifica a propriedade Name de uma regra de conversão de saída. Observe que isso resultará na alteração da Identidade dessa regra. O primeiro comando nesse exemplo é uma chamada ao cmdlet Get-CsOutboundTranslationRule. Especificamos uma Identidade de site:Redmond\OBR1, que irá retornar uma regra de conversão, apresentando a Identidade determinada. Em vez de exibir essa regra, a atribuímos à variável $a. A linha 2 desse exemplo atribui a cadeia de caracteres "Outbound Rule 1" à propriedade Name da variável $a, a variável que contém uma referência à regra site:Redmond/OBR1. Na última linha desse exemplo, chamamos Set-CsOutboundTranslationRule, especificando o parâmetro Instance e passando-o para a variável $a. Se agora chamarmos Get-CsOutboundTranslationRule com um valor de Identidade site:Redmond/OBR1, nada será retornado. Isso ocorre porque a regra com essa Identidade não existe mais. Ela foi substituída pela mesma regra com a Identidade site:Redmond/Outbound Rule 1.