Partilhar via

  • Artigo

Get-CsOutboundTranslationRule

 

Tópico modificado em: 2012-03-23

Recupera uma ou mais regras de conversão de saída. Uma regra de conversão de saída converte números de telefone para o formato de discagem local, para a interação com sistemas de PBX (Central privada de comutação) e gateways PSTN.

Sintaxe

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

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

Descrição Detalhada

Esse cmdlet deve ser chamado para recuperar uma regra de conversão de saída existente. 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 de tronco. 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.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

XdsIdentity

O identificador exclusivo da regra de conversão de saída que se deseja recuperar. A Identidade consiste no escopo, seguido de um nome exclusivo ao âmbito de cada escopo (por exemplo, site:Redmond/OutboundRule1). A especificação de um valor de Identity retornará, no máximo, uma regra de conversão de saída.

Filter

Opcional

Cadeia de caracteres

Executa uma pesquisa de identidade utilizando caracteres curinga, permitindo-se que se restrinja os resultados apenas às regras de conversão de saída cujas identidades corresponderem à cadeia de caracteres curinga fornecida.

LocalStore

Opcional

SwitchParameter

Recupera a regra de conversão de saída da réplica local do Repositório de Gerenciamento Central em vez do Repositório de Gerenciamento Central em si.

Tipos de Entrada

Nenhuma.

Tipos de Retorno

Este cmdlet recupera um ou mais objetos do tipo Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TranslationRule.

Exemplo

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

Get-CsOutboundTranslationRule

Este exemplo recupera todas as regras de conversão de saída da implantação do Lync Server 2010.

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

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

Esse exemplo recupera uma única regra de conversão de saída: a regra com a Identidade site:Redmond/Prefix Redmond.

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

Get-CsOutboundTranslationRule -Filter site:*

Este exemplo recupera todas as regras de conversão de saída no nível de site. O comando chama Get-CsOutboundTranslationRule com um filtro de site:*, que retornará uma coleção de todas as regras cujos valores de identidade começarem com a cadeia de caracteres site:.