New-CsSipProxyTransport
Ultima modifica dell'argomento: 2012-03-27
Specifica il protocollo di trasmissione da utilizzare in una route statica. Microsoft Lync Server 2010 consente di scegliere tra TCP (Transmission Control Protocol) o TLS (Transport Layer Security) come protocollo di trasmissione per una route.
Sintassi
New-CsSipProxyTransport -Port <UInt16> -TransportChoice <ITransportChoice>
Descrizione dettagliata
Quando si invia un messaggio SIP, è possibile che il messaggio debba attraversare diverse subnet e reti prima di essere recapitato. Il percorso seguito dal messaggio è spesso definito route. Nelle reti esistono due tipi di route: dinamica e statica. Con il routing dinamico, i server utilizzano algoritmi per determinare la posizione successiva (vale a dire l'hop successivo) a cui dovrebbe essere inoltrato un messaggio. Con il routing statico, i percorsi seguiti dai messaggi sono determinati anticipatamente dagli amministratori di sistema. Quando riceve un messaggio, il server controlla l'indirizzo del messaggio e inoltra il messaggio stesso al server dell'hop successivo configurato anticipatamente da un amministratore. Se la configurazione è corretta, le route statiche aiutano a garantire un recapito tempestivo e accurato dei messaggi, applicando un sovraccarico minimo sui server. Le route statiche presentano lo svantaggio di non reinstradare in modo dinamico i messaggi in caso di errore di rete.
Lync Server 2010 consente di configurare route statiche per i server proxy. Queste route sono composte di due elementi primari: le impostazioni di configurazione proxy e le route proxy SIP. A loro volta, le route proxy SIP dispongono di numerose proprietà. Ciascuna route ad esempio deve disporre di una proprietà Transport che definisce il protocollo di rete utilizzato per trasmettere messaggi nella route. È possibile specificare la proprietà Transport tramite il cmdlet New-CsSipProxyTransport.
New-CsSipProxyTransport richiede due parametri obbligatori: TransportChoice e Port. Il parametro TransportChoice viene configurato utilizzando un altro cmdlet, ovvero New-CsSipProxyTCPNew-CsSipProxyTCP per assegnare TCP come protocollo di trasporto della route oppure New-CsSipProxyTLS per assegnare TLS come protocollo di trasporto della route. Ogni oggetto trasporto creato tramite New-CsSipProxyTransport deve essere salvato in una variabile. Tale variabile deve quindi essere utilizzata per configurare la proprietà Transport di una route proxy Sip.
Non è necessario utilizzare il cmdlet New-CsSipProxyTransport se si utilizza New-CsStaticRoute per creare una route statica.
Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet New-CsSipProxyTransport i membri dei seguenti gruppi: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control) a cui è stato assegnato questo cmdlet, inclusi gli eventuali ruoli RBAC personalizzati creati dall'utente, dal prompt di Windows PowerShell eseguire il seguente comando:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsSipProxyTransport"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Port |
Obbligatorio |
Numero intero |
Numero di porta utilizzato per il routing SIP. Ad esempio: -Port 7742. |
TransportChoice |
Obbligatorio |
Oggetto trasporto |
Indica il protocollo di trasmissione, TCP o TLS, da utilizzare per la route statica. Per utilizzare il protocollo TCP, creare un oggetto trasporto utilizzando il cmdlet New-CsSipProxyTCP. Per utilizzare il protocollo TLS, creare un oggetto trasporto utilizzando il cmdlet New-CsSipProxyTLS. |
Tipi di input
Nessuno. New-CsSipProxyTransport non accetta l'input da pipeline.
Tipi restituiti
New-CsSipProxyTransport crea nuove istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.Transport.
Esempio
-------------------------- Esempio 1 ------------------------
$cert = New-CsSipProxyUseDefaultCert
$tls = New-CsSipProxyTLS -Certificate $cert -Fqdn atl-proxy-001.litwareinc.com
$transport = New-CsSipProxyTransport -TransportChoice $tls -Port 7500
Con i comandi mostrati nell'esempio 1 viene creato un nuovo oggetto trasporto proxy SIP che utilizza TLS come protocollo di trasporto. Poiché il protocollo TLS richiede un certificato da utilizzare per l'autenticazione, nel primo comando dell'esempio viene utilizzato New-CsSipProxyUseDefaultCert per configurare un nuovo oggetto SipProxy.UseDefaultCert. Questo oggetto, archiviato in una variabile denominata $cert, indica a Lync Server di utilizzare il certificato predefinito per il trasporto TLS. Dopo aver creato l'oggetto UseDefaultCert, è possibile chiamare New-CsSipProxyTLS per creare un nuovo oggetto SipProxy.TLS, che utilizza il certificato predefinito e punta ad atl-proxy-001.litwareinc.com come nome di dominio completo (FQDN) per il server dell'hop successivo.
-------------------------- Esempio 2 ------------------------
$tcp = New-CsSipProxyTCP -IPAddress 192.168.1.100
$transport = New-CsSipProxyTransport -TransportChoice $tcp -Port 7500
Con i comandi mostrati nell'esempio 2 viene creato un nuovo oggetto trasporto proxy SIP che utilizza TCP come protocollo di trasporto. A tale scopo, nel primo comando nell'esempio viene utilizzato New-CsSipProxyTCP per creare un nuovo oggetto SipProxy.TCP che punta al server dell'hop successivo con indirizzo IP 192.168.1.100. Questo oggetto TCP è archiviato in una variabile denominata $tcp.
Una volta creato l'oggetto SipProxy.TCP, è possibile chiamare il cmdlet New-CsSipProxyTransport per creare un oggetto trasporto TCP.