• Artikel

Get-CsNetworkInterRegionRoute

 

Letztes Änderungsdatum des Themas: 2012-03-23

Ruft eine oder mehrere Routen ab, die Netzwerkregionen in einer Anrufsteuerungskonfiguration miteinander verbinden.

Syntax

Get-CsNetworkInterRegionRoute [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]

Get-CsNetworkInterRegionRoute [-Filter <String>] [-LocalStore <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 ruft Informationen zu diesen Routenzuordnungen ab.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Get-CsNetworkInterRegionRoute lokal auszufü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-CsNetworkInterRegionRoute"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsGlobalRelativeIdentity

Die eindeutige ID für die Netzwerkregionenroute, die abgerufen 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, bei der es sich um einen eindeutigen Namen zur Identifizierung einer bestimmten Route handelt.

Filter

Optional

Zeichenfolge

Eine Zeichenfolge, mit der Routen basierend auf einer Übereinstimmung zwischen den Identitätswerten und der Platzhaltersuchzeichenfolge abgerufen werden können, die als Wert für diesen Parameter übergeben wird.

LocalStore

Optional

Switch-Parameter

Ruft die regionenübergreifenden Netzwerkrouteninformationen aus dem lokalen Replikat des zentraler Verwaltungsspeichers ab, statt die Daten aus dem zentraler Verwaltungsspeicher selbst abzurufen.

Eingabetypen

Keine.

Rückgabetypen

Mit diesem Cmdlet werden ein oder mehrere Objekte vom Typ "Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.InterNetworkRegionRouteType" zurückgegeben.

Beispiel

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

Get-CsNetworkInterRegionRoute -Identity NA_APAC_Route

Mit Beispiel 1 wird die Route mit dem Identitätswert "NA_APAC_Route" abgerufen.

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

Get-CsNetworkInterRegionRoute -Filter *APAC*

In Beispiel 2 werden mit dem Parameter "Filter" sämtliche Routen abgerufen, deren Identitätswert die Zeichenfolge "APAC" enthält.

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

Get-CsNetworkInterRegionRoute | Where-Object {$_.NetworkRegionLinks -eq "NA_EMEA"}

In diesem Beispiel werden alle Regionenrouten abgerufen, die die Netzwerkregionenverbindung "NA_EMEA" verwenden. Hierzu ruft der Befehl zunächst das Cmdlet Get-CsNetworkInterRegionRoute auf. Durch das Aufrufen dieses Cmdlets ohne Parameter werden alle Routen abgerufen, die mit der Anrufsteuerungskonfiguration definiert wurden. Diese Auflistung von Routen wird anschließend an das Cmdlet Where-Object weitergeleitet. Das Cmdlet Where-Object ruft sämtliche Elemente in der Auflistung ab, deren Liste "NetworkRegionLinks" den Wert "NA_EMEA" enthält.

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

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

In Beispiel 4 werden sämtliche Regionenrouten abgerufen, 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").