New-CsSipProxyTransport
Letztes Änderungsdatum des Themas: 2012-03-27
Gibt das Übertragungsprotokoll an, das in einer statischen Route verwendet werden soll. Microsoft Lync Server 2010 ermöglicht Ihnen die Auswahl zwischen TCP (Transmission Control Protocol) oder TLS (Transport Layer Security) als Übertragungsprotokoll für eine Route.
Syntax
New-CsSipProxyTransport -Port <UInt16> -TransportChoice <ITransportChoice>
Detaillierte Beschreibung
Wenn Sie eine SIP-Nachricht (Session Initiation Protocol) senden, muss diese Nachricht unter Umständen mehrere Subnetze und Netzwerke durchlaufen, bevor sie am Ziel ankommt. Der dabei von der Nachricht genommene Pfad wird häufig als Route bezeichnet. In Netzwerken gibt es zwei Arten von Routen: dynamische und statische Routen. Beim dynamischen Routing verwenden Server Algorithmen, um die nächste Position (den nächsten Hop) anzugeben, an die (bzw. den) eine Nachricht weitergeleitet werden soll. Beim statischen Routing werden die Nachrichtenpfade von den Systemadministratoren vorab festgelegt. Wenn der Server eine Nachricht empfängt, überprüft er die Nachrichtenadresse und leitet die Nachricht dann an den als nächsten Hop von einem Administrator festgelegten Server weiter. Die ordnungsgemäße Konfiguration der statischen Routen stellt eine zeitgerechte und akkurate Zustellung der Nachrichten sicher, und das bei nur minimalem Serveraufwand. Der Nachteil statischer Routen ist, dass Nachrichten im Falle eines Netzwerkfehlers nicht erneut dynamisch weitergeleitet werden.
Lync Server 2010 ermöglicht Ihnen das Einrichten statischer Routen für Proxyserver. Diese Routen bestehen aus zwei Hauptteilen: Proxykonfigurationseinstellungen und SIP-Proxyrouten. SIP-Proxyrouten haben mehrere Eigenschaften, z. B. muss jede Route über eine Transporteigenschaft verfügen, mit der das für die Übertragung von Nachrichten über die Route verwendete Netzwerkprotokoll definiert wird. Die Transporteigenschaft kann über das Cmdlet New-CsSipProxyTransport angegeben werden.
New-CsSipProxyTransport weist zwei erforderliche Parameter auf: "TransportChoice" und "Port". Der Parameter "TransportChoice" wird über ein anderes Cmdlet – New-CsSipProxyTCP (zum Zuweisen von TCP als Übertragungsprotokoll) oder New-CsSipProxyTLS (zum Zuweisen von TLS als Übertragungsprotokoll) – konfiguriert. Sämtliche über New-CsSipProxyTransport erstellten Transportobjekte müssen in einer Variablen gespeichert werden. Diese Variable wird anschließend zum Konfigurieren der Transporteigenschaft einer SIP-Proxyroute verwendet.
Das Cmdlet New-CsSipProxyTransport muss nicht verwendet werden, wenn die statische Route mit New-CsStaticRoute erstellt wird.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet New-CsSipProxyTransport lokal ausführen: RTCUniversalServerAdmins. Geben Sie den folgenden Befehl an der Windows PowerShell-Eingabeaufforderung ein, um eine Liste aller rollenbasierten Zugriffssteuerungsrollen zurückzugeben, die diesem Cmdlet zugewiesen wurden (einschließlich der benutzerdefinierten rollenbasierten Zugriffssteuerungsrollen, die Sie selbst erstellt haben):
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsSipProxyTransport"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Port |
Erforderlich |
Ganze Zahl |
Portnummer für SIP-Routing. Beispiel: -Port 7742. |
TransportChoice |
Erforderlich |
Transportobjekt |
Gibt das Übertragungsprotokoll (TCP oder TLS) für die statische Route an. Zur Verwendung von TCP erstellen Sie ein Transportobjekt mithilfe des Cmdlets New-CsSipProxyTCP. Zur Verwendung des TLS-Protokolls erstellen Sie ein Transportobjekt mithilfe des Cmdlets New-CsSipProxyTLS. |
Eingabetypen
Keine. New-CsSipProxyTransport akzeptiert keine weitergeleitete Eingabe.
Rückgabetypen
Mit New-CsSipProxyTransport werden neue Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.Transport" erstellt.
Beispiel
-------------------------- Beispiel 1 ------------------------
$cert = New-CsSipProxyUseDefaultCert
$tls = New-CsSipProxyTLS -Certificate $cert -Fqdn atl-proxy-001.litwareinc.com
$transport = New-CsSipProxyTransport -TransportChoice $tls -Port 7500
Die Befehle in Beispiel 1 erstellen ein neues SIP-Proxytransportobjekt, das TLS als Transportprotokoll verwendet. Da TLS ein Zertifikat (für die Authentifizierung) erfordert, verwendet der erste Befehl im Beispiel das Cmdlet New-CsSipProxyUseDefaultCert, um ein neues Objekt "SipProxy.UseDefaultCert" zu konfigurieren. Dieses Objekt wird in einer Variablen namens "$cert" gespeichert und weist Lync Server an, das Standardzertifikat für den TLS-Transport zu verwenden. Nachdem das Objekt "UseDefaultCert" erstellt wurde, kann mit New-CsSipProxyTLS ein neues Objekt "SipProxy.TLS" erstellt werden, welches das Standardzertifikat verwendet und auf "atl-proxy-001.litwareinc.com" als vollqualifizierten Domänennamen (FQDN) des nächsten Hopservers verweist.
-------------------------- Beispiel 2 ------------------------
$tcp = New-CsSipProxyTCP -IPAddress 192.168.1.100
$transport = New-CsSipProxyTransport -TransportChoice $tcp -Port 7500
Die Befehle in Beispiel 2 erstellen ein neues SIP-Proxytransportobjekt, das TCP als Transportprotokoll verwendet. Hierzu wird im ersten Befehl mit New-CsSipProxyTCP ein neues Objekt "SipProxy.TCP" erstellt, das auf den nächsten Hopserver mit der IP-Adresse 192.168.1.100 zeigt. Dieses TCP-Objekt wird in der Variablen "$tcp" gespeichert.
Nachdem das Objekt "SipProxy.TCP" erstellt wurde, kann das Cmdlet New-CsSipProxyTransport zum Erstellen eines TCP-Transportobjekts aufgerufen werden.