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").
Siehe auch
Weitere Ressourcen
New-CsNetworkInterRegionRoute
Remove-CsNetworkInterRegionRoute
Set-CsNetworkInterRegionRoute