Compartilhar via

  • Artigo

New-CsSipResponseCodeTranslationRule

 

Tópico modificado em: 2012-03-26

Cria uma nova regra de conversão de código de resposta SIP. Essas regras permitem habilitar administradores para mapear os códigos de resposta SIP com valores entre 400 e 699 para os valores usados pelo Microsoft Lync Server 2010.

Sintaxe

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

New-CsSipResponseCodeTranslationRule -Name <String> -Parent <String> -TranslatedResponseCode <Int32> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Priority <Int32>] [-ReceivedISUPCauseValue <Int32>] [-ReceivedResponseCode <Int32>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

O tronco SIP fornece uma maneira de conectar uma rede VoIP (como Enterprise Voice) à rede telefônica pública comutada (PSTN). No Lync Server 2010, o Servidor de Mediação usa pares de tronco para interagir com a rede PSTN. Quando uma chamada de saída falha na rede PSTN, gera-se automaticamente um código de causa da ISUP (parte do usuário de ISDN). Por exemplo: um gateway da PSTN deve enviar o código de causa 34, para indicar que nenhum circuito ou canal estava disponível para efetuar a chamada. Quando um par de tronco do Servidor de Mediação recebe esse código de causa da ISUP, ele o converte em um código de resposta SIP, que é então 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 com problemas pode receber automaticamente um status "menos preferido", que minimiza o uso desse gateway e maximiza as chances de uma chamada ser efetuada com sucesso.

No entanto, nem todos os gateways usam o código de causa da ISUP recomendado para o mapeamento do código de resposta SIP, usado pelo Lync Server. Nesse caso, os administradores podem usar os cmdlets CsSipResponseCodeTranslationRule, para mapear o código de resposta SIP do gateway (em conjunto com o código de causa ISUP, caso ele esteja disponível) para um código de resposta SIP usado pelo Lync Server. Por exemplo: um gateway pode mapear o código de causa da ISUP 34 ("Nenhum circuito/canal disponível") para o código de resposta SIP 486 ("Ocupado"). Com base em um código de resposta de 486, a lógica de roteamento de saída do Lync Server não tentará encontrar um novo gateway para efetuar 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, que aciona o mecanismo de novas tentativas na lógica de roteamento de saída do Lync Server. Isso significa que o sistema tentará encontrar outro gateway para efetuar a chamada. Para lidar com essa situação, é possível criar uma regra de conversão que mapeie a combinação do código de causa da ISUP 34 e o código de resposta SIP 486 para um código de resposta SIP 503. Essas novas regras de conversão são criadas usando-se o cmdlet New-CsSipResponseCodeTranslationRule. As regras de conversão podem ser atribuídas no escopo global, de site ou de serviço (apenas para o Serviço de Gateway PSTN).

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

Identidade de Xds

Identificador exclusivo da regra de conversão a ser criada. A identidade de uma regra de conversão consiste em duas partes: o escopo no qual deve se atribuir a regra e o nome a ser dado à regra. Por exemplo: uma regra de conversão denominada Rule404, a ser criada no escopo global, teria uma Identidade semelhante a essa: global/Rule404.

Ao criar uma nova regra de conversão, em vez de se utilizar o parâmetro Identity, é possível utilizar os parâmetros Parent e Name.

TranslatedResponseCode

Obrigatório

Inteiro

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

Name

Opcional

Cadeia de caracteres

Nome usado para diferenciar uma regra de conversão de outra. Os nomes devem ser exclusivos dentro de um determinado escopo. Por exemplo: o site Redmond pode ter apenas uma regra de conversão, denominada Rule404. No entanto, é possível que haja uma regra de conversão denominada Rule404 no site de Redmond e outra regra com o mesmo nome no site de Dublin.

O parâmetro Name deve ser sempre usado em conjunto com o parâmetro Parent.

Parent

Opcional

Cadeia de caracteres

Escopo no qual deve se atribuir a nova regra de conversão. Para atribuir uma regra no escopo global, utilize esta sintaxe: -Parent global. Para atribuir uma regra no escopo de site, utilize esta sintaxe: -Parent site:Redmond. Para atribuir uma regra no escopo de serviço, utilize esta sintaxe: -Parent PstnGateway:192.168.0.242.

O parâmetro Parent deve ser sempre usado em conjunto com o parâmetro Name.

Priority

Opcional

Inteiro

Prioridade relativa da regra de conversão. As regras são processadas na ordem de prioridades a elas atribuídas. A primeira regra a ser processada tem uma prioridade 0, a segunda, uma prioridade 1, e assim por diante. Se não for especificada, a nova regra receberá a menor prioridade nesse escopo.

ReceivedISUPCauseValue

Opcional

Inteiro

Valor do código da parte do usuário de ISDN (ISUP) que deve estar presente na mensagem de resposta SIP usada por um gateway ao responder a uma mensagem INVITE. O valor -1 indica que apenas o código de resposta SIP será usado ao se executar a regra de conversão; o código de causa da ISUP será ignorado.

ReceivedResponseCode

Opcional

Inteiro

Valor do código de resposta SIP usado por um gateway ao responder a uma mensagem INVITE. O 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 serão reconhecidos como respostas finais. Como resultado, a regra de conversão nunca será usada. O valor 0 indica que apenas o código de causa da ISUP será usado ao se executar a regra de conversão; o código de resposta SIP será ignorado.

InMemory

Opcional

Parâmetro de opção

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.

Force

Opcional

Parâmetro de opção

Suprime a exibição de qualquer mensagem de erro não-fatal que possa ocorrer durante a execução do comando.

WhatIf

Opcional

Parâmetro de opção

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

Confirm

Opcional

Parâmetro de opção

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

Tipos de Entrada

Nenhuma. New-CsSipResponseCodeTranslationRule não aceita a entrada canalizada.

Tipos de Retorno

New-CsSipResponseCodeTranslationRulecria novas instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.SipResponseCodeTRanslationRule#Decorated.

Exemplo

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

New-CsSipResponseCodeTranslationRule -Identity "PstnGateway:192.168.0.240/Rule404" -ReceivedResponseCode 434 -TranslatedResponseCode 404

O comando exibido no Exemplo 1 cria uma nova regra de conversão de código de resposta SIP com a Identidade PstnGateway:192.168.0.240/Rule404. Essa regra converte o código de resposta 434 recebido no código de resposta SIP padrão 404 (Não encontrado).

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

New-CsSipResponseCodeTranslationRule -Parent "PstnGateway:192.168.0.240" -Name "Rule404" -ReceivedResponseCode 434 -TranslatedResponseCode 404

O comando exibido no Exemplo 2 realiza a mesma tarefa que o comando no Exemplo 1. No entanto, no Exemplo 2, os parâmetros Parent e Name são usados em vez do parâmetro Identity. Isso simplesmente mostra uma maneira alternativa de criar uma nova regra de conversão de código de resposta SIP, que possui a Identidade PstnGateway:192.168.0.240/Rule404.