Remove-CsNetworkSubnet
Letztes Änderungsdatum des Themas: 2012-03-27
Entfernt ein vorhandenes Netzwerksubnetz.
Syntax
Remove-CsNetworkSubnet -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Jedes Subnetz muss einem Netzwerkstandort zugeordnet sein, damit der geografische Standort und der zu diesem Subnetz gehörende Host ermittelt werden können. Verwenden Sie dieses Cmdlet, um ein Netzwerksubnetz zu entfernen.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Remove-CsNetworkSubnet 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-CsNetworkSubnet"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Erforderlich |
XdsGlobalRelativeIdentity |
Die eindeutige ID des Subnetzes, das entfernt werden soll. Dieser Wert ist eine IP-Adresse (z. B. 174.11.12.0). |
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.SubnetType-Objekt. Akzeptiert eine weitergeleitete Eingabe von Netzwerksubnetzobjekten.
Rückgabetypen
Dieses Cmdlet gibt keinen Wert zurück. Mit ihm wird ein Objekt vom Typ "Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.SubnetType" entfernt.
Beispiel
-------------------------- Beispiel 1 --------------------------
Remove-CsNetworkSubnet -Identity 172.11.15.0
In diesem Beispiel wird das Subnetz mit dem Identitätswert (d. h. der Subnetz-ID) "172.11.15.0" entfernt.
-------------------------- Beispiel 2 --------------------------
Get-CsNetworkSubnet | Where-Object {$_.NetworkSiteID -eq "Vancouver"} | Remove-CsNetworkSubnet
In Beispiel 2 werden alle Subnetze entfernt, die dem Standort "Vancouver" zugeordnet sind. Hierzu wird das Cmdlet Get-CsNetworkSubnet aufgerufen. Dadurch wird eine Auflistung aller Subnetze abgerufen, die in der Microsoft Lync Server 2010-Bereitstellung definiert wurden. Diese Auflistung von Subnetzen wird dann an das Cmdlet Where-Object weitergeleitet. Mit Where-Object wird diese Auflistung auf die Subnetze beschränkt, deren Parameter "NetworkSiteID" den Wert "Vancouver" aufweisen (der Vergleichsoperator "-eq" steht für "equal to"). Da die Auflistung jetzt nur die Subnetze enthält, die dem Standort "Vancouver" zugeordnet sind, wird die Auflistung an das Cmdlet Remove-CsNetworkSubnet weitergeleitet, das jedes Element in der Auflistung entfernt.