Freigeben über

  • Artikel

Remove-CsStaticRoutingConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-25

Entfernt die angegebene Auflistung von Konfigurationseinstellungen für statische Routen.

Syntax

Remove-CsStaticRoutingConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-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). Wenn Sie sich später anders entscheiden, können Sie mit dem Cmdlet Remove-CsStaticRoutingConfiguration die Auflistungen löschen, die auf Dienstebene angewendet wurden.

Sie können auch das Cmdlet Remove-CsStaticRoutingConfiguration für die globale Auflistung ausführen. In diesem Fall wird die globale Auflistung jedoch nicht entfernt, da in Lync Server 2010 keine globalen Auflistungen entfernt werden dürfen. Stattdessen werden alle Eigenschaften in der globalen Auflistung auf die Standardwerte zurückgesetzt. Dies bedeutet, dass alle der globalen Auflistung zugewiesenen Routen gelöscht werden.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsIdentity

Eindeutige ID für die globale Konfigurationsauflistung für statische Routen, die entfernt werden soll. Verwenden Sie eine Syntax wie die folgende, um die auf Dienstebene konfigurierte Auflistung zu entfernen: -Identity "service:Registrar:atl-cs-001.litwareinc.com".

Remove-CsStaticRoutingConfiguration kann auch für die globale Auflistung ausgeführt werden; verwenden Sie hierzu die folgende Syntax: -Identity global. Beachten Sie jedoch, dass die globale Auflistung nicht wirklich entfernt wird. Stattdessen werden die Eigenschaften in dieser Auflistung auf die Standardwerte zurückgesetzt. Das bedeutet, dass alle Elemente in der Eigenschaft "Route" gelöscht werden.

Force

Optional

Switch-Parameter

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

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

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

Rückgabetypen

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

Beispiel

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

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

Mit dem Befehl in Beispiel 1 wird die Konfigurationsauflistung für statische Routen mit dem Identitätswert "service:Registrar:atl-cs-001.litwareinc.com" entfernt.

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

Get-CsStaticRoutingConfiguration -Filter "service:*" | Remove-CsStaticRoutingConfiguration

In Beispiel 2 werden alle Konfigurationsauflistungen für statische Routen gelöscht, die auf Dienstebene angewendet werden. Hierzu wird zunächst Get-CsStaticRoutingConfiguration mit dem Parameter "Filter" aufgerufen. Der Filterwert "service:*" beschränkt die zurückgegebenen Daten auf Auflistungen, deren Identitätswert mit dem Zeichenfolgenwert "service:" beginnt. Diese gefilterte Auflistung wird dann an Remove-CsStaticRoutingConfiguration weitergeleitet, das alle Elemente in der Auflistung löscht.

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

Get-CsStaticRoutingConfiguration | Where-Object {$_.Route.Count -eq 0} | Remove-CsStaticRoutingConfiguration

In Beispiel 3 wird gezeigt, wie Sie alle Konfigurationsauflistungen für statische Routen löschen können, denen keine tatsächlichen Routen zugewiesen wurden. Hierzu ruft der Befehl zunächst Get-CsStaticRoutingConfiguration auf, um Informationen zu allen Auflistungen für statische Routen zurückzugeben, die in der Organisation verwendet werden. Diese Auflistung wird anschließend an das Cmdlet Where-Object weitergeleitet, das nur die Auflistungen herausfiltert, bei denen die Anzahl von Routen (Route.Count) dem Wert 0 entspricht. Die gefilterten Informationen werden dann an das Cmdlet Remove-CsStaticRoutingConfiguration weitergeleitet, das jede Auflistung löscht, der nicht mindestens eine Route zugewiesen ist.