Remove-CsNetworkSite
Letztes Änderungsdatum des Themas: 2012-03-26
Entfernt einen Netzwerkstandort, der für die Anrufsteuerung oder 9-1-1 (erweitert) (E9-1-1) definiert wurde.
Syntax
Remove-CsNetworkSite -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Netzwerkstandorte sind Niederlassungen oder Standorte, die in jeder Region einer Anrufsteuerungs- oder E9-1-1-Bereitstellung konfiguriert sind. Mit diesem Cmdlet wird ein Standort aus der Anrufsteuerungs- oder E9-1-1-Konfiguration entfernt.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Remove-CsNetworkSite 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 "Remove-CsNetworkSite"}
Parameter
Parameter | Erforderlich | Typ | Beschreibung |
---|---|---|---|
Identity |
Erforderlich |
XdsGlobalRelativeIdentity |
Die eindeutige ID des Netzwerkstandorts, der entfernt werden soll. Standorte werden nur global erstellt. Sie müssen daher keinen Gültigkeitsbereich festlegen. Es genügt, wenn Sie die Standort-ID angeben. |
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.DisplayNetworkSiteType-Objekt. Akzeptiert eine weitergeleitete Eingabe von Netzwerkstandortobjekten.
Rückgabetypen
Dieses Cmdlet gibt keinen Wert zurück. Mit ihm wird ein Objekt vom Typ "Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.DisplayNetworkSiteType" entfernt.
Beispiel
-------------------------- Beispiel 1 --------------------------
Remove-CsNetworkSite -Identity Vancouver
In diesem Beispiel wird der Standort mit dem Identitätswert "Vancouver" aus der Anrufsteuerungs- oder E9-1-1-Konfiguration entfernt.
-------------------------- Beispiel 2 --------------------------
Get-CsNetworkSite | Where-Object {$_.BWPolicyProfileID -eq "LowBWProfile"} | Remove-CsNetworkSite
In Beispiel 2 werden alle Netzwerke, die das Bandbreitenrichtlinienprofil "LowBWProfile" verwenden, aus der Anrufsteuerungs- oder E9-1-1-Konfiguration entfernt. Hierbei wird zunächst Get-CsNetworkSite aufgerufen, um alle Netzwerkstandorte abzurufen. Diese Auflistung von Standorten wird an das Cmdlet Where-Object weitergeleitet, das sie auf lediglich die Standorte beschränkt, deren "BWPolicyProfileID" den Wert "LowBWProfile" aufweist (der Vergleichsoperator "-eq" steht für "equal to"). Diese neue Auflistung wird dann an Remove-CsNetworkSite weitergeleitet, um alle diese Standorte zu entfernen.