Delen via

Add-SCVMHostNetworkAdapter

  • Referentie
Module:
VirtualMachineManager

Hiermee voegt u een fysieke netwerkadapter toe aan een virtueel netwerk op een host die wordt beheerd door VMM.

Syntax

Add-SCVMHostNetworkAdapter
   -VirtualNetwork <VirtualNetwork>
   [-VLanEnabled]
   [-VLanMode <VlanMode>]
   [-VLanID <UInt16>]
   [-VLanTrunkID <UInt16[]>]
   [-VMHostNetworkAdapter] <HostNetworkAdapter>
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

Met de cmdlet Add-SCVMHostNetworkAdapter wordt een fysieke netwerkadapter (ook wel een netwerkinterfacekaart of NIC genoemd) op een host die wordt beheerd door Virtual Machine Manager (VMM) toegevoegd aan een virtueel netwerk. Elke virtuele machine op die host kan ook via een virtuele netwerkadapter verbinding maken met dat virtuele netwerk.

Een virtueel netwerk dat op een host is geconfigureerd, kan verbinding maken met meerdere virtuele netwerkadapters op virtuele machines die op die host zijn geïmplementeerd.

VMM voor System Center 2019 en hoger bevat ondersteuning voor virtuele netwerken voor het configureren van een of meer VLAN's (Virtual Local Area Networks) op een host. U kunt de cmdlet Add-SCVMHostNetworkAdapter of de cmdlet Set-SCVMHostNetworkAdapter gebruiken om één VLAN of meerdere VLAN's op een host te configureren. Als u de bijbehorende VLAN-instellingen op een virtuele machine wilt configureren, gebruikt u de cmdlet New-SCVirtualNetworkAdapter of de cmdlet Set-SCVirtualNetworkAdapter .

Zie de voorbeelden voor deze cmdlet voor een illustratie van elk type VLAN.

Voorbeelden

Voorbeeld 1: Een fysieke hostnetwerkadapter toevoegen aan een virtueel netwerk

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01.Contoso.com"
PS C:\> $VirtualNetwork = Get-SCVirtualNetwork -VMHost $VMHost -Name "ExternalVirtualNetwork01"
PS C:\> $VMHostNetworkAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "HostAdapter01"
PS C:\> Add-SCVMHostNetworkAdapter -VirtualNetwork $VirtualNetwork -VMHostNetworkAdapter $VMHostNetworkAdapter

Met de eerste opdracht wordt het hostobject met de naam VMHost01 opgehaald en wordt het object opgeslagen in de variabele $VMHost.

Met de tweede opdracht wordt het virtuele netwerkobject met de naam ExternalVirtualNetwork01 op VMHost01 opgehaald en wordt het object opgeslagen in de variabele $VirtualNetwork.

Met de derde opdracht wordt het fysieke netwerkadapterobject met de naam HostAdapter01 op VMHost01 opgehaald en wordt het object opgeslagen in de variabele $VMHostNetworkAdapter.

Met de laatste opdracht wordt HostAdapter01 toegevoegd aan ExternalVirtualNetwork01.

Opmerking: u kunt slechts één fysieke hostadapter per virtueel netwerk toevoegen. Daarom mislukt de laatste opdracht als er al een adapter is gekoppeld aan het opgegeven virtuele netwerk. Als u een nieuwe adapter wilt toevoegen aan het virtuele netwerk, moet u eerst de bestaande hostadapter verwijderen.

Voorbeeld 2: Een fysieke hostnetwerkadapter toevoegen aan een VLAN die de modus Trunk gebruikt

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost02"
PS C:\> $VirtualNetwork = Get-SCVirtualNetwork -VMHost $VMHost -Name "ExternalNetwork02"
PS C:\> $VMHostNetworkAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "HostAdapter02"
PS C:\> Add-SCVMHostNetworkAdapter -VirtualNetwork $VirtualNetwork -VMHostNetworkAdapter $VMHostNetworkAdapter -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124

Met de eerste opdracht wordt het hostobject met de naam VMHost02 opgehaald en wordt het object opgeslagen in de variabele $VMHost.

Met de tweede opdracht wordt het virtuele netwerkobject met de naam ExternalNetwork02 op VMHost02 opgehaald en wordt het object opgeslagen in de variabele $VirtualNetwork.

