Set-CsNetworkSubnet
Letztes Änderungsdatum des Themas: 2012-03-26
Ändert ein vorhandenes Netzwerksubnetz.
Syntax
Set-CsNetworkSubnet [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-MaskBits <Int32>] [-NetworkSiteID <String>] [-WhatIf [<SwitchParameter>]]
Set-CsNetworkSubnet [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaskBits <Int32>] [-NetworkSiteID <String>] [-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. Sie können mit diesem Cmdlet den zugeordneten Netzwerkstandort, die Beschreibung des Subnetzes oder die Maskenbits für das Subnetz ändern.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Set-CsNetworkSubnet 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 "Set-CsNetworkSubnet"}
Parameter
Parameter | Erforderlich | Typ | Beschreibung |
---|---|---|---|
Identity |
Optional |
XdsGlobalRelativeIdentity |
Die eindeutige ID für das Subnetz, das geändert werden soll. Dieser Wert ist entweder eine IP-Adresse (z. B. 174.11.12.0) oder ein URL, der mit "http:" oder "https:" beginnt. |
Instance |
Optional |
SubnetType |
Ein Verweis auf ein Netzwerksubnetzobjekt, das geändert werden soll. Dieses Objekt muss ein Objekt vom Typ "Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.SubnetType" sein und kann durch Aufrufen von Get-CsNetworkSubnet abgerufen werden. |
Description |
Optional |
Zeichenfolge |
Eine Beschreibung des Subnetzes, das geändert werden soll. |
MaskBits |
Optional |
Int32 |
Die auf das Subnetz anzuwendende Bitmaske. |
NetworkSiteID |
Optional |
Zeichenfolge |
Die Standort-ID des Netzwerkstandorts, auf den dieses Subnetz angewendet werden soll. Sie können Standort-IDs für Ihre Bereitstellung abrufen, indem Sie das Cmdlet Get-CsNetworkSite aufrufen. |
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" geändert.
Beispiel
-------------------------- Beispiel 1 --------------------------
Set-CsNetworkSubnet -Identity 172.11.15.0 -MaskBits 25 -NetworkSiteID Chicago
In diesem Beispiel wird das Subnetz mit dem Identitätswert (der Subnetz-ID) 172.11.15.0 geändert. Dieses Subnetz wurde mit einem neuen Wert für "MaskBits" (25) und mit einem neuen Wert für "NetworkSiteID" (Chicago) geändert.
-------------------------- Beispiel 2 --------------------------
Get-CsNetworkSubnet | Where-Object {$_.NetworkSiteID -eq "Vancouver"} | Set-CsNetworkSubnet -NetworkSiteID Chicago
In Beispiel 2 werden alle Subnetze vom Standort "Vancouver" zum Standort "Chicago" verschoben. 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 Set-CsNetworkSubnet weitergeleitet. Es wird ein Parameter für Set-CsNetworkSubnet bereitgestellt: NetworkSiteID. Indem der Wert "Chicago" an den Parameter übergeben wird, wird Set-CsNetworkSubnet angewiesen, die Netzwerkstandort-ID für jedes Element in der Auflistung in "Chicago" zu ändern.