Delen via

New-SCLogicalSwitchVirtualNetworkAdapter

  • Referentie
Module:
VirtualMachineManager

Hiermee voegt u een virtuele netwerkadapter (VNIC) toe aan een logische switch.

Syntaxis

New-SCLogicalSwitchVirtualNetworkAdapter
   -UplinkPortProfileSet <UplinkPortProfileSet>
   [-EthernetAddressType <EthernetAddressType>]
   [-IPv4AddressType <EthernetAddressType>]
   [-IPv6AddressType <EthernetAddressType>]
   [-VMNetwork <VMNetwork>]
   [-VMSubnet <VMSubnet>]
   [-PortClassification <PortClassification>]
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-IPv4AddressPool <StaticIPAddressPool>]
   [-IPv6AddressPool <StaticIPAddressPool>]
   [-InheritsAddressFromPhysicalNetworkAdapter <Boolean>]
   [-IsUsedForHostManagement <Boolean>]
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [[-Description] <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

De New-SCLogicalSwitchVirtualNetworkAdapter cmdlet voegt een virtuele netwerkadapter (VNIC) voor de host toe aan het uplinkpoortprofiel als onderdeel van de logische switchdefinitie.

Voorbeelden

Voorbeeld 1: Hiermee maakt u een nieuwe virtuele netwerkadapter voor een logische switch

PS C:\> $UPPSet = Get-SCUplinkPortProfileSet -Name "R1Uplink"
PS C:\> $VmNetwork = Get-SCVMNetwork -Name "MgmtNet"
PS C:\> New-SCLogicalSwitchVirtualNetworkAdapter -Name "LogSw01_Storage" -UplinkPortProfileSet $uppSetVar -RunAsynchronously -VMNetwork $vmNetwork -VLanEnabled $true -VLanID 2162 -IsUsedForHostManagement $false -IPv4AddressType "Dynamic" -IPv6AddressType "Dynamic"

Met de eerste opdracht wordt een uplinkpoortprofiel ingesteld met behulp van de Get-SCUplinkPortProfileSet cmdlet en slaat deze vervolgens op in de variabele $UPPSet.

Met de tweede opdracht wordt het virtuele-machinenetwerk met de naam MgmtNet opgehaald met behulp van de Get-SCVMNetwork-cmdlet en slaat het vervolgens op in de variabele $VmNetwork.

Met de laatste opdracht maakt u een virtuele netwerkadapter voor een logische switch die samen met de logische switch wordt geïmplementeerd op de host.

Parameters

-Description

Hiermee geeft u een beschrijving voor de virtuele netwerkadapter.

Type:String
Position:1
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-EthernetAddressType

Hiermee geeft u een Ethernet-adrestype op. De acceptabele waarden voor deze parameter zijn:

  • Dynamisch
  • Statisch
Type:EthernetAddressType
Geaccepteerde waarden:Dynamic, Static
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InheritsAddressFromPhysicalNetworkAdapter

Geeft aan of de netwerkadapter het adres van een fysieke netwerkadapter overneemt.

Type:Boolean
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-IPv4AddressPool

Hiermee geeft u een statische adresgroep op die IPv4-adressen bevat.

Type:StaticIPAddressPool
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-IPv4AddressType

Hiermee geeft u een IPv4-adrestype op. De acceptabele waarden voor deze parameter zijn:

  • Dynamisch
  • Statisch
Type:EthernetAddressType
Geaccepteerde waarden:Dynamic, Static
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-IPv6AddressPool

Hiermee geeft u een statische adresgroep op die IPv6-adressen bevat.

Type:StaticIPAddressPool
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-IPv6AddressType

Hiermee geeft u een IPv6-adrestype op. De acceptabele waarden voor deze parameter zijn:

  • Dynamisch
  • Statisch
Type:EthernetAddressType
Geaccepteerde waarden:Dynamic, Static
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-IsUsedForHostManagement

Geeft aan of de virtuele netwerkadapter wordt gebruikt voor hostbeheer.

Type:Boolean
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-JobVariable

Hiermee geeft u op dat de voortgang van de taak wordt bijgehouden en opgeslagen in de variabele met de naam van deze parameter.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam van de netwerkadapter.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PortClassification

Hiermee geeft u de poortclassificatie van de switch waarmee de virtuele netwerkadapter verbinding maakt.

Type:PortClassification
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-PROTipID

Hiermee geeft u de id op van de tip Prestatie- en resourceoptimalisatie (PRO-tip) die deze actie heeft geactiveerd. Met deze parameter kunt u PRO-tips controleren.

Type:Guid
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RunAsynchronously

Geeft aan dat de taak asynchroon wordt uitgevoerd, zodat het besturingselement onmiddellijk terugkeert naar de opdrachtshell.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-UplinkPortProfileSet

Hiermee geeft u een uplinkpoortprofielsetobject.

Als u een uplinkpoortprofielsetobject wilt verkrijgen, gebruikt u de cmdlet Get-SCUplinkPortProfileSet.

Type:UplinkPortProfileSet
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-VLanEnabled

Hiermee wordt aangegeven of een virtueel LAN (VLAN) moet worden ingeschakeld voor gebruik door virtuele machines op een Hyper-V of Citrix XenServer-host.

  • Voorbeeldindeling voor één VLAN: -VLANEnabled -VLANMode "Access" -VLANID 35
  • Voorbeeldindeling voor meerdere VLAN's: -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124
Type:Boolean
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-VLanID

Wijst een numerieke id in het bereik 1-4094 toe aan een virtuele netwerkadapter op een virtuele machine of aan een fysieke netwerkadapter op een host van een virtuele machine.

Configureer een VLanID op een Hyper-V-, VMware ESX- of Citrix XenServer-host op een extern gebonden fysieke netwerkadapter wanneer de VLan-modus Access is.

Configureer een VLanID op een virtuele netwerkadapter van een virtuele machine die is gebonden aan een fysieke netwerkadapter op de host of gebonden aan een intern virtueel netwerk op de host.

Voorbeeldindeling: -VLanEnabled -VLanMode "Access" -VLANID 35

Type:UInt16
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-VMMServer

Hiermee geeft u een VMM-serverobject.

Type:ServerConnection
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-VMNetwork

Hiermee geeft u een VM-netwerkobject.

Gebruik de cmdlet Get-SCVMNetwork om een VM-netwerkobject op te halen.

Type:VMNetwork
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-VMSubnet

Hiermee geeft u een subnetobject van de virtuele machine op.

Als u een VMSubnet--object wilt verkrijgen, gebruikt u de cmdlet Get-SCVMSubnet.

Type:VMSubnet
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False