Met de derde opdracht wordt het netwerkadapterobject met de naam HostAdapter02 op VMHost02 opgehaald en wordt het adapterobject opgeslagen in de variabele $VMHostNetworkAdapter.

Met de laatste opdracht wordt HostAdapter02 toegevoegd aan het virtuele netwerk ExternalNetwork02 en wordt toegang vanuit ExternalNetwork02 tot een extern netwerkapparaat mogelijk gemaakt met VLAN's 1, 2, 100, 200, 200 en 1124.

Opmerking: u kunt slechts één hostadapter per virtueel netwerk toevoegen, zodat de laatste opdracht mislukt als er al een adapter is gekoppeld aan het opgegeven virtuele netwerk.

Voorbeeld 3: Een fysieke hostnetwerkadapter toevoegen aan een VLAN die de modus Toegang gebruikt

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost03.Contoso.com"
PS C:\> $VirtualNetwork = Get-SCVirtualNetwork -VMHost $VMHost -Name "ExternalVirtualNetwork03"
PS C:\> $VMHostNetworkAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "HostAdapter03"
PS C:\> Add-SCVMHostNetworkAdapter -VirtualNetwork $VirtualNetwork -VMHostNetworkAdapter $VMHostNetworkAdapter -VLanEnabled -VLanMode "Access" -VLanID 22

Met de eerste opdracht wordt het hostobject met de naam VMHost03 opgehaald en wordt het object opgeslagen in de variabele $VMHost.

Met de tweede opdracht wordt het virtuele netwerkobject met de naam ExternalNetwork03 op VMHost03 opgehaald en wordt het object opgeslagen in de variabele $VirtualNetwork.

Met de derde opdracht wordt het netwerkadapterobject met de naam HostAdapter03 op VMHost03 opgehaald en wordt het adapterobject opgeslagen in de variabele$VMHostNetworkAdapter.

Met de laatste opdracht wordt HostAdapter03 toegevoegd aan het virtuele netwerk ExternalNetwork03 en wordt de toegang tot ExternalNetwork03 beperkt tot VLANID 22.

Opmerking: u kunt slechts één hostadapter per virtueel netwerk toevoegen, zodat de laatste opdracht mislukt als er al een adapter is gekoppeld aan het opgegeven virtuele netwerk.

Let op: in dit voorbeeld wordt ervan uitgegaan dat uw host al is verbonden met een VLAN. Als dat niet het enige is, moet u ervoor zorgen dat uw host twee netwerkadapters heeft. Als uw host één netwerkadapter heeft, kan VMM de host niet beheren door de adapter toe te wijzen aan een VLAN dat niet beschikbaar is voor de VMM-server. U kunt de stappen in dit voorbeeld uitvoeren op een host met slechts één netwerkadapter als u eerst de Microsoft Loopback Adapter op uw server installeert.

Parameters

-JobGroup

Hiermee geeft u een id op voor een reeks opdrachten die worden uitgevoerd als een set net voordat de laatste opdracht die dezelfde taakgroep-id bevat wordt uitgevoerd.

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

-PROTipID

Hiermee geeft u de id op van de tip voor 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
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VirtualNetwork

Hiermee geeft u een virtueel netwerkobject.

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

-VLanEnabled

Hiermee schakelt u een virtueel LAN (VLAN) in 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:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VLanID

Hiermee wordt een numerieke id in het bereik 1-4094 toegewezen 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.

Een VLanID configureren op een virtuele netwerkadapter van een virtuele machine:

  • 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VLanMode

Hiermee geeft u op of een virtueel LAN (VLAN) op een host van een virtuele machine verkeer ondersteunt via één VLAN (toegangsmodus) of over meerdere VLAN's (Trunk-modus). Geldige waarden zijn: Access, Trunk.

Type:VlanMode
Accepted values:Access, Trunk, Invalid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VLanTrunkID

Hiermee wordt een lijst met numerieke id's in het bereik 1-4094 toegewezen aan een fysieke netwerkadapter op een Hyper-V-host.

Voorbeeldindeling: -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124

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

-VMHostNetworkAdapter

Hiermee geeft u een fysiek netwerkadapterobject op een host waarmee virtuele machines die op die host zijn geïmplementeerd, verbinding kunnen maken.

Voorbeeldindeling: -VMHostNetworkAdapter $VMHostNIC

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

Uitvoerwaarden

VMHostNetworkAdapter

Deze cmdlet retourneert een VMHostNetworkAdapter-object .