New-CsSipProxyTCP
Ultima modifica dell'argomento: 2012-03-25
Crea un nuovo oggetto SipProxy.TCP che può essere utilizzato per configurare una route statica per l'uso di TCP (Transmission Control Protocol) come protocollo di trasporto.
Sintassi
New-CsSipProxyTCP -IPAddress <String>
Descrizione dettagliata
Quando si invia un messaggio SIP, il messaggio potrebbe dover attraversare molteplici subnet e reti prima di essere recapitato; il percorso seguito dal messaggio è spesso definito route. Nelle reti esistono due tipi di route: dinamiche e statiche. 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. Lo svantaggio delle route statiche è dovuto al fatto che i messaggi non vengono reinstradati in modo dinamico se si verifica un errore di rete.
Microsoft Lync Server 2010 consente di impostare le route statiche per i server proxy. Queste route sono composte di due elementi primari: impostazioni di configurazione proxy (create utilizzando New-CsProxyConfiguration) e route proxy SIP. A loro volta, le route del proxy SIP dispongono di numerose proprietà; ad esempio, ogni route deve avere una proprietà Transport che definisce il protocollo di rete utilizzato per la trasmissione dei messaggi lungo la route.
Lync Server 2010 consente di specificare sia TCP (Transmission Control Protocol) che TLS (Transport Layer Security) come protocollo di trasporto. Se si decide di utilizzare TCP come protocollo, è necessario per prima cosa creare un oggetto TCP utilizzando il cmdlet New-CsSipProxyTCP. È possibile poi utilizzare quell'oggetto per specificare il protocollo per l'oggetto Transport creato da New-CsSipProxyTransport.
Non è necessario utilizzare New-CsSipProxyTCP se si utilizza New-CsStaticRoute per creare la route statica.
Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet New-CsSipProxyTCP in locale: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control, controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (compresi eventuali ruoli RBAC personalizzati creati autonomamente), eseguire il cmdlet riportato di seguito dal prompt di Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsSipProxyTCP"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
IPAddress |
Obbligatorio |
Stringa |
Indirizzo IP del router dell'hop successivo. Ad esempio: -IPAddress 192.168.0.240. |
Tipi di input
Nessuno. New-CsSipProxyTCP non accetta l'input da pipeline.
Tipi restituiti
New-CsSipProxyTCP consente di creare nuove istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.TCP.
Esempio
-------------------------- Esempio 1 ------------------------
$tcp = New-CsSipProxyTCP -IPAddress 192.168.1.100
$transport = New-CsSipProxyTransport -TransportChoice $tcp -Port 7500
Con i comandi mostrati nell'esempio 1 viene creato un nuovo oggetto trasporto proxy SIP che utilizza TCP come protocollo di trasporto. A tal fine, il primo comando nell'esempio utilizza New-CsSipProxyTCP per creare un nuovo oggetto SipProxy.TCP che fa riferimento all'hop del server successivo con l'indirizzo IP 192.168.1.100; questo oggetto TCP è memorizzato nella variabile denominata $cred1.
Dopo che è stato creato l'oggetto SipProxy.TCP, il cmdlet New-CsSipProxyTransport consente di creare un oggetto trasporto TCP.