• Artikel

Set-CsNetworkRegionLink

 

Letztes Änderungsdatum des Themas: 2012-03-25

Ändert eine Verbindung zwischen zwei Netzwerkregionen, die für die Anrufsteuerung konfiguriert wurden.

Syntax

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

Set-CsNetworkRegionLink [-BWPolicyProfileID <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-NetworkRegionID1 <String>] [-NetworkRegionID2 <String>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Regionen in einem Netzwerk sind über eine physische WAN-Verbindung verbunden. Mit diesem Cmdlet wird eine Verbindung zwischen zwei Regionen geändert, sodass Sie die verbundenen Regionen sowie die Bandbreiteneinschränkung bei Audio- und Videoverbindungen zwischen diesen Regionen ändern können.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsGlobalRelativeIdentity

Die eindeutige ID für die Netzwerkregionenverbindung, die geändert 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.

Instance

Optional

NetworkRegionLinkType

Ein Objektverweis auf die Netzwerkregionenverbindung. Dieses Objekt muss ein Objekt vom Typ "Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkRegionLinkType" sein, das durch Aufrufen von Get-CsNetworkRegionLink abgerufen werden kann.

BWPolicyProfileID

Optional

Zeichenfolge

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

NetworkRegionID1

Optional

Zeichenfolge

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

NetworkRegionID2

Optional

Zeichenfolge

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

Force

Optional

Switch-Parameter

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

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

Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkRegionLinkType-Objekt. Akzeptiert eine weitergeleitete Eingabe von Objekten für die Netzwerkregionenverbindung.

Rückgabetypen

Dieses Cmdlet gibt keinen Wert zurück. Mit ihm wird ein Objekt vom Typ "Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkRegionLinkType" geändert.

Beispiel

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

Set-CsNetworkRegionLink -Identity NA_EMEA -BWPolicyProfileID HighBWLimits

In diesem Beispiel wird das Bandbreitenrichtlinienprofil der Netzwerkregionenverbindung "NA_EMEA" zum Profil "HighBWLimits" geändert. Der Name der Netzwerkregionenverbindung, die geändert werden soll, wird als Wert des Parameters "Identity" festgelegt. Anschließend wird dem Parameter "BWPolicyProfile" der Wert "HighBWLimits" zugewiesen. Dadurch werden die Bandbreiteneinschränkungen, die in diesem Bandbreitenrichtlinienprofil (HighBWLimits) definiert sind, den Verbindungen zwischen diesen Regionen zugewiesen.