New-CsSipProxyTCP
Tópico modificado em: 2012-03-25
Cria um novo objeto SipProxy.TCP, que pode ser utilizado para configurar uma rota estática que utilize o TCP (Protocolo de Controle de Transmissão) como seu protocolo de transporte.
Sintaxe
New-CsSipProxyTCP -IPAddress <String>
Descrição Detalhada
Quando uma mensagem SIP for enviada para alguém, é possível que essa mensagem precise atravessar diversas sub-redes e redes antes que seja entregue; o caminho percorrido pela mensagem é geralmente denominado rota. No sistema de redes, há dois tipos de rotas: dinâmica e estática. Com o roteamento dinâmico, os servidores usam algoritmos para determinar o próximo local (o próximo salto) ao qual a mensagem deverá ser encaminhada. Com o roteamento estático, os caminhos das mensagens são pré-determinados pelos administradores do sistema. Quando uma mensagem é recebida por um servidor, ele verifica o endereço da mensagem e a encaminha para o servidor do próximo salto que tiver sido pré-configurado por um administrador. Se forem configuradas corretamente, as rotas estáticas ajudam a garantir a entrega precisa e pontual das mensagens, com o mínimo de sobrecarga aos servidores. A desvantagem das rotas estáticas é que as mensagens não são roteadas novamente de maneira dinâmica no caso de uma falha de rede.
Microsoft Lync Server 2010 permite definir as rotas estáticas para servidores proxy. Essas rotas são compostas por duas partes principais: as definições de configuração de proxy (criadas com New-CsProxyConfiguration) e as rotas de proxy SIP. Por sua vez, as rotas de proxy SIP possuem algumas propriedades; por exemplo, cada rota deve ter um Transporte, uma propriedade que define o protocolo de rede usado para transmitir as mensagens ao longo da rota.
O Lync Server 2010 permite especificar o TCP ou a TLS como protocolo de transporte. Se decidir utilizar o TCP como protocolo, deve-se criar primeiramente um objeto TCP utilizando-se o cmdlet New-CsSipProxyTCP. Esse objeto pode ser usado para especificar o protocolo do objeto de Transporte criado por New-CsSipProxyTransport.
Não é necessário usar New-CsSipProxyTCP, se estiver usando New-CsStaticRoute para criar uma rota estática.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet New-CsSipProxyTCP 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 "New-CsSipProxyTCP"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
IPAddress |
Obrigatório |
Cadeia de caracteres |
O endereço IP do roteador do próximo salto. Por exemplo: -IPAddress 192.168.0.240. |
Tipos de Entrada
Nenhuma. New-CsSipProxyTCP não aceita a entrada canalizada.
Tipos de Retorno
New-CsSipProxyTCP cria novas instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.TCP.
Exemplo
-------------------------- Exemplo 1 ------------------------
$tcp = New-CsSipProxyTCP -IPAddress 192.168.1.100
$transport = New-CsSipProxyTransport -TransportChoice $tcp -Port 7500
Os comandos exibidos no Exemplo 1 criam um novo objeto de transporte de proxy SIP, que usa TCP como seu transporte. Para realizar isso, o primeiro comando no exemplo usa New-CsSipProxyTCP para criar um novo objeto SipProxy.TCP que aponte para o servidor do próximo salto com o endereço IP 192.168.1.100; esse objeto TCP é armazenado em uma variável denominada $tcp.
Depois que o objeto SipProxy.TCP tiver sido criado, o cmdlet New-CsSipProxyTransport criará um objeto de transporte TCP.