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.
Siehe auch
Weitere Ressourcen
New-CsNetworkRegionLink
Remove-CsNetworkRegionLink
Get-CsNetworkRegionLink
Get-CsNetworkBandwidthPolicyProfile