Set-CsStaticRoutingConfiguration

Syntax

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

Set-CsStaticRoutingConfiguration [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-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 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.

Während der Installation von Microsoft Lync Server 2010 wird automatisch eine globale Auflistung statischer Routen erstellt. (Die Auflistung wird zwar erstellt, ihr werden jedoch keine Routen zugewiesen.) Darüber hinaus können Sie mit der Software weitere Auflistungen erstellen, die auf Dienstebene angewendet werden (diese neuen Auflistungen können nur dem Registrierungsdienst zugewiesen werden). Mit dem Cmdlet Set-CsStaticRoutingConfiguration ist es möglich, die Eigenschaftswerte einer vorhandenen Auflistung statischer Routen zu ändern. Dies bedeutet, dass Sie das Cmdlet zum Hinzufügen neuer Routen zu einer Auflistung oder zum Löschen vorhandener Routen aus einer Auflistung verwenden können.

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

Parameter

Eingabetypen

Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.RoutingSettings-Objekt. Set-CsStaticRoutingConfiguration akzeptiert weitergeleitete Instanzen des Objekts für statische Routen.

Rückgabetypen

Set-CsStaticRoutingConfiguration gibt keine Werte oder Objekte zurück. Stattdessen werden mit dem Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.RoutingSettings" konfiguriert.

Beispiel

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

$x = Get-CsStaticRoutingConfiguration -Identity global | Select-Object -ExpandProperty Route | Where-Object {$_.MatchUri -eq "litwareinc.com" -and $_.MatchOnlyPhoneUri -eq $True}

Set-CsStaticRoutingConfiguration -Identity service:Registrar:atl-cs-001.litwareinc.com -Route @{Add=$x}

Die in Beispiel 1 gezeigten Befehle kopieren eine Route aus der globalen Auflistung für statische Routen und weisen diese Route einer zweiten Auflistung für statische Routen zu (diese weist den Identitätswert "service:Registrar:atl-cs-001.litwareinc.com" auf). Hierzu stellt der erste Befehl im Beispiel eine Verbindung mit der globalen Auflistung her und gibt einen Objektverweis auf die Route zurück, bei dem die Eigenschaft "MatchUri" den Wert "litwareinc.com" und die Eigenschaft "MatchOnlyPhoneUri" den Wert "True" aufweist.

Hierzu ruft der Befehl Get-CsStaticRoutingConfiguration auf, um Informationen aus der globalen Konfigurationsauflistung für statische Routen zurückzugeben. Diese Daten werden dann an das Cmdlet Select-Object weitergeleitet, das den Parameter "ExpandProperty" zum Erweitern der Werte in der Eigenschaft "Route" verwendet. Diese erweiterten Werte (es handelt sich um die einzelnen Routen, die der Auflistung zugewiesen sind) werden anschließend an das Cmdlet Where-Object weitergeleitet. Das Cmdlet filtert nur die Routen heraus, deren Eigenschaft "MatchUri" den Wert "litwareinc.com" und deren Eigenschaft "MatchOnlyPhoneUri" den Wert "True" aufweist. Das zurückgegebene Objekt wird dann in der Variablen "$x" gespeichert.

Nachdem die Route abgerufen wurde, fügt der zweite Befehl im Beispiel diese Route der Auflistung "service: Registrar:atl-cs-001.litwareinc.com" hinzu. Hierzu wird Set-CsStaticRoutingConfiguration mit dem Parameter "Route" aufgerufen. Der Parameterwert "@{Add=$x}" weist das Cmdlet Set-CsStaticRoutingConfiguration hierbei an, die in der Variablen "$x" gespeicherte Route an die Auflistung von Routen anzuhängen, die in der Eigenschaft "Route" verwaltet werden.

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

$x = Get-CsStaticRoutingConfiguration -Identity service:Registrar:atl-cs-001.litwareinc.com | Select-Object -ExpandProperty Route | Where-Object {$_.MatchUri -eq "litwareinc.com" -and $_.MatchOnlyPhoneUri -eq $True}

Set-CsStaticRoutingConfiguration -Identity service:Registrar:atl-cs-001.litwareinc.com -Route @{Remove=$x}

Mit den vorstehenden Befehlen wird eine Route aus einer Auflistung von statischen Routen gelöscht. Hierzu stellt der erste Befehl im Beispiel eine Verbindung mit der Auflistung mit dem Identitätswert "service:Registrar:atl-cs-001.litwareinc.com" her und gibt einen Objektverweis auf die Route zurück, deren Eigenschaft "MatchUri" den Wert "litwareinc.com" und deren Eigenschaft "MatchOnlyPhoneUri" den Wert "True" aufweist. Hierzu ruft der Befehl das Cmdlet Get-CsStaticRoutingConfiguration auf, um Informationen aus der Auflistung "service:Registrar:atl-cs-001.litwareinc.com" zurückzugeben. Diese Daten werden dann an das Cmdlet Select-Object weitergeleitet, das den Parameter "ExpandProperty" zum Erweitern der Werte in der Eigenschaft "Route" verwendet. Diese erweiterten Werte (es handelt sich um die einzelnen Routen, die der Auflistung zugewiesen sind) werden anschließend an das Cmdlet Where-Object weitergeleitet. Das Cmdlet filtert nur die Routen heraus, deren Eigenschaft "MatchUri" den Wert "litwareinc.com" und deren Eigenschaft "MatchOnlyPhoneUri" den Wert "True" aufweist. Die zurückgegebene Route wird dann in der Variablen "$x" gespeichert.

Nachdem die Route abgerufen wurde, löscht der zweite Befehl diese Route aus der Auflistung. Hierzu wird Set-CsStaticRoutingConfiguration mit dem Parameter "Route" aufgerufen. Der Parameterwert "@{Remove=$x}" weist Set-CsStaticRoutingConfiguration an, die in der Variablen "$x" angegebene Route zu löschen.

-------------------------- Beispiel 3 ------------------------

Set-CsStaticRoutingConfiguration -Identity service:Registrar:atl-cs-001.litwareinc.com -Route $Null

In Beispiel 3 wird gezeigt, wie Sie alle Routen aus einer Konfigurationsauflistung mit statischen Routen entfernen. Hierzu geben Sie lediglich den Parameter "Route" an und legen den Parameterwert auf "Null" fest. Nach Ausführung des Befehls ist die Auflistung weiterhin vorhanden, es sind ihr jedoch keinerlei Routen mehr zugewiesen.

Siehe auch

Weitere Ressourcen

Get-CsStaticRoutingConfiguration
New-CsStaticRoute
New-CsStaticRoutingConfiguration
Remove-CsStaticRoutingConfiguration