Freigeben über


New-SCVMSubnet

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 für virtuelle Computer. Ein Subnetz eines virtuellen Computers ist ein IP-Subnetz, das einem virtuellen Computernetzwerk zugeordnet ist.

Wenn Sie ein Subnetz eines virtuellen Computers erstellen, müssen Sie SubNetVLan - und VMNetwork-Objekte bereitstellen. Verwenden Sie zum Erstellen des SubnetVLan-Objekts das Cmdlet New-SCSubnetVLan . Verwenden Sie zum Abrufen eines VMNetwork-Objekts das Cmdlet Get-SCVMNetwork. Das logische Netzwerk, das vom virtuellen Computernetzwerk verwendet wird, muss für die Netzwerkvirtualisierung aktiviert sein.

Beispiele

Beispiel 1: Erstellen eines Subnetzs 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 Virtuelle Computernetzwerkobjekt mit dem Namen VMNetwork 01 ab und speichert das Objekt in der $VMNetwork Variablen.

Der letzte Befehl erstellt ein subnetz des virtuellen Computers mit dem Namen VMSubnet01 mit dem in $SubnetVLan gespeicherten Subnetz-VLan und dem in $VMNetwork gespeicherten virtuellen Computernetzwerk.

Parameter

-Description

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

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

Gibt an, dass der Status des Auftrags überwacht und in der von diesem Parameter benannten Variablen gespeichert wird.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LogicalNetworkDefinition

Gibt eine logische Netzwerkdefinition (auch als Netzwerkstandort bezeichnet) an, die das Subnetz enthält, das vom SubnetVLan-Parameter angegeben wird.

Type:LogicalNetworkDefinition
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-MaxNumberOfPorts

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

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUser

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUserRole

Gibt eine Benutzerrolle an. Um eine Benutzerrolle abzurufen, verwenden Sie das Cmdlet Get-SCUserRole . Dieses Cmdlet wird im Namen der Benutzerrolle ausgeführt, die dieser Parameter angibt.

Type:UserRole
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PortACL

Gibt eine Portzugriffssteuerungsliste (ACL) an.

Type:PortACL
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SubnetVLan

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

Informationen zum Erstellen eines SubnetVLan-Typs Get-Help New-SCSubNetVLan.

Type:SubnetVLan[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VMMServer

Gibt ein VMM-Serverobjekt an.

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-VMNetwork

Gibt ein Netzwerkobjekt eines virtuellen Computers an.

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

Type:VMNetwork
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VMSubnetExternal

Gibt an, dass das Virtuelle Computernetzwerk in der Lage ist, mit anderen Netzwerken zu kommunizieren.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VMSubnetID

Gibt die ID eines Subnetzs eines virtuellen Computers an.

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False