New-CsSipProxyTransport
Tópico modificado em: 2012-03-27
Especifica o protocolo de transmissão a ser usado em uma rota estática. Microsoft Lync Server 2010 permite escolher o Protocolo de Controle de Transmissão (TCP) ou a Segurança de Camada de Transporte (TLS) como protocolo de transmissão de uma rota.
Sintaxe
New-CsSipProxyTransport -Port <UInt16> -TransportChoice <ITransportChoice>
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 predeterminados pelos administradores do sistema. Quando uma mensagem é recebida por um servidor, o servidor verifica o endereço da mensagem e a encaminha para o servidor do próximo salto que tiver sido preconfigurado 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.
Lync Server 2010 permite definir as rotas estáticas para servidores proxy. Essas rotas são compostas por duas partes principais: definições de configuração de proxy e rotas de proxy SIP. Por sua vez, as rotas de proxy SIP têm várias propriedades; por exemplo, cada rota precisa ter um Transporte, uma propriedade que define o protocolo de rede usado para a transmissão de mensagens pela rota. A propriedade Transport pode ser especificada usando-se o cmdlet New-CsSipProxyTransport.
New-CsSipProxyTransport possui dois parâmetros obrigatórios: TransportChoice e Port. O parâmetro TransportChoice é configurado usando-se outro cmdlet, New-CsSipProxyTCP (para atribuir o Protocolo de Controle de Transmissão como transporte de rota) ou New-CsSipProxyTLS (para atribuir o protocolo TLS como transporte de rota). Qualquer objeto de transporte criado usando-se New-CsSipProxyTransport deve ser salvo em uma variável. Essa variável será então usada para configurar a propriedade Transporte de uma rota de proxy SIP.
Não é necessário usar o cmdlet New-CsSipProxyTransport se você 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-CsSipProxyTransport 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-CsSipProxyTransport"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
Port |
Obrigatório |
Inteiro |
Número da porta usada para roteamento SIP. Por exemplo: -Porta 7742. |
TransportChoice |
Obrigatório |
Objeto de transporte |
Indica o protocolo de transmissão (TCP ou TLS) a ser usado na rota estática. Para usar o protocolo TCP, crie um objeto de transporte usando o cmdlet New-CsSipProxyTCP. Para usar o protocolo TLS, crie um objeto de transporte, usando o cmdlet New-CsSipProxyTLS. |
Tipos de Entrada
Nenhuma. New-CsSipProxyTransport não aceita a entrada canalizada.
Tipos de Retorno
New-CsSipProxyTransport cria novas instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.Transport.
Exemplo
-------------------------- Exemplo 1 ------------------------
$cert = New-CsSipProxyUseDefaultCert
$tls = New-CsSipProxyTLS -Certificate $cert -Fqdn atl-proxy-001.litwareinc.com
$transport = New-CsSipProxyTransport -TransportChoice $tls -Port 7500
Os comandos exibidos no Exemplo 1 criam um novo objeto de transporte de proxy SIP, que usa TLS como seu transporte. Como TLS requer um certificado (a ser usado para fins de autenticação), o primeiro comando no exemplo usa New-CsSipProxyUseDefaultCert para configurar um novo objeto SipProxy.UseDefaultCert. Esse objeto, armazenado em uma variável denominada $cert, instrui Lync Server a usar o certificado padrão do transporte TLS. Após a criação do objeto UseDefaultCert, New-CsSipProxyTLS poderá ser chamado para criar um novo objeto SipProxy.TLS, que use o certificado padrão e aponte para atl-proxy-001.litwareinc.com como nome de domínio totalmente qualificado do servidor do próximo salto.
-------------------------- Exemplo 2 ------------------------
$tcp = New-CsSipProxyTCP -IPAddress 192.168.1.100
$transport = New-CsSipProxyTransport -TransportChoice $tcp -Port 7500
Os comandos exibidos no Exemplo 2 criam um novo objeto de transporte de proxy SIP, que usa TCP como 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 poderá ser chamado, para criar um objeto de transporte TCP.