• Artikel

New-CsNetworkSubnet

 

Letztes Änderungsdatum des Themas: 2012-03-27

Erstellt ein neues Netzwerksubnetz.

Syntax

New-CsNetworkSubnet -Identity <XdsGlobalRelativeIdentity> -MaskBits <Int32> [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-NetworkSiteID <String>] [-WhatIf [<SwitchParameter>]]

New-CsNetworkSubnet -MaskBits <Int32> -SubnetID <String> [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-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. Verwenden Sie dieses Cmdlet, um ein neues Subnetz zu erstellen und es gleichzeitig (optional) einem Netzwerkstandort zuzuweisen.

In den meisten Bereitstellungen von Microsoft Lync Server 2010 mit Anrufsteuerung ist eine große Anzahl von Subnetzen vorhanden. Daher sollte New-CsNetworkSubnet am besten zusammen mit dem Windows PowerShell-Cmdlet Import-CSV aufgerufen werden. Wenn Sie diese beiden Cmdlets zusammen verwenden, können Sie die Subnetzeinstellungen aus einer CSV-Datei (Comma-Separated Values) abrufen und mehrere Subnetze gleichzeitig erstellen. Weitere Informationen finden Sie im Abschnitt mit den Beispielen für dieses Cmdlet.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet New-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 "New-CsNetworkSubnet"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsGlobalRelativeIdentity

Die eindeutige Subnetz-ID des zu erstellenden Subnetzes. Dabei muss es sich um eine IP-Adresse (z. B. 174.11.12.0) und um die erste Adresse im IP-Adressbereich handeln, der vom Subnetz definiert wurde.

MaskBits

Erforderlich

Int32

Die anzuwendende Bitmaske des Subnetzes, das erstellt wird.

Gültige Werte: 1 bis 32.

SubnetID

Erforderlich

Zeichenfolge

Dabei handelt es sich um den gleichen Wert wie für "Identity". Sie müssen entweder einen Wert für "Identity" oder für "SubnetID" festlegen, sie können jedoch nicht beide Parameter gleichzeitig verwenden. Der Wert, den Sie für den einen Parameter festlegen, wird automatisch auch für den anderen übernommen.

Description

Optional

Zeichenfolge

Eine Beschreibung des Subnetzes, das erstellt wird.

NetworkSiteID

Optional

Zeichenfolge

Die ID des Standorts, dem das Subnetz angehört. 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.

InMemory

Optional

Switch-Parameter

Erstellt einen Objektverweis ohne einen Commit für das Objekt auszuführen und die Änderungen dadurch dauerhaft zu speichern. Wenn Sie die Ausgabe des mit diesem Parameter aufgerufenen Cmdlet einer Variablen zuweisen, können Sie die Eigenschaften des Objektverweises ändern und anschließend einen Commit für diese Änderungen ausführen, indem Sie das entsprechende Cmdlet vom Typ "Set-" aufrufen.

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

Keine.

Rückgabetypen

Erstellt ein Objekt vom Typ "Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.SubnetType".

Beispiel

-------------------------- Beispiel 1 --------------------------

New-CsNetworkSubnet -Identity 172.11.15.0 -MaskBits 24 -NetworkSiteID Vancouver

Dieses Beispiel zeigt, wie Sie ein neues Subnetzobjekt erstellen können, das das Subnetz 172.11.15.0/24 darstellt. Der Identitätswert des Subnetzes wird auf "172.11.15.0" festgelegt. Dieser Wert wird automatisch als Subnetz-ID zugewiesen. Für ein Subnetz müssen Maskenbits definiert sein. Hierzu wird für den Parameter "MaskBits" ein Wert angegeben, in diesem Fall 24. Abschließend wird die Standort-ID "Vancouver" an den Parameter "NetworkSiteID" übergeben, um dieses Subnetz diesem Standort zuzuordnen.

-------------------------- Beispiel 2 --------------------------

Import-CSV C:\subnet.csv | foreach {New-CsNetworkSubnet -Identity $_.Identity -MaskBits $_.Mask -NetworkSiteID $_.SiteID}

In Beispiel 2 werden Daten aus einer CSV-Datei abgerufen, um eine Reihe an Subnetzen zu erstellen. Die in diesem Beispiel verwendete CSV-Datei könnte folgendermaßen aussehen:

Identity, Mask, SiteID

172.11.12.0, 24, Redmond

172.11.13.0, 24, Chicago

172.11.14.0, 25, Vancouver

172.11.15.0, 31, Paris

...

In dem Beispiel wird zunächst das Cmdlet Import-CSV aufgerufen, wobei der Pfad einer CSV-Datei übergeben wird. Das Cmdlet liest den Inhalt dieser Datei in den Arbeitsspeicher. Der Inhalt wird dann an die foreach-Funktion weitergeleitet. Die foreach-Funktion arbeitet den Inhalt Zeile für Zeile durch. Wie Sie anhand der Beispieldatei sehen können, handelt es sich bei der ersten Zeile um eine Liste mit Überschriften, die den restlichen Inhalt definieren. Die foreach-Funktion nutzt diese Überschriften, um namentlich auf die durch Kommas getrennte Werte zuzugreifen.

Als Teil der foreach-Anweisung wird das Cmdlet New-CsNetworkSubnet aufgerufen. Beim Durchlaufen der einzelnen Zeilen des Dateiinhalts werden die jeweiligen Zeilen als Parameterwerte für New-CsNetworkSubnet übergeben. Beim ersten Durchlaufen mit der foreach-Anweisung erstellt das Cmdlet New-CsNetworkSubnet z. B. ein Subnetz mit dem Identitätswert "172.11.12.0". Dabei handelt es sich um den Wert, der in der ersten Zeile mit durch Kommas getrennten Werten an der Position "Identity" steht. ("$_" gibt den aktuellen Wert in der foreach-Schleife an.) Der Maskenwert 24 (Mask) wird dann an den Parameter "MaskBits" weitergeleitet, und der Wert "Redmond" für "SiteID" wird aus der Datei an den Parameter "NetworkSiteID" übergeben.

Dieser Vorgang wird solange fortgesetzt, bis alle Zeilen in der Datei gelesen und anhand der enthaltenen Werte neue Subnetze erstellt wurden.