• Artikel

New-CsNetworkRegionLink

 

Letztes Änderungsdatum des Themas: 2012-03-25

Erstellt eine Verbindung zwischen zwei Regionen, die für die Anrufsteuerung konfiguriert wurden.

Syntax

New-CsNetworkRegionLink -Identity <XdsGlobalRelativeIdentity> -NetworkRegionID1 <String> -NetworkRegionID2 <String> [-BWPolicyProfileID <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

New-CsNetworkRegionLink -NetworkRegionID1 <String> -NetworkRegionID2 <String> -NetworkRegionLinkID <String> [-BWPolicyProfileID <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Regionen in einem Netzwerk sind über eine physische WAN-Verbindung verbunden. Dieses Cmdlet definiert eine Verbindung zwischen zwei Regionen und legt die Bandbreiteneinschränkungen für Audio- und Videoverbindungen zwischen diesen Regionen fest.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsGlobalRelativeIdentity

Eine eindeutige ID für die neu erstellte Netzwerkregionenverbindung. 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.

NetworkRegionID1

Erforderlich

Zeichenfolge

Der Identitätswert (NetworkRegionID) der Region, die mit der durch den Parameter "NetworkRegionID2" identifizierten Region verbunden ist.

NetworkRegionID2

Erforderlich

Zeichenfolge

Der Identitätswert (NetworkRegionID) der Region, die mit der durch den Parameter "NetworkRegionID1" identifizierten Region verbunden ist.

NetworkRegionLinkID

Erforderlich

Zeichenfolge

Dieser Wert ist mit "Identity" identisch. Sie können nicht gleichzeitig den Identitätswert und den Parameter "NetworkRegionLinkID" angeben. Ein Wert, der für einen der beiden Parameter angegeben wird, gilt automatisch für beide.

BWPolicyProfileID

Optional

Zeichenfolge

Der Identitätswert des Bandbreitenrichtlinienprofils, das die Bandbreiteneinschränkungen für diese Verbindung definiert. Sie können eine Liste der verfügbaren Profile durch Aufrufen des Cmdlets Get-CsNetworkBandwidthPolicyProfile abrufen.

Force

Optional

Switch-Parameter

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

InMemory

Optional

Switch-Parameter

Erstellt einen Objektverweis ohne einen Commit für das Objekt auszuführen und die Änderungen dadurch dauerhaft zu speichern. Wenn Sie die Ausgabe des mit diesem Parameter aufgerufenen Cmdlet einer Variablen zuweisen, können Sie die Eigenschaften des Objektverweises ändern und anschließend einen Commit für diese Änderungen ausführen, indem Sie das entsprechende Cmdlet vom Typ "Set-" aufrufen.

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

Keine.

Rückgabetypen

Mit diesem Cmdlet wird ein Objekt vom Typ "Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkRegionLinkType" erstellt.

Beispiel

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

New-CsNetworkRegionLink -Identity NA_EMEA -NetworkRegionID1 NorthAmerica -NetworkRegionID2 EMEA -BWPolicyProfileID LowBWLimits

In diesem Beispiel wird die neue Netzwerkregionenverbindung "NA_EMEA" zum Verbinden der Regionen "NorthAmerica" und "EMEA" erstellt. Der Name der Regionenverbindung wird als Wert für den Parameter "Identity" festgelegt. (Dieser Wert wird automatisch als Wert des Parameters "NetworkRegionLinkID" zugewiesen.) Zum Erstellen der Verbindung müssen die beiden zu verbindenden Netzwerkregionen angegeben werden, in diesem Fall "NorthAmerica" und "EMEA". In diesem Beispiel wurde auch dem Parameter "BWPolicyProfile" ein Wert zugewiesen. Hierdurch werden die Bandbreiteneinschränkungen, die in diesem Bandbreitenrichtlinienprofil (LowBWLimits) definiert sind, den Verbindungen zwischen diesen Regionen zugewiesen. Wenn keine "BWPolicyProfileID" angegeben wird, gelten keine Bandbreiteneinschränkungen für Verbindungen zwischen diesen beiden Regionen. (Es kann dennoch Einschränkungen zwischen Standorten geben. Einzelheiten finden Sie im Hilfethema New-CsNetworkSite.)