• Artikel

New-CsStaticRoutingConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-26

Erstellt eine neue Auflistung von Konfigurationseinstellungen für statische Routen.

Syntax

New-CsStaticRoutingConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Route <PSListModifier>] [-WhatIf [<SwitchParameter>]]

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.

Während der Installation von Microsoft Lync Server 2010 wird automatisch eine globale Auflistung statischer Routen erstellt. Zusätzlich dazu können Sie mit dem Cmdlet New-CsStaticRoutingConfiguration weitere Auflistungen und den Standort- oder Dienstbereich erstellen (nur für den Registrierungsdienst).

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet New-CsStaticRoutingConfiguration 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-CsStaticRoutingConfiguration"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsIdentity

Eindeutige ID für die zu erstellende neue Auflistung von statischen Routen. Neue Auflistungen können nur auf Dienstebene erstellt und nur dem Registrierungsdienst zugewiesen werden. Daher muss der Identitätswert für eine neue Auflistung in etwa wie der folgende lauten: -Identity "service:Registrar:atl-cs-001.litwareinc.com".

Route

Optional

PS-Listenmodifizierer

Individuelle statische Routen, die innerhalb der Auflistung verwaltet werden. Routen, die einer Auflistung hinzugefügt werden sollen, müssen entweder aus einer anderen Auflistung kopiert oder mit dem Cmdlet New-CsStaticRoute erstellt werden. Ausführliche Informationen finden Sie in den Beispielen weiter unten in diesem Thema.

Force

Optional

Switch-Parameter

Unterdrückt die Anzeige von Meldungen bei nicht schwerwiegenden Fehlern, die beim Ausführen des Befehls auftreten können.

InMemory

Optional

Switch-Parameter

Erstellt einen Objektverweis ohne einen Commit für das Objekt auszuführen und die Änderungen dadurch dauerhaft zu speichern. Wenn Sie die Ausgabe des mit diesem Parameter aufgerufenen Cmdlet einer Variablen zuweisen, können Sie die Eigenschaften des Objektverweises ändern und anschließend einen Commit für diese Änderungen ausführen, indem Sie das entsprechende Cmdlet vom Typ "Set-" aufrufen.

WhatIf

Optional

Switch-Parameter

Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen.

Confirm

Optional

Switch-Parameter

Fordert Sie vor der Ausführung des Befehls zum Bestätigen auf.

Eingabetypen

Keine. New-CsStaticRoutingConfiguration akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Mit New-CsStaticRoutingConfiguration werden neue Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.RoutingSettings" erstellt.

Beispiel

-------------------------- Beispiel 1 ------------------------

New-CsStaticRoutingConfiguration -Identity "service:Registrar:atl-cs-001.litwareinc.com"

Mit dem vorstehenden Befehl wird eine neue Konfigurationsauflistung für statische Routen mit dem Identitätswert "service:Registrar:atl-cs-001.litwareinc.com" erstellt. Da der Parameter "Route" nicht im Befehl enthalten ist, werden der neuen Auflistung keine statischen Routen zugewiesen.

-------------------------- Beispiel 2 ------------------------

$x = New-CsStaticRoute -TCPRoute -Destination "192.168.0.100" -Port 8025 -MatchUri "*.litwareinc.com"

New-CsStaticRoutingConfiguration -Identity "service:Registrar:atl-cs-001.litwareinc.com" -Route $x

Die Befehle in Beispiel 2 erstellen eine neue SIP-Proxyroute, die TCP für den Datentransport verwendet. Diese neue Route wird dann zu einer neuen Auflistung von Konfigurationen für statische Routen hinzugefügt. Hierzu wird im ersten Befehl in diesem Beispiel mit New-CsStaticRoute eine neue Route erstellt, die auf den als nächsten Hop festgelegten Server mit der IP-Adresse 192.168.1.100 verweist. Diese neue Route (gespeichert in der Variablen "$x") verwendet Port 8025, und der Wert für den Parameter "MatchUri" lautet "*.litwareinc.com".

Anschließend wird mit New-CsStaticRoutingConfiguration eine neue Auflistung mit dem Identitätswert "service:Registrar:atl-cs-001.litwareinc.com" erstellt. Dabei wird die in der Variablen "$x" gespeicherte Route der Eigenschaft "Route" der neuen Auflistung zugewiesen.