Delen via

Add-SCVMHostNetworkAdapter

  • Referentie
Module:
VirtualMachineManager

Voegt een fysieke netwerkadapter toe op een host die wordt beheerd door VMM aan een virtueel netwerk.

Syntax

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

Description

De cmdlet Add-SCVMHostNetworkAdapter voegt een fysieke netwerkadapter (ook wel een netwerkinterfacekaart of NIC genoemd) toe aan een host die wordt beheerd door Virtual Machine Manager (VMM) aan een virtueel netwerk. Elke virtuele machine op die host kan ook verbinding maken via een virtuele netwerkadapter naar 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 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 afbeelding 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 $VMHost variabele.

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

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

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 een adapter al 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 dat gebruikmaakt van de Modus Trunk

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 $VMHost variabele.

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

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

De laatste opdracht voegt HostAdapter02 toe aan het virtuele netwerk ExternalNetwork02 en maakt toegang vanuit ExternalNetwork02 mogelijk naar een extern netwerkapparaat met behulp van 802.1Q getagde VLAN's 1, 2, 100, 200 en 1124.

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

Voorbeeld 3: Een fysieke hostnetwerkadapter toevoegen aan een VLAN dat gebruikmaakt van de modus Access

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 $VMHost variabele.

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

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, dus de laatste opdracht mislukt als een adapter al is gekoppeld aan het opgegeven virtuele netwerk.

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

Parameters

-JobGroup

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

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 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 op.

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 Toegang is.

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

  • Gebonden aan een fysieke netwerkadapter op de host of
  • Afhankelijk van 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 virtuele LAN (VLAN) op een virtuele-machinehost verkeer ondersteunt via één VLAN (Access-modus) 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 waarop 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

Met deze cmdlet wordt een VMHostNetworkAdapter-object geretourneerd.