Freigeben über

  • Artikel

Get-CsStaticRoutingConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-23

Gibt Informationen zu den in Ihrer Organisation verwendeten Konfigurationseinstellungen für statische Routen zurück.

Syntax

Get-CsStaticRoutingConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsStaticRoutingConfiguration [-Filter <String>] [-LocalStore <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 Get-CsStaticRoutingConfiguration können Sie Informationen zu allen Konfigurationsauflistungen für statische Routen abrufen, die derzeit in Ihrer Organisation verwendet werden. Hierzu gehört die Fähigkeit, detaillierte Informationen zu jeder Route zurückzugeben, die einer Auflistung zugewiesen ist.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Eindeutige ID für die Konfigurationsauflistung für statische Routen. Verwenden Sie diese Syntax, um Informationen zur globalen Auflistung zurückzugeben: -Identity global. Verwenden Sie eine Syntax wie die folgende, um Informationen zu einer Auflistung abzurufen, die auf Dienstebene konfiguriert wurde: -Identity "service:Registrar:atl-cs-001.litwareinc.com". Beachten Sie, dass beim Angeben eines Identitätswerts keine Platzhalterzeichen verwendet werden können. Wenn Platzhalter nötig sind, verwenden Sie stattdessen den Parameter "Filter".

Wenn Sie weder den Parameter "Identity" noch den Parameter "Filter" einschließen, gibt das Cmdlet Get-CsStaticRoutingConfiguration Informationen zu allen Konfigurationsauflistungen für statische Routen zurück.

Filter

Optional

Zeichenfolge

Ermöglicht die Verwendung von Platzhalterzeichen beim Festlegen der Auflistung(en) für statische Routen, die zurückgegeben werden soll(en). Verwenden Sie beispielsweise folgende Syntax, um alle auf Dienstebene konfigurierten Auflistungen für statische Routen zurückzugeben: -Filter "service:*".

Beachten Sie, dass Sie die Parameter "Identity" und "Filter" nicht in demselben Befehl verwenden können.

LocalStore

Optional

Switch-Parameter

Ruft die Konfigurationsdaten zu statischen Routen aus dem lokalen Replikat des zentraler Verwaltungsspeichers ab, statt die Daten aus dem zentraler Verwaltungsspeicher selbst abzurufen.

Eingabetypen

Keine. Get-CsStaticRoutingConfiguration akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Mit Get-CsStaticRoutingConfiguration werden Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.RoutingSettings" zurückgegeben.

Beispiel

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

Get-CsStaticRoutingConfiguration

Der Befehl in Beispiel 1 gibt Informationen zu allen derzeit in der Organisation verwendeten Konfigurationsauflistungen für statische Routen zurück.

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

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

In Beispiel 2 wird eine einzelne Konfigurationsauflistung für statische Routen zurückgegeben: die Auflistung mit dem Identitätswert "service:Registrar:atl-cs-001.litwareinc.com".

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

Get-CsStaticRoutingConfiguration -Filter "service:*"

In Beispiel 3 wird der Parameter "Filter" dazu verwendet, Informationen zu Konfigurationsauflistungen für statische Routen zurückzugeben, die auf Dienstebene zugewiesen wurden. Der Filterwert "service:*" beschränkt die zurückgegebenen Daten auf Auflistungen, deren Identitätswert mit dem Zeichenfolgenwert "service:" beginnt.

-------------------------- Beispiel 4 ------------------------

Get-CsStaticRoutingConfiguration | Select-Object -ExpandProperty Route

Mit dem vorstehenden Befehl werden detaillierte Informationen zu allen derzeit in Ihrer Organisation verwendeten Konfigurationsauflistungen für statische Routen zurückgegeben. Dazu ruft der Befehl zunächst Get-CsStaticRoutingConfiguration ohne Parameter auf, um vollständige Informationen zu jeder Auflistung für statische Routen zurückzugeben. Diese Informationen werden anschließend an das Cmdlet Select-Object weitergeleitet, das den Parameter "ExpandProperty" verwendet, um den Wert der Eigenschaft "Route" zu "erweitern". Wenn Sie eine Eigenschaft erweitern, werden alle in dieser Eigenschaft enthaltenen Objekte und Werte in benutzerfreundlicher Form am Bildschirm angezeigt.

-------------------------- Beispiel 5 ------------------------

Get-CsStaticRoutingConfiguration | Select-Object -ExpandProperty Route | Where-Object {$_.MatchOnlyPhoneUri -eq $True}

Mit dem Befehl in Beispiel 5 werden Informationen zu allen konfigurierten statischen Routen zurückgegeben, die nur für den Abgleich von Telefon-URIs (Uniform Resource Identifier) konfiguriert sind. Hierzu ruft der Befehl zunächst Get-CsStaticRoutingConfiguration ohne Parameter auf, um alle Konfigurationsauflistungen für statische Routen und ihre zugeordneten Routen zurückzugeben. Diese Auflistung wird dann an das Cmdlet Select-Object weitergeleitet, das den Parameter "ExpandProperty" zum Erweitern aller Objekte in der Eigenschaft "Route" verwendet. Diese Routenobjekte werden dann an das Cmdlet Where-Object weitergeleitet, das die Routen herausfiltert, bei denen die Eigenschaft "MatchOnlyPhoneUri" den Wert "True" aufweist.