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