Freigeben über

New-SCVMSubnet

  • Referenz
Modul:
VirtualMachineManager

Erstellt ein Subnetz eines virtuellen Computers.

Syntax

New-SCVMSubnet
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [[-Description] <String>]
   -SubnetVLan <SubnetVLan[]>
   -VMNetwork <VMNetwork>
   [-VMSubnetID <UInt32>]
   [-MaxNumberOfPorts <UInt32>]
   [-PortACL <PortACL>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVMSubnet
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [[-Description] <String>]
   -SubnetVLan <SubnetVLan[]>
   -VMNetwork <VMNetwork>
   -LogicalNetworkDefinition <LogicalNetworkDefinition>
   [-MaxNumberOfPorts <UInt32>]
   [-PortACL <PortACL>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVMSubnet
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [[-Description] <String>]
   [-VMSubnetExternal]
   -VMNetwork <VMNetwork>
   [-MaxNumberOfPorts <UInt32>]
   [-PortACL <PortACL>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet New-SCVMSubnet erstellt ein Subnetz eines virtuellen Computers. Ein Subnetz eines virtuellen Computers ist ein IP-Subnetz, das einem Netzwerk eines virtuellen Computers zugeordnet ist.

Wenn Sie ein Subnetz für virtuelle Computer erstellen, müssen Sie SubNetVLan- und VMNetwork--Objekte bereitstellen. Zum Erstellen des SubnetVLan--Objekts verwenden Sie das Cmdlet New-SCSubnetVLan. Um ein VMNetwork--Objekt abzurufen, verwenden Sie das Cmdlet Get-SCVMNetwork. Das logische Netzwerk, das vom Netzwerk des virtuellen Computers verwendet wird, muss für die Netzwerkvirtualisierung aktiviert sein.

Beispiele

Beispiel 1: Erstellen eines Subnetzes für virtuelle Computer, das NVGRE als Kapselungsmechanismus verwendet

PS C:\> $SubNetVLan = New-SCSubnetVLan -Subnet "192.168.3.0/24"
PS C:\> $VMNetwork = Get-SCVMNetwork -Name "VMNetwork01"
PS C:\> New-SCVMSubnet -Name "VMSubnet01" -SubnetVLan $SubnetVLan -VMNetwork $VMNetwork

Der erste Befehl erstellt ein Subnetz-VLan-Objekt und speichert das Objekt in der $SubNetVLan Variablen.

Der zweite Befehl ruft das Netzwerkobjekt des virtuellen Computers mit dem Namen VMNetwork 01 ab und speichert das Objekt in der $VMNetwork Variablen.

Der letzte Befehl erstellt ein Subnetz eines virtuellen Computers mit dem Namen VMSubnet01 unter Verwendung des subnetz-VLan, das in $SubnetVLan gespeichert ist, und das virtuelle Computernetzwerk, das in $VMNetwork gespeichert ist.

Parameter

-Description

Gibt eine Beschreibung für ein Subnetz eines virtuellen Computers an.

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

-JobVariable

Gibt an, dass der Auftragsfortschritt nachverfolgt und in der Variablen gespeichert wird, die von diesem Parameter benannt wird.

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

-LogicalNetworkDefinition

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

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

-MaxNumberOfPorts

Gibt die maximale Anzahl von Ports an, die vom Subnetz des virtuellen Computers unterstützt werden.

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

-Name

Gibt den Namen eines VMM-Objekts (Virtual Machine Manager) an.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
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

-PortACL

Gibt eine Portzugriffssteuerungsliste (ACL) an.

Typ:PortACL
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

-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

-SubnetVLan

Gibt einen oder mehrere IP-Subnetz- und VLAN-Sätze an.

Geben Sie Get-Help New-SCSubNetVLanein, um Informationen zum Erstellen eines SubnetVLan zu erstellen.

Typ:SubnetVLan[]
Position:Named
Standardwert:None
Erforderlich:True
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

-VMNetwork

Gibt ein Netzwerkobjekt für virtuelle Computer an.

Um ein Netzwerkobjekt eines virtuellen Computers abzurufen, verwenden Sie das Cmdlet Get-SCVMNetwork.

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

-VMSubnetExternal

Gibt an, dass das Netzwerk des virtuellen Computers in der Lage ist, mit anderen Netzwerken zu kommunizieren.

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

-VMSubnetID

Gibt die ID eines Subnetzes eines virtuellen Computers an.

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