• Artikel

Remove-CsNetworkInterRegionRoute

 

Letztes Änderungsdatum des Themas: 2012-03-25

Entfernt eine Route, die Netzwerkregionen mit einer Anrufsteuerungskonfiguration verbindet.

Syntax

Remove-CsNetworkInterRegionRoute -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Jede Region in einer Anrufsteuerungskonfiguration muss auf jede andere Region zugreifen können. Während die Regionenverbindungen Bandbreiteneinschränkungen für Verbindungen zwischen Regionen festlegen und auch die physischen Verbindungen darstellen, bestimmt eine Route, welchen Pfad die Verbindung von einer Region zur anderen nimmt. Dieses Cmdlet entfernt eine dieser Routenzuordnungen.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsGlobalRelativeIdentity

Die eindeutige ID für die Netzwerkregionenroute, die entfernt werden soll. Netzwerkregionenrouten werden ausschließlich auf globaler Ebene erstellt, sodass mit dieser ID kein Gültigkeitsbereich festgelegt werden muss. Stattdessen ist eine Zeichenfolge enthalten, die den eindeutigen Namen zur Identifizierung dieser Route darstellt.

Force

Optional

Switch-Parameter

Unterdrückt alle Bestätigungsaufforderungen, die andernfalls vor der Durchführung von Änderungen angezeigt würden.

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.NetworkConfiguration.InterNetworkRegionRouteType-Objekt. Akzeptiert eine weitergeleitete Eingabe von regionenübergreifenden Netzwerkroutenobjekten.

Rückgabetypen

Dieses Cmdlet gibt keinen Wert zurück. Mit ihm wird ein Objekt vom Typ "Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.InterNetworkRegionRouteType" entfernt.

Beispiel

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

Remove-CsNetworkInterRegionRoute -Identity NA_APAC_Route

In Beispiel 1 wird die Route mit dem Identitätswert "NA_APAC_Route" entfernt.

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

Get-CsNetworkInterRegionRoute | Where-Object {$_.NetworkRegionID1 -eq "NorthAmerica" -or $_.NetworkRegionID2 -eq "NorthAmerica"} | Remove-CsNetworkInterRegionRoute

In Beispiel 2 werden sämtliche Regionenrouten entfernt, die die Region "NorthAmerica" enthalten. Der erste Teil dieses Befehls ist ein Aufruf des Cmdlets Get-CsNetworkInterRegionRoute. Wenn dieses Cmdlet ohne Parameter aufgerufen wird, werden alle Regionenrouten abgerufen. Diese Auflistung von Routen wird anschließend an das Cmdlet Where-Object weitergeleitet. Das Cmdlet Where-Object schränkt die Auflistung auf solche Routen ein, die "NorthAmerica" als eine ihrer Regionen umfassen. Hierzu wird geprüft, ob "NetworkRegionID1" oder (-or) "NetworkRegionID2" den Wert "NorthAmerica" aufweist (der Vergleichsoperator "-eq" steht für "equal to"). Nachdem die Auflistung auf lediglich die Routen beschränkt wurde, welche die Region "NorthAmerica" enthalten, wird die Auflistung an das Cmdlet Remove-CsNetworkInterRegionRoute weitergeleitet, das jede dieser Routen entfernt.