New-CsSipProxyTCP
Letztes Änderungsdatum des Themas: 2012-03-25
Erstellt ein neues Objekt vom Typ "SipProxy.TCP", mit dem eine statische Route so konfiguriert werden kann, dass TCP (Transmission Control Protocol) als Transportprotokoll verwendet wird.
Syntax
New-CsSipProxyTCP -IPAddress <String>
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 von einem Administrator als nächsten Hop 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.
Microsoft Lync Server 2010 ermöglicht Ihnen das Einrichten statischer Routen für Proxyserver. Diese Routen bestehen aus zwei Hauptteilen: den Proxykonfigurationseinstellungen (mit New-CsProxyConfiguration erstellt) und den SIP-Proxyrouten. SIP-Proxyrouten haben mehrere Eigenschaften, z. B. muss jede Route über eine Transport-Eigenschaft verfügen, mit der das für die Übertragung von Nachrichten über die Route verwendete Netzwerkprotokoll definiert wird.
In Lync Server 2010 können Sie entweder TCP (Transmission Control Protocol) oder TLS (Transport Layer Security) als Transportprotokoll festlegen. Wenn Sie TCP als Protokoll verwenden, müssen Sie zunächst mit dem Cmdlet New-CsSipProxyTCP ein TCP-Objekt erstellen. Danach können Sie mit diesem Objekt das Protokoll für das Objekt "Transport" festlegen, das mit New-CsSipProxyTransport erstellt wurde.
Wenn Sie zum Erstellen der statischen Route New-CsStaticRoute verwenden, müssen Sie das Cmdlet New-CsSipProxyTCP nicht verwenden.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet New-CsSipProxyTCP lokal auszufü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-CsSipProxyTCP"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
IPAddress |
Erforderlich |
Zeichenfolge |
Die IP-Adresse des als nächsten Hop festgelegten Routers. Beispiel: -IPAddress 192.168.0.240. |
Eingabetypen
Keine. New-CsSipProxyTCP akzeptiert keine weitergeleitete Eingabe.
Rückgabetypen
Mit New-CsSipProxyTCP werden neue Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.TCP" erstellt.
Beispiel
-------------------------- Beispiel 1 --------------------------
$tcp = New-CsSipProxyTCP -IPAddress 192.168.1.100
$transport = New-CsSipProxyTransport -TransportChoice $tcp -Port 7500
Die Befehle in Beispiel 1 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, wird mit dem Cmdlet New-CsSipProxyTransport ein TCP-Transportobjekt erstellt.