Get-CsNetworkRegion
Letztes Änderungsdatum des Themas: 2012-03-23
Ruft eine oder mehrere Netzwerkregionen ab. Netzwerkregionen repräsentieren Netzwerkhubs oder Backbones in einem Unternehmensnetzwerk.
Syntax
Get-CsNetworkRegion [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsNetworkRegion [-Filter <String>] [-LocalStore <SwitchParameter>]
Detaillierte Beschreibung
Eine Netzwerkregion verbindet verschiedene Teile eines Netzwerks, das sich über verschiedene geografische Bereiche erstreckt. Jede Netzwerkregion muss einem zentralen Standort zugeordnet sein. Mit diesem Cmdlet können Sie Informationen über eine oder mehrere Netzwerkregionen abrufen, einschließlich des zugeordneten zentraler Standorts und Einstellungen, die festlegen, ob für Audio- und Videoverbindungen alternative Pfade zulässig sind, und die die Standorte innerhalb der Region mit einer Konfiguration zur Medienumgehung in Bezug setzen.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Get-CsNetworkRegion 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-CsNetworkRegion"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Optional |
XdsGlobalRelativeIdentity |
Eine eindeutige ID der Netzwerkregion, die abgerufen werden soll. Der Identitätswert liegt als Zeichenfolge vor, die diese Region eindeutig identifiziert. ("Identity" ist mit "NetworkRegionID" identisch.) |
Filter |
Optional |
Zeichenfolge |
Dieser Parameter ermöglicht eine Platzhaltersuche nach dem Identitätswert aller für die Organisation konfigurierten Netzwerkregionen. Mit dem Platzhalterzeichen kann nach einer beliebigen Komponente des Identitätswerts gefiltert werden. |
LocalStore |
Optional |
Switch-Parameter |
Ruft die Netzwerkregionsinformationen aus dem lokalen Replikat des zentraler Verwaltungsspeichers ab, statt die Daten aus dem zentraler Verwaltungsspeicher selbst abzurufen. |
Eingabetypen
Keine.
Rückgabetypen
Gibt ein oder mehrere Objekte vom Typ "Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkRegionType" zurück.
Beispiel
-------------------------- Beispiel 1 --------------------------
Get-CsNetworkRegion
Beispiel 1 ruft alle für die Organisation definierten Netzwerkregionen ab.
-------------------------- Beispiel 2 --------------------------
Get-CsNetworkRegion -Identity NorthAmerica
Beispiel 2 ruft die Netzwerkregionen mit dem Identitätswert "NorthAmerica" ab. Da Identitätswerte eindeutig sind, ruft dieser Befehl maximal eine Netzwerkregion ab.
-------------------------- Beispiel 3 --------------------------
Get-CsNetworkRegion -Filter *America
Dieses Beispiel ruft alle Netzwerkregionen mit Identitätswerten ab, die auf "America" enden. Dazu würden z. B. Regionen mit den Identitätswerten "NorthAmerica", "SouthAmerica" und "CentralAmerica" zählen.
-------------------------- Beispiel 4 --------------------------
Get-CsNetworkRegion | Where-Object {$_.CentralSite -eq "site:Redmond"}
Dieses Beispiel ruft alle Netzwerkregionen ab, die dem zentraler Standort "Redmond" zugeordnet sind. Der Befehl ruft zunächst das Cmdlet Get-CsNetworkRegion ohne Parameter auf, um eine Auflistung aller Netzwerkregionen abzurufen, die für die Microsoft Lync Server 2010-Bereitstellung definiert sind. Diese Auflistung wird anschließend an das Cmdlet Where-Object weitergeleitet. Where-Object filtert diese Auflistung, um nur die Netzwerkregionen zurückzugeben, bei denen der Wert "CentralSite" dem Wert "site:Redmond" entspricht (der Vergleichsoperator "-eq" steht für "equal to").