Freigeben über


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.