Compartilhar via

  • Artigo

Set-CsSipResponseCodeTranslationRule

 

Tópico modificado em: 2012-03-27

Modifica uma regra de conversão do código de resposta do SIP existente. 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

Set-CsSipResponseCodeTranslationRule [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Priority <Int32>] [-ReceivedISUPCauseValue <Int32>] [-ReceivedResponseCode <Int32>] [-TranslatedResponseCode <Int32>] [-WhatIf [<SwitchParameter>]]

Set-CsSipResponseCodeTranslationRule [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Priority <Int32>] [-ReceivedISUPCauseValue <Int32>] [-ReceivedResponseCode <Int32>] [-TranslatedResponseCode <Int32>] [-WhatIf [<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. 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.

Set-CsSipResponseCodeTranslationRule permite modificar qualquer uma das regras de conversão configuradas anteriormente para uso na organização.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

Xds Identity

Identificador único para a regra de conversão a ser modificada. A Identidade de uma regra de conversão consiste de duas partes: o escopo onde a regra foi configurada, e o nome dado a regra quando ela foi criada. Por exemplo, a regra de conversão chamada Rule404 que foi criada no escopo global teria uma Identity parecida com esta: global/Rule404.

Instance

Opcional

Número inteiro

Permite passar uma referência a um objeto para o cmdlet, em vez de definir valores de parâmetros individuais.

TranslatedResponseCode

Obrigatório

Inteiro

Valor do código de resposta SIP para o qual o ReceivedResponseCode e/ou o ReceivedISUPCauseCode devem ser convertidos. Os códigos de resposta convertidos podem ser qualquer valor inteiro entre 400 e 699, inclusive.

Priority

Inteiro

Prioridade relativa da regra de conversão. As regras são processadas na ordem das prioridades atribuídas a elas; a primeira regra a ser processada tem prioridade 0; a segunda tem prioridade 1, e assim por diante.

ReceivedISUPCauseValue

Opcional

Inteiro

Valor do código ISUP que precisa estar presente na mensagem de resposta SIP usada por um gateway ao responder a uma mensagem INVITE. Um valor igual a -1 indica que só o código de resposta SIP vai ser usado na execução da regra de conversão; o código de causa ISUP será ignorado.

ReceivedResponseCode

Opcional

Inteiro

Valor do código de resposta SIP usado por um gateway ao responder a uma mensagem INVITE. Um código de resposta pode ser qualquer valor inteiro entre 400 e 699, inclusive. Embora o cmdlet aceite valores inteiros menores do que 400, eles não são reconhecidos como respostas finais. Como resultado, a regra de conversão nunca será usada. Um valor igual a 0 indica que só o código de causa ISUP vai ser usado na execução da regra de conversão; o código de resposta SIP será ignorado.

Force

Parâmetro de Opção

Suprime a exibição de mensagens de erro não fatais que possam ocorrer na execução do comando.

WhatIf

Parâmetro de Opção

Descreve o que aconteceria se o comando fosse executado sem ser executado de fato.

Confirm

Parâmetro de Opção

Solicita confirmação antes da execução do comando.

Tipos de Entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.SipResponseCodeTranslationRule#Decorated. Set-CsSipResponseCodeTranslationRule aceita instâncias em pipeline do objeto de regra de conversão do código de resposta SIP.

Tipos de Retorno

Set-CsSipResponseCodeTranslationRule não retorna nenhum objeto ou valor. Em vez disso, o cmdlet modifica instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.SipResponseCodeTranslationRule#Decorated.

Exemplo

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

Set-CsSipResponseCodeTranslationRule -Identity "PstnGateway:192.168.0.240/Rule404" -ReceivedISUPCauseValue 477

O comando mostrado no Exemplo 1 modifica a propriedade ReceivedISUPCauseValue da regra de conversão com Identidade PstnGateway:192.168.0.240/Rule404.

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

Set-CsSipResponseCodeTranslationRule -Identity "PstnGateway:192.168.0.240/Rule404" -Priority 0

No Exemplo 2, a regra de conversão com Identidade PstnGateway:192.168.0.240/Rule404 é marcada como a regra de mais alta prioridade, ou seja, a que será processada em primeiro lugar. Para isso, a propriedade Priority é definida como 0.

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

Get-CsSipResponseCodeTranslationRule | Set-CsSipResponseCodeTranslationRule -ReceivedISUPCauseValue -1

O Exemplo 3 mostra como definir a propriedade ReceivedISUPCauseValue de todas as regras de conversão configuradas para uso em sua organização como -1; isso fará com que o código de causa ISUP seja ignorado ao converter regras. 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 é canalizada para o cmdlet Set-CsSipResponseCodeTranslationRule, que modifica a propriedade ReceivedISUPCauseValue de todos os itens da coleção.