Compartilhar via

  • Artigo

Get-CsSipResponseCodeTranslationRule

 

Tópico modificado em: 2012-03-23

Retorna informações sobre as regras de conversão do código de resposta SIP. Essas regras permitem aos administradores mapear códigos de resposta SIP com valores entre 400 e 699 aos valores usados pelo Microsoft Lync Server 2010.

Sintaxe

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

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

Descrição Detalhada

O tronco SIP oferece uma maneira de se conectar uma rede de protocolo VoIP (como o Enterprise Voice) à PSTN (rede telefônica pública comutada). No Lync Server 2010, o Servidor de Mediação usa pares do tronco para interagir com a rede PSTN. Quando uma chamada de saída falha na rede PSTN, um código de causa ISUP (parte de usuário ISDN, em inglês) é gerado automaticamente. Por exemplo, um gateway PSTN pode enviar o código de causa 34 para indicar que nenhum circuito ou canal estava disponível para completar a chamada. Quando um par de tronco do Servidor de Mediação recebe um código de causa ISUP, ele converte o código em um código de resposta SIP, que em seguida é enviado para o próprio Servidor de Mediação. Por sua vez, o Lync Server usa esses códigos de resposta para tomar suas decisões de roteamento de saída. Por exemplo, um gateway que não esteja funcionando direito pode receber automaticamente um status de “não preferencial”, minimizando seu uso e maximizando as chances de uma chamada ser concluída com êxito.

No entanto, nem todos os gateways usam o mapeamento de código de causa ISUP em código de resposta SIP recomendado usado pelo Lync Server 2010. Nesses gateways, os administradores podem usar os cmdlets CsSipResponseCodeTranslationRule para mapear o código de resposta SIP do gateway (em combinação ao código de causa ISUP, se estiver disponível) para um código de resposta SIP usado pelo Lync Server. Por exemplo, um gateway pode mapear o código de causa ISUP 34 (que indica que nenhum canal ou circuito está disponível) a um código de resposta SIP 486 (que indica “ocupado”). Com base em um código de resposta 486, a lógica de roteamento de saída do Lync Server não tentará encontrar um novo gateway para completar a chamada.

Para o Lync Server, no entanto, esse código de resposta SIP 486 deve ser mapeado para o código de resposta SIP 503. Um código de resposta 503 ativa o mecanismo de nova tentativa na lógica de roteamento de saída do Lync Server; isso significa que o sistema vai tentar encontrar outro gateway para completar a chamada. Para lidar com essa situação, você pode criar uma regra de conversão que mapeie a combinação de código de causa ISUP 34 e o código de resposta SIP 486 a um código de resposta SIP 503.

O cmdlet Get-CsSipResponseCodeTranslationRule permite recuperar informações sobre todas as regras de conversão configuradas para uso na organização.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

Xds Identity

Identificador exclusivo para a regra de conversão. A identidade de uma regra de conversão consiste em duas partes: o escopo em que a regra foi configurada e o nome dado à regra quando ela foi criada. Por exemplo, uma regra de conversão chamada Rule404 criada no escopo global teria uma Identity semelhante a esta: global/Rule404.

Além do escopo global, as regras de conversão também podem ser criadas no escopo do site ou no escopo do serviço (embora apenas para o serviço PstnGateway).

Para retornar todas as regras de conversão criadas para um determinado site ou serviço, basta especificar a Identity do site ou do serviço. Por exemplo:

-Identity "site:Redmond"

Se esse parâmetro for omitido, Get-CsSipResponseCodeTranslationRule retornará uma coleção de todas as regras de conversão do código de resposta SIP.

Filter

Opcional

Cadeia de caracteres

Permite a você usar curingas ao especificar a regra (ou regras) de conversão a ser retornada. Por exemplo, esta sintaxe retorna todas as regras de conversão com o valor da cadeia de caracteres "404" na Identity:

-Filter "*404*"

LocalStore

Opcional

Parâmetros de opção

Obtém os dados da regra de conversão de código de resposta SIP 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. Get-CsSipResponseCodeTranslationRule não aceita entrada em pipeline.

Tipos de Retorno

Get-CsSipResponseCodeTranslationRule retorna instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.SipResponseCodeTRanslationRule#Decorated.

Exemplo

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

Get-CsSipResponseCodeTranslationRule

O comando mostrado no Exemplo 1 retorna uma coleção de todas as regras de conversão do código de resposta para uso na organização. Isso é feito chamando-se Get-CsSipResponseCodeTranslationRule sem nenhum parâmetro.

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

Get-CsSipResponseCodeTranslationRule -Identity "PstnGateway:192.168.0.240/Rule404"

O comando anterior retorna uma única regra de conversão do código de resposta: a regra com Identity PstnGateway:192.168.0.240/Rule404.

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

Get-CsSipResponseCodeTranslationRule -Filter "site:*"

No Exemplo 3, o parâmetro Filter é usado para limitar os dados retornados a todas as regras de conversão do código de resposta configuradas no escopo do site. O valor de filtro "site:*" limita os dados retornados a regras que tenham uma Identity começando com o valor da cadeia de caracteres "site:".

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

Get-CsSipResponseCodeTranslationRule | Where-Object {$_.ReceivedISUPCauseValue -eq -1}

O comando mostrado no Exemplo 4 retorna uma coleção de todas as regras de conversão do código de resposta em que nenhum valor foi configurado para a propriedade ReceivedISUPCauseValue. Para isso, o comando chama inicialmente Get-CsSipResponseCodeTranslationRule sem nenhum parâmetro para retornar uma coleção de todas as regras de conversão do código de resposta atualmente em uso. Em seguida, essa coleção é redirecionada para o cmdlet Where-Object, que separa apenas as regras nas quais a propriedade ReceivedISUPCauseValue seja igual a -1.