New-CsStaticRoute
Letztes Änderungsdatum des Themas: 2012-03-26
Erstellt eine neue statische Telefonroute.
Syntax
New-CsStaticRoute -Destination <String> -MatchUri <String> -Port <UInt16> -TLSRoute <SwitchParameter> [-Enabled <$true | $false>] [-MatchOnlyPhoneUri <$true | $false>] [-ReplaceHostInRequestUri <$true | $false>] [-TLSCertIssuer <String>] [-TLSCertSerialNumber <Byte[]>] [-UseDefaultCertificate <$true | $false>]
New-CsStaticRoute -Destination <String> -MatchUri <String> -Port <UInt16> -TCPRoute <SwitchParameter> [-Enabled <$true | $false>] [-MatchOnlyPhoneUri <$true | $false>] [-ReplaceHostInRequestUri <$true | $false>]
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) die 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.
Mit dem Cmdlet New-CsStaticRoute können Sie neue statische Routen erstellen. Nachdem mit New-CsStaticRoute eine Route erstellt wurde, müssen Sie die Route einer Auflistung von Routingkonfigurationseinstellungen hinzufügen. Verwenden Sie dazu das Cmdlet Set-CsStaticRoutingConfiguration.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet New-CsStaticRoute 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-CsStaticRoute"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Destination |
Erforderlich |
Zeichenfolge |
Wenn die Route als Transportprotokoll TLS (Transport Layer Security) verwendet, ist das Ziel der vollqualifizierte Domänenname (FQDN) des als nächsten Hop festgelegten Servers. Beispiel: -Destination "atl-proxy-001.litwareinc.com". Wenn die Route als Transportprotokoll TCP (Transmission Control Protocol) verwendet, ist das Ziel die IP-Adresse des als nächsten Hop festgelegten Routers. Beispiel: -Destination "192.168.0.240". |
MatchUri |
Erforderlich |
Zeichenfolge |
FQDN oder Domänensuffix zur Festlegung, ob die Nachricht an einen von dieser Route bedienten Benutzer gesendet wird. Sie könnten beispielsweise den FQDN "litwareinc.com" verwenden. Dieses Muster entspricht allen Benutzern, die eine SIP-Adresse aufweisen, die auf den Domänennamen "litwareinc.com" endet. Um untergeordnete Domänen einer Domäne abzugleichen, können Sie einen Platzhalterwert wie "*.litwareinc.com" verwenden. Dieser Wert entspricht allen Domänen, die mit dem Suffix ".litwareinc.com" enden. Beispiel: northamerica.litwareinc.com; asia.litwareinc.com; europe.litwareinc.com. |
Enabled |
Optional |
Boolescher Wert |
Bei Festlegung auf "True" ist die Route aktiv. Alle Nachrichten, die dem Muster "MatchURI" entsprechen, werden an den als nächsten Hop festgelegten Server weitergeleitet. Wenn "False" festgelegt wurde, ist die Route nicht aktiv und wird nicht zur Weiterleitung von Nachrichten verwendet. Der Standardwert lautet "True". |
MatchOnlyPhoneUri |
Optional |
Boolescher Wert |
Bei Festlegung auf "True" werden nur Nachrichten abgeglichen und ggf. weitergeleitet, die an Telefon-URIs (Uniform Resource Identifiers) adressiert sind (Beispiel: sip:kenmmyer@litwareinc.com;user=phone). Wenn "False" (Standardwert) festgelegt wurde, werden alle Nachrichten abgeglichen. |
Port |
Erforderlich |
Ganze Zahl |
Portnummer für SIP-Routing. Beispiel: -Port 7742. |
ReplaceHostInRequestUri |
Optional |
Boolescher Wert |
Wenn "True" ($True) festgelegt wurde, wird der Hostteil eines Anforderungs-URI durch die Adresse des als nächsten Hop festgelegten Servers ersetzt. Wenn "False" festgelegt wurde, wird der Anforderungs-URI wie angegeben verwendet. Der Anforderungs-URI steht für den URI des Benutzers oder Diensts, an den die Anforderung (Nachricht) adressiert ist. Der Standardwert lautet "False". |
TCPRoute |
Optional |
Switch-Parameter |
Legt TCP als Transportprotokoll für die neue Route fest. |
TLSCertIssuer |
Optional |
Zeichenfolge |
Name der Zertifizierungsstelle, die das in der statischen Route zu verwendende Zertifikat ausgestellt hat. Dieser Parameter wird nicht verwendet, wenn als Transportprotokoll TCP festgelegt wurde. Wenn Sie den Parameter "TLSCertIssuer" angeben, müssen Sie auch den Parameter "TLSCertSerialNumber" verwenden. |
TLSCertSerialNumber |
Optional |
Bytearray |
Seriennummer des TLS-Zertifikats, das für die statische Route verwendet werden soll. Seriennummern müssen als Bytearray übergeben werden, d. h., Sie müssen die Seriennummer als Array bestehend aus Werten mit zwei Zeichen übergeben. Beispiel: -TLSCertSerialNumber 0x01, 0xA4, 0xD5, 0x67, 0x89. Dieser Parameter wird nicht verwendet, wenn als Transportprotokoll TCP festgelegt wurde. Wenn Sie den Parameter "TLSCertSerialNumber" angeben, müssen Sie auch den Parameter "TLSCertIssuer" verwenden. |
TLSRoute |
Optional |
Switch-Parameter |
Legt TLS als Transportprotokoll für die neue Route fest. |
UseDefaultCertificate |
Optional |
Boolescher Wert |
Konfiguriert die Route zur Verwendung des standardmäßigen Lync Server 2010-Zertifikat als Authentifizierungszertifikat. Wenn Sie das Standardzertifikat nicht verwenden möchten, müssen Sie unter Verwendung der Parameter "TLSCertIssuer" und "TLSCertSerialNumber" ein anderes Zertifikat festlegen. Verwenden Sie den folgenden Befehl, um das Standardzertifikat anzuzeigen: Get-CsCertificate | Where-Object {$_.Use –eq "urn:certref:Default"} |
Eingabetypen
Keine. New-CsStaticRoute akzeptiert keine weitergeleitete Eingabe.
Rückgabetypen
Mit New-CsStaticRoute werden neue Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.Route" erstellt.
Beispiel
-------------------------- Beispiel 1 --------------------------
$x = New-CsStaticRoute -TCPRoute -Destination "192.168.0.100" -Port 8025 -MatchUri "litwareinc.com"
Set-CsStaticRoutingConfiguration -Identity global -Route @{Add=$x}
Die Befehle in Beispiel 1 erstellen eine neue statische Route. Diese Route wird dann der globalen Konfigurationsauflistung für statische Routen hinzugefügt. Hierzu verwendet der erste Befehl New-CsStaticRoute, um eine ausschließlich im Arbeitsspeicher vorhandene Route zu erstellen, die TCP als Transportprotokoll verwendet. Die Route verweist auf die nächste Hop-IP-Adresse 192.168.0.100, verwendet Port 8025 und gleicht alle URIs aus der Domäne "litwareinc.com" ab. Das erstellte Routenobjekt wird in der Variablen "$x" gespeichert.
Der zweite Befehl im Beispiel wird anschließend dazu verwendet, die neue Route der globalen Konfigurationsauflistung für statische Routen hinzuzufügen. Hierzu wird Set-CsStaticRoutingConfiguration mit dem Parameter "Route" aufgerufen. Durch den Parameterwert "@{Add=$x}" wird das in "$x" gespeicherte Routenobjekt dem in der globalen Auflistung vorhandenen Routensatz hinzugefügt.
-------------------------- Beispiel 2 --------------------------
$x = New-CsStaticRoute -TLSRoute -Destination "atl-proxy-001.litwareinc.com" -Port 8025 -MatchUri "*.litwareinc.com" -UseDefaultCertificate $True
Set-CsStaticRoutingConfiguration -Identity global -Route @{Add=$x}
Beispiel 2 zeigt, wie Sie eine neue statische Route erstellen können, die als Transportprotokoll TLS verwendet. Diese Route wird dann der globalen Konfigurationsauflistung für statische Routen hinzugefügt. Hierzu verwendet der erste Befehl im Beispiel New-CsStaticRoute, um eine ausschließlich im Arbeitsspeicher vorhandene Route zu erstellen, die als Transportprotokoll TLS verwendet. Die Route verweist auf das Ziel "atl-proxy-001.litwareinc.com", verwendet Port 8025 und gleicht alle URIs ab, die das Domänensuffix "litwareinc.com" verwenden. Darüber hinaus verwendet das in der Variablen "$x" gespeicherte neue Routenobjekt zur Authentifizierung das Standardzertifikat (-UseDefaultCertificate $True).
Nachdem das Routenobjekt erstellt wurde, wird der zweite Befehl im Beispiel dazu verwendet, die neue Route der globalen Konfigurationsauflistung für statische Routen hinzuzufügen.