• Artikel

Remove-CsNetworkRegionLink

 

Letztes Änderungsdatum des Themas: 2012-03-26

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

Syntax

Remove-CsNetworkRegionLink -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Regionen in einem Netzwerk sind über eine physische WAN-Verbindung verbunden. Dieses Cmdlet hat keinerlei Auswirkungen auf physische Verbindungen, entfernt jedoch die Verbindung aus der Anrufsteuerungskonfiguration.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsGlobalRelativeIdentity

Die eindeutige ID der Netzwerkregionenverbindung, die entfernt 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.

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 Netzwerkregionenverbindungen.

Rückgabetypen

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

Beispiel

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

Remove-CsNetworkRegionLink -Identity NA_EMEA

Im ersten Beispiel wird die Netzwerkregionenverbindung mit dem Identitätswert "NA_EMEA" entfernt.

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

Get-CsNetworkRegionLink | Where-Object {$_.BWPolicyProfileID -eq "HighBWLimits"} | Remove-CsNetworkRegionLink

In Beispiel 2 werden alle Netzwerkregionenverbindungen entfernt, die das Bandbreitenrichtlinienprofil namens "HighBWLimits" verwenden. Das erste im Beispiel aufgerufene Cmdlet ist Get-CsNetworkRegionLink (ohne Parameter), das alle Regionenverbindungen abruft. Diese Auflistung von Verbindungen wird anschließend an das Cmdlet Where-Object weitergeleitet. Where-Object durchläuft die einzelnen Elemente in der Auflistung und prüft den Wert der Eigenschaft "BWPolicyProfileID". Wenn diese Eigenschaft gleich "HighBWLimits" ist (der Vergleichsoperator -eq steht für "equal to"), wird das jeweilige Element an das Cmdlet Remove-CsNetworkRegionLink weitergeleitet, welches die Verbindung entfernt.