Delen via

Set-SCVMHostNetworkAdapter

  • Referentie
Module:
VirtualMachineManager

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

Syntax

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 cmdlet Set-SCVMHostNetworkAdapter 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.

Voor meer informatie over VLAN's en aanvullende voorbeelden die VLAN-instellingen illustreren, typt Get-Help Add-SCVMHostNetworkAdapter -Detailedu .

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 het object opslaat 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, indien niet, 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.

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

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 id's van VLAN trunk te wijzigen.

Parameters

-AddOrSetLogicalNetwork

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

Type:LogicalNetwork
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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, als deze is 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Geeft een beschrijving weer voor het opgegeven object.

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

-EnableNetworkVirtualization

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

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

-RemoveLogicalNetwork

Hiermee geeft u een logisch netwerk op dat wordt verwijderd.

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

-RemoveUplinkPortProfileSet

Hiermee verwijdert u de uplinkpoortprofielset van de hostnetwerkadapter.

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

-SubnetVLan

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

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

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

-UplinkPortProfileSet

Hiermee geeft u een uplinkpoortprofiel ingesteld object.

Gebruik de cmdlet Get-SCUplinkPortProfileSet om een uplinkpoortprofielsetobject te verkrijgen.

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

-UsedForManagement

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

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

Configureer een VLanID 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 virtuele-machinehost 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 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

Deze cmdlet retourneert een VMHostNetworkAdapter-object .