• Artikel

Get-CsNetworkRegionLink

 

Letztes Änderungsdatum des Themas: 2012-03-23

Ruft eine oder mehrere Verbindungen zwischen Netzwerkregionen ab, die für die Anrufsteuerung konfiguriert wurden.

Syntax

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

Get-CsNetworkRegionLink [-Filter <String>] [-LocalStore <SwitchParameter>]

Detaillierte Beschreibung

Regionen in einem Netzwerk sind über eine physische WAN-Verbindung verbunden. Dieses Cmdlet ruft eine oder mehrere Regionenverbindungen ab, die in den Netzwerkkonfigurationseinstellungen für eine Microsoft Lync Server 2010-Bereitstellung definiert sind.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsGlobalRelativeIdentity

Eine eindeutige ID der Netzwerkregionenverbindung, die abgerufen werden soll. Netzwerkregionenverbindungen werden ausschließlich global erstellt, sodass mit dieser ID kein Gültigkeitsbereich festgelegt werden muss. Stattdessen ist eine Zeichenfolge enthalten, die den eindeutigen Namen zur Identifizierung dieser Verbindung darstellt. (Beachten Sie, dass dieser Wert mit "NetworkRegionLinkID" identisch ist.)

Filter

Optional

Zeichenfolge

Nimmt eine Platzhalterzeichenfolge zum Abrufen von Netzwerkverbindungen an, deren Identitätswert mit der Platzhalterzeichenfolge übereinstimmt.

LocalStore

Optional

Switch-Parameter

Ruft die Informationen zu Netzwerkregionenverbindungen 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.NetworkRegionLinkType" zurück.

Beispiel

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

Get-CsNetworkRegionLink

In Beispiel 1 werden alle in einer Lync Server 2010-Bereitstellung definierten Netzwerkregionenverbindungen abgerufen.

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

Get-CsNetworkRegionLink -Identity NA_EMEA

In Beispiel 2 werden Informationen zu (maximal) einer Netzwerkregionenverbindung mit der Identität "NA_EMEA" abgerufen.

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

Get-CsNetworkRegionLink -Filter *EMEA*

In diesem Beispiel werden mit dem Parameter "Filter" sämtliche Netzwerkregionenverbindungen abgerufen, deren Name (Identity) die Zeichenfolge "EMEA" enthält. Beachten Sie, dass vor und hinter der Zeichenfolge "EMEA" jeweils ein Sternchen (*) steht. Somit können der Zeichenfolge ein oder mehrere Zeichen vorangestellt oder angehängt werden. In der Zeichenfolge "EMEA" muss lediglich an irgendeiner Stelle die Identität enthalten sein. Dadurch werden Regionen mit Namen wie "NA_EMEA", "EMEA_APAC" und "EMEA2_SA" abgerufen.

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

Get-CsNetworkRegionLink | Where-Object {$_.NetworkRegionID1 -eq "EMEA" -or $_.NetworkRegionID2 -eq "EMEA"}

In diesem Beispiel werden alle Netzwerkregionenverbindungen abgerufen, die "EMEA" als eine der beiden verbundenen Regionen enthalten. In dem Beispiel wird zunächst Get-CsNetworkRegionLink ohne Parameter aufgerufen, um alle Regionenverbindungen abzurufen. Diese Auflistung von Verbindungen wird anschließend an das Cmdlet Where-Object weitergeleitet. Mit Where-Object werden nacheinander die Werte der Eigenschaften "NetworkRegionID1" und "NetworkRegionID2" jedes Mitglieds der Aufzählung überprüft. Wenn eine dieser Eigenschaften (also entweder "NetworkRegionID1" oder (-or) "NetworkRegionID2") den Wert "EMEA" aufweist (der Vergleichsoperator (-eq) steht für "equal to"), soll dieses Element in der Auflistung beibehalten und angezeigt werden.