Freigeben über

New-SCStaticIPAddressPool

  • Referenz
Modul:
VirtualMachineManager

Erstellt einen statischen IP-Adresspool.

Syntax

New-SCStaticIPAddressPool
   [-VMMServer <ServerConnection>]
   -Name <String>
   [-Description <String>]
   -Subnet <String>
   [-Vlan <Int32>]
   [-VIPAddressSet <String>]
   [-IPAddressRangeStart <String>]
   [-IPAddressRangeEnd <String>]
   [-IPAddressReservedSet <String>]
   [-DNSSuffix <String>]
   [-EnableNetBIOS <Boolean>]
   -LogicalNetworkDefinition <LogicalNetworkDefinition>
   [-DNSServer <String[]>]
   [-WINSServer <String[]>]
   [-DNSSearchSuffix <String[]>]
   [-PxeServerAddress <String[]>]
   [-DefaultGateway <DefaultGateway[]>]
   [-NetworkRoute <SubnetNetworkRoute[]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCStaticIPAddressPool
   [-VMMServer <ServerConnection>]
   -Name <String>
   [-Description <String>]
   -Subnet <String>
   [-VIPAddressSet <String>]
   [-IPAddressRangeStart <String>]
   [-IPAddressRangeEnd <String>]
   [-IPAddressReservedSet <String>]
   [-DNSSuffix <String>]
   [-EnableNetBIOS <Boolean>]
   -VMSubnet <VMSubnet>
   [-DNSServer <String[]>]
   [-WINSServer <String[]>]
   [-DNSSearchSuffix <String[]>]
   [-PxeServerAddress <String[]>]
   [-DefaultGateway <DefaultGateway[]>]
   [-NetworkRoute <SubnetNetworkRoute[]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCStaticIPAddressPool
   [-VMMServer <ServerConnection>]
   -Name <String>
   [-Description <String>]
   -Subnet <String>
   [-IsMulticast]
   [-IPAddressRangeStart <String>]
   [-IPAddressRangeEnd <String>]
   [-IPAddressReservedSet <String>]
   -LogicalNetworkDefinition <LogicalNetworkDefinition>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet New-SCStaticIPAddressPool erstellt einen statischen IP-Adresspool (Virtual Machine Manager, VMM). Ein statischer IP-Adresspool kann einer oder mehreren Hostgruppen zugeordnet werden.

Beispiele

Beispiel 1: Erstellen eines statischen IP-Adresspools

PS C:\> $HostGroup = Get-SCVMHostGroup | where { $_.Path -eq "All Hosts\HostGroup02\Production" }
PS C:\> $LogNet = Get-SCLogicalNetwork -Name "LogicalNetwork01"
PS C:\> $LogNetDef = Get-SCLogicalNetworkDefinition -VMHostGroup $HostGroup -LogicalNetwork $LogNet -Name "Logical Network Definition 01"
PS C:\> $DefaultGateway = New-SCDefaultGateway -IPAddress "10.0.0.1" -Metric 10
PS C:\> New-SCStaticIPAddressPool -LogicalNetworkDefinition $LogNetDef -Name "Production IP Address Pool" -Description "This IP address pool is used for LOB Apps in production" -Subnet "10.0.0.0/24" -IPAddressRangeStart "10.0.0.10" -IPAddressRangeEnd "10.0.0.99" -IPAddressReservedSet "10.0.0.25-10.0.0.35, 10.0.0.38" -VIPAddressSet "10.0.0.95-10.0.0.99" -DNSSuffix "domain.contoso.com" -DNSSearchSuffix domain1.contoso.com, domain2.contoso.com -DNSServer "10.0.0.1", "10.0.0.2" -WINSServer "10.0.0.1", "10.0.0.2" -DefaultGateway $DefaultGateway -EnableNetBIOS $True

Der erste Befehl ruft die Hostgruppe ab, die den Pfad "All Hosts\HostGroup02\Production" aufweist, und speichert diese Gruppe dann in der variablen $HostGroup.

Der zweite Befehl ruft das logische Netzwerk mit dem Namen LogicalNetwork01 ab und speichert dieses Netzwerk in der $LogNet Variablen.

Der dritte Befehl ruft die logische Netzwerkdefinition mit dem Namen Logical Network Definition 01 für die Hostgruppe ab, die in der $HostGroup Variablen gespeichert ist.

Der vierte Befehl erstellt ein Standardgateway und speichert es dann in der variablen $DefaultGateway.

Der letzte Befehl erstellt einen statischen IP-Adresspool mit den angegebenen Werten.

Parameter

-DefaultGateway

Gibt ein Array von Standardgatewayobjekten an.

Typ:DefaultGateway[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Description

Gibt eine Beschreibung für den Adresspool an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DNSSearchSuffix

Gibt ein Array von Zeichenfolgen an, die an einen Hostnamen angefügt werden, um eine DNS-Adresse aufzulösen.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DNSServer

Gibt ein Array von IP-Adressen von DNS-Servern an. Gültige Formate sind: IPv4- und IPv6-Adressen.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DNSSuffix

Gibt das standardmäßige DNS-Suffix an, das einem Adapter zugeordnet ist.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableNetBIOS

Gibt an, ob NetBIOS über TCP/IP für einen Adapter aktiviert werden soll.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-IPAddressRangeEnd

Gibt die letzte IP-Adresse in einem Bereich von IP-Adressen an. Wird mit dem parameter IPAddressRangeStart verwendet.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-IPAddressRangeStart

Gibt die erste IP-Adresse in einem Bereich von IP-Adressen an. Wird mit dem parameter IPAddressRangeEnd verwendet.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-IPAddressReservedSet

Gibt einen Satz von IP-Adressen in einem IP-Subnetz an, das für andere Zwecke reserviert ist.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-IsMulticast

Gibt an, dass die IP-Adresse eine Multicastadresse ist oder dass der IP-Adresspool einen Multicast-IP-Adressbereich enthält.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-JobVariable

Gibt eine Variable an, in der der Auftragsfortschritt nachverfolgt und gespeichert wird.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-LogicalNetworkDefinition

Gibt eine logische Netzwerkdefinition an, die das Subnetz enthält, das vom IP-Adresspool gemäß dem Parameter Subnetz angegeben wird. Eine logische Netzwerkdefinition wird auch als Netzwerkstandort bezeichnet.

Typ:LogicalNetworkDefinition
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen für den Adresspool an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NetworkRoute

Gibt ein Array von Netzwerkrouten an.

Typ:SubnetNetworkRoute[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-OnBehalfOfUser

Gibt einen Benutzernamen an. Dieses Cmdlet wird im Auftrag des Benutzers ausgeführt, den dieser Parameter angibt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-OnBehalfOfUserRole

Gibt eine Benutzerrolle an. Verwenden Sie zum Abrufen einer Benutzerrolle das cmdlet Get-SCUserRole. Dieses Cmdlet wird im Auftrag der Benutzerrolle ausgeführt, die dieser Parameter angibt.

Typ:UserRole
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PROTipID

Gibt die ID des Tipps zur Leistungs- und Ressourcenoptimierung (PRO-Tipp) an, der diese Aktion ausgelöst hat. Mit diesem Parameter können Sie PRO-Tipps überwachen.

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PxeServerAddress

Gibt eine Liste der PXE-Server-IP-Adressen an.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Subnet

Gibt ein IP-Subnetz in classless Inter-Domain Routing-Notation (CIDR) an. Sie können entweder IPv4- oder IPv6-Adressen angeben.

Ein IP-Subnetz kann nicht mit einem anderen Subnetz in einer Hostgruppe oder untergeordneten Hostgruppen überlappen.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VIPAddressSet

Gibt einen Satz von IP-Adressen in einem IP-Subnetz an, das für die Konfiguration virtueller IPs (VIPs) in Lastenausgleichsmodulen reserviert ist.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Vlan

Gibt ein virtuelles Lokales Netzwerk (LOCAL Area Network, VLAN) an.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VMMServer

Gibt ein VMM-Serverobjekt an.

Typ:ServerConnection
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-VMSubnet

Gibt ein Subnetz eines virtuellen Computers an.

Um ein VMSubnet--Objekt abzurufen, verwenden Sie das Cmdlet Get-SCVMSubnet.

Typ:VMSubnet
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WINSServer

Gibt ein Array von IP-Adressen von Windows Internet Name Service (WINS)-Servern an. Gültige Formate sind: IPv4- und IPv6-Adressen.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False