Get-CsNetworkSubnet
Letztes Änderungsdatum des Themas: 2012-03-23
Ruft Informationen zu einem oder mehreren Netzwerksubnetzen ab.
Syntax
Get-CsNetworkSubnet [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsNetworkSubnet [-Filter <String>] [-LocalStore <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 Informationen zum Subnetz abrufen, einschließlich des Identitätswerts (die Subnetz-ID), der Anzahl von Maskenbits, des zugeordneten Netzwerkstandorts und der Beschreibung des Subnetzes.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Get-CsNetworkSubnet lokal ausführen: RTCUniversalUserAdmins, 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 "Get-CsNetworkSubnet"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Optional |
XdsGlobalRelativeIdentity |
Die eindeutige ID des Subnetzes, das abgerufen werden soll. Dieser Wert ist eine IP-Adresse (z. B. 174.11.12.0). |
Filter |
Optional |
Zeichenfolge |
Mit diesem Parameter wird eine Platzhaltersuche nach allen Subnetzen anhand des Identitätswerts durchgeführt. Mit dem Filterwert "172.11.*" werden beispielsweise alle Subnetze abgerufen, deren Identitätswert mit 172.11 beginnt. (Beispiel: 172.11.10.0, 172.11.25.0 usw.) |
LocalStore |
Optional |
Switch-Parameter |
Ruft die Informationen zum Netzwerksubnetz aus dem lokalen Replikat des zentraler Verwaltungsspeichers ab, statt die Daten aus dem zentraler Verwaltungsspeicher selbst abzurufen. |
Eingabetypen
Keine.
Rückgabetypen
Gibt ein oder mehrere Objekte vom Typ "Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.SubnetType" zurück.
Beispiel
-------------------------- Beispiel 1 --------------------------
Get-CsNetworkSubnet
In diesem Beispiel werden alle Subnetze in der Microsoft Lync Server 2010-Bereitstellung abgerufen.
-------------------------- Beispiel 2 --------------------------
Get-CsNetworkSubnet -Identity 172.11.15.0
In diesem Beispiel werden alle Informationen zum Subnetz mit dem Identitätswert (der Subnetz-ID) 172.11.15.0 abgerufen.
-------------------------- Beispiel 3 --------------------------
Get-CsNetworkSubnet -Filter 172.11.*
In diesem Beispiel werden alle Subnetze abgerufen, deren Identitätswerte mit "172.11." beginnen.
-------------------------- Beispiel 4 --------------------------
Get-CsNetworkSubnet | Where-Object {$_.NetworkSiteID -eq "Vancouver"}
In Beispiel 4 werden alle Subnetze abgerufen, die dem Standort "Vancouver" zugeordnet sind. Zunächst wird das Cmdlet Get-CsNetworkSubnet ohne Parameter aufgerufen, wodurch alle definierten Subnetze zurückgegeben werden, wie in Beispiel 2 dargestellt. 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").