Compartilhar via

  • Artigo

Remove-CsSipResponseCodeTranslationRule

 

Tópico modificado em: 2012-03-26

Remove uma 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

Remove-CsSipResponseCodeTranslationRule -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-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 entidades de mesmo nível 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 concluir a chamada. Quando uma entidade de mesmo nível de tronco do Servidor de Mediação recebe esse código de causa da ISUP, ela o converte em um código de resposta SIP, que será 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 receber automaticamente um status "menos preferido", que minimiza o uso desse gateway e maximiza as chances de uma chamada ser concluída 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 da 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 486, a lógica de roteamento de saída do Lync Server não tentará encontrar um novo gateway para concluir 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 concluir 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.

Remove-CsSipResponseCodeTranslationRule permite excluir qualquer regra de conversão configurada anteriormente para uso na organização.

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Obrigatório

Identidade de Xds

Identificador exclusivo da regra de conversão a ser removida. 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 denominada Rule404, que tenha sido criada no escopo global, teria uma Identidade semelhante a essa: global/Rule404.

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

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

Tipos de Retorno

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

Exemplo

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

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

O comando exibido no Exemplo 1 exclui uma única regra de conversão de código de resposta: A regra que possui a Identidade PstnGateway:192.168.0.240/Rule404.

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

Get-CsSipResponseCodeTranslationRule -Filter "service:PstnGateway:192.168.0.240/*" | Remove-CsSipResponseTranslationCode

No Exemplo 2, todas as regras de conversão de código de resposta são removidas do gateway PSTN 192.168.0.240. Para realizar isso, o comando primeiramente chama Get-CsSipResponseCodeTranslationRule, juntamente com o parâmetro Filter. O valor de filtro "service:PstnGateway:192.168.0.240/*" limita os dados retornados às regras que possuírem uma Identidade iniciada pelo valor de cadeia de caracteres "service:PstnGateway:192.168.0.240/". Esta coleção filtrada será então canalizada para Remove-CsSipResponseTranslationCode, que excluirá cada regra na coleção.

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

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

O comando anterior exclui todas as regras de conversão de código de resposta nas quais não se tiver configurado valores da propriedade ReceivedISUPCauseValue. Para fazer isso, o comando primeiramente chama Get-CsSipResponseCodeTranslationRule, sem nenhum parâmetro, para retornar uma coleção de todas as regras de conversão de código de resposta em uso. Essa coleção será então canalizada para o cmdlet Where-Object, que selecionará apenas as regras cuja propriedade ReceivedISUPCauseValue for igual a -1.

A partir daí, a coleção filtrada será canalizada para Remove-CsSipResponseTranslationCode, que excluirá cada regra na coleção.