Delen via

Set-SCVMHostNetworkAdapter

  • Referentie
Module:
VirtualMachineManager

Hiermee wijzigt u netwerkeigenschappen voor een fysieke netwerkadapter op een host die wordt beheerd door VMM.

Syntaxis

Set-SCVMHostNetworkAdapter
   [-VMHostNetworkAdapter] <HostNetworkAdapter>
   [-Description <String>]
   [-VLanMode <VlanMode>]
   [-AvailableForPlacement <Boolean>]
   [-UsedForManagement <Boolean>]
   [-SubnetVLan <SubnetVLan[]>]
   [-RemoveUnassignedVLan <UInt16[]>]
   [-AddOrSetLogicalNetwork <LogicalNetwork>]
   [-RemoveLogicalNetwork <LogicalNetwork>]
   [-EnableNetworkVirtualization <Boolean>]
   [-UplinkPortProfileSet <UplinkPortProfileSet>]
   [-RemoveUplinkPortProfileSet]
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCVMHostNetworkAdapter
   [-VMHostNetworkAdapter] <HostNetworkAdapter>
   [-Description <String>]
   [-VLanEnabled <Boolean>]
   [-VLanMode <VlanMode>]
   [-VLanID <UInt16>]
   [-VLanTrunkID <UInt16[]>]
   [-AvailableForPlacement <Boolean>]
   [-UsedForManagement <Boolean>]
   [-RemoveUnassignedVLan <UInt16[]>]
   [-EnableNetworkVirtualization <Boolean>]
   [-UplinkPortProfileSet <UplinkPortProfileSet>]
   [-RemoveUplinkPortProfileSet]
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

De Set-SCVMHostNetworkAdapter cmdlet wijzigt netwerkeigenschappen voor een fysieke netwerkadapter op een host die wordt beheerd door Virtual Machine Manager (VMM).

Eigenschappen die u met deze cmdlet kunt wijzigen, zijn onder andere:

  • VLAN-instellingen: u kunt de VLAN-parameters gebruiken om één VLAN of meerdere VLAN's te maken of te wijzigen. Zie de voorbeelden voor een afbeelding van het opgeven van VLAN-instellingen.

Typ Get-Help Add-SCVMHostNetworkAdapter -Detailedvoor meer informatie over VLAN's en aanvullende voorbeelden die VLAN-instellingen illustreren.

Voorbeelden

Voorbeeld 1: Maak een nieuw virtueel netwerk op een hostnetwerkadapter en geef een VLAN-id op voor het virtuele netwerk

PS C:\> $VMHost = Get-SCVMHost -Computername "VMHost02.Contoso.com"
PS C:\> $HostAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost |  where {$_.Name -like "Intel(R) PRO/1000*" }
PS C:\> New-SCVirtualNetwork -Name "VirtualNetwork01" -VMHost $VMHost -VMHostNetworkAdapter $HostAdapter
PS C:\> Set-SCVMHostNetworkAdapter -VMHostNetworkAdapter $HostAdapter -VLanEnabled $True -VLanMode "Access" -VLANID 35

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 hostnetwerkadapterobject opgehaald met een naam die begint met "Intel(R) PRO/1000 op VMHost02 en slaat het object op in de $HostAdapter variabele.

Met de derde opdracht maakt u een virtueel netwerk met de naam VirtualNetwork01 op VMHost02 dat is gebonden aan de hostadapter die is opgeslagen in $HostAdapter.

Met de laatste opdracht wordt een VLAN ingeschakeld, wordt de modus ingesteld op Access (waarmee verkeer intern binnen één VLAN wordt gerouteerd) en wordt de netwerkadapter een VLANID van 35 toegewezen.

Opmerking: In dit voorbeeld wordt ervan uitgegaan dat uw host al is verbonden met een VLAN of, zo niet, 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 dat niet beschikbaar is voor de VMM-server.

Voorbeeld 2: VLan-tags toevoegen aan een hostnetwerkadapter die is geconfigureerd in de Trunk-modus

PS C:\> $VMHost = Get-SCVMHost -Computername "VMHost03.Contoso.com"
PS C:\> $VMHostNIC = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "Adapter #3"
PS C:\> $NewVlanTags = $VMHostNIC.VlanTags + @(177,355,1012)
PS C:\> Set-SCVMHostNetworkAdapter -VMHostNetworkAdapter $VMHostNIC -VLANEnabled $TRUE -VLanMode "Trunk" -VLanTrunkID $NewVLanTags

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 hostnetwerkadapterobject opgehaald door de naam van de adapter op te geven en het object op te slaan in de variabele $VMHostNIC.

De derde opdracht maakt gebruik van de eigenschap VlanTags van het hostnetwerkadapterobject ($VMHostNIC.VlanTags) en voegt een nieuwe matrix met tags samen. De bijgewerkte matrix behoudt de bestaande VlanTags en voegt de vermelde tags toe aan de matrix. Het resultaat van de samenvoeging wordt opgeslagen in $NewVlanTags.

Met de laatste opdracht wordt de nieuwe lijst met VLAN-tags doorgegeven aan de parameter VLANTrunkID van Set-VMHostNetworkAdapter. De parameter VLANMode moet de waarde Trunk opgeven wanneer de parameter VLANTrunkID wordt gebruikt om de lijst met numerieke VLAN-trunk-id's te wijzigen.

Parameters

-AddOrSetLogicalNetwork

Hiermee geeft u een logisch netwerk op dat wordt toegevoegd of bijgewerkt.

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

-AvailableForPlacement

Geeft aan of het VMM-plaatsingsproces deze host of dit volume op een host beschouwt als een mogelijke locatie waarop virtuele machines moeten worden geïmplementeerd. Als deze parameter is ingesteld op $False, kunt u ervoor kiezen om virtuele machines op deze host of dit volume toch te implementeren. De standaardwaarde is $True. Deze parameter is niet van toepassing op VMware ESX-hosts.

Wanneer deze parameter wordt gebruikt met netwerkadapters, indien ingesteld op $False, wordt bij plaatsing niet rekening gehouden met de logische netwerken die op deze netwerkadapter zijn geconfigureerd om te bepalen of de host geschikt is voor het verbinden van een virtuele machine.

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

-Description

Geeft een beschrijving voor het opgegeven object.

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

-EnableNetworkVirtualization

Hiermee geeft u op of netwerkvirtualisatie is ingeschakeld. De standaardwaarde is $False.

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

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

-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

-RemoveLogicalNetwork

Hiermee geeft u een logisch netwerk op dat wordt verwijderd.

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

-RemoveUnassignedVLan

Hiermee geeft u op dat de opgegeven VLAN's worden verwijderd uit de VLAN-trunk van de adapter als ze niet zijn gekoppeld aan een logisch netwerk.

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

-RemoveUplinkPortProfileSet

Hiermee verwijdert u de uplinkpoortprofielset van de hostnetwerkadapter.

Type:SwitchParameter
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

-SubnetVLan

Hiermee geeft u een of meer IP-subnet- en VLAN-sets.

Typ Get-Help New-SCSubNetVLanvoor informatie over het maken van een SubnetVLan.

Type:SubnetVLan[]
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:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-UsedForManagement

Hiermee wordt aangegeven of het object wordt gebruikt voor het beheren van hosts.

Type:Boolean
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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: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 Toegang 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
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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
Geaccepteerde waarden:Access, Trunk, Invalid
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Uitvoerwaarden

VMHostNetworkAdapter

Met deze cmdlet wordt een VMHostNetworkAdapter--object geretourneerd.