Dela via

Set-SCVMHostNetworkAdapter

  • Referens
Modul:
VirtualMachineManager

Ändrar nätverksrelaterade egenskaper för ett fysiskt nätverkskort på en värd som hanteras av 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

Cmdleten Set-SCVMHostNetworkAdapter ändrar nätverksrelaterade egenskaper för ett fysiskt nätverkskort på en värd som hanteras av Virtual Machine Manager (VMM).

Egenskaper som du kan ändra med den här cmdleten är:

  • VLAN-inställningar: Du kan använda VLAN-parametrarna för att skapa eller ändra ett enda VLAN eller flera VLAN. En bild av hur du anger VLAN-inställningar finns i exemplen.

Om du vill ha mer information om VLAN och ytterligare exempel som illustrerar VLAN-inställningar skriver du Get-Help Add-SCVMHostNetworkAdapter -Detailed.

Exempel

Exempel 1: Skapa ett nytt virtuellt nätverk på ett värdnätverkskort och ange ett VLAN-ID för det virtuella nätverket

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

Det första kommandot hämtar värdobjektet VMHost02 och lagrar objektet i variabeln $VMHost.

Det andra kommandot hämtar värdnätverkskortobjektet med ett namn som börjar med "Intel(R) PRO/1000 på VMHost02 och lagrar objektet i variabeln $HostAdapter.

Det tredje kommandot skapar ett virtuellt nätverk med namnet VirtualNetwork01 på VMHost02 som är bundet till värdkortet som lagras i $HostAdapter.

Det sista kommandot aktiverar ett VLAN, ställer in läget på Access (som dirigerar trafik internt inom ett enda VLAN) och tilldelar nätverkskortet ett VLANID på 35.

Obs! Det här exemplet förutsätter att värden redan är ansluten till ett VLAN eller, om inte, att värden har två nätverkskort. Om värden har ett enda nätverkskort hindrar tilldelningen av kortet till ett VLAN som inte är tillgängligt för VMM-servern VMM från att hantera värden.

Exempel 2: Lägg till VLan-taggar i ett värdnätverkskort som konfigurerats i trunkläge

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

Det första kommandot hämtar värdobjektet VMHost03 och lagrar objektet i variabeln $VMHost.

Det andra kommandot hämtar objektet värdnätverkskort genom att ange nätverkskortets namn och lagrar objektet i variabeln $VMHostNIC.

Det tredje kommandot använder egenskapen VlanTags för värdnätverkskortets objekt ($VMHostNIC.VlanTags) och sammanfogar en ny matris med taggar. Den uppdaterade matrisen behåller de befintliga VlanTags och lägger till de angivna taggarna i matrisen. Resultatet av sammanfogningen lagras i $NewVlanTags.

Det sista kommandot skickar den nya listan med VLAN-taggar till parametern VLANTrunkIDför Set-VMHostNetworkAdapter. Parametern VLANMode måste ange värdet "Trunk" när parametern VLANTrunkID används för att ändra listan över numeriska identifierare för VLAN-trunk.

Parametrar

-AddOrSetLogicalNetwork

Anger ett logiskt nätverk som ska läggas till eller uppdateras.

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

-AvailableForPlacement

Anger om VMM-placeringsprocessen anser att den här värden eller volymen på en värd är berättigad som en möjlig plats där virtuella datorer ska distribueras. Om den här parametern är inställd på $False kan du ändå välja att distribuera virtuella datorer på den här värden eller volymen. Standardvärdet är $True. Den här parametern gäller inte för VMware ESX-värdar.

Om den här parametern används med nätverkskort, om den är inställd på $False, tar placeringen inte hänsyn till de logiska nätverk som konfigurerats på det här nätverkskortet för att avgöra om värden är lämplig för att ansluta en virtuell dator.

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

-Description

Anger en beskrivning för det angivna objektet.

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

-EnableNetworkVirtualization

Anger om nätverksvirtualisering är aktiverat. Standardvärdet är $False.

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

-JobGroup

Anger en identifierare för en serie kommandon som ska köras som en uppsättning precis innan det slutliga kommandot som innehåller samma jobbgruppsidentifierare körs.

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

-JobVariable

Anger att jobbstatus spåras och lagras i variabeln som heter av den här parametern.

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

-PROTipID

Anger ID för tipset prestanda- och resursoptimering (PRO-tips) som utlöste den här åtgärden. Med den här parametern kan du granska PRO-tips.

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

-RemoveLogicalNetwork

Anger ett logiskt nätverk som ska tas bort.

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

-RemoveUnassignedVLan

Anger att de angivna VLAN:erna ska tas bort från VLAN-trunken för kortet om de inte är associerade med ett logiskt nätverk.

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

-RemoveUplinkPortProfileSet

Tar bort portprofiluppsättningen för överordnad länk från värdnätverkskortet.

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

-RunAsynchronously

Anger att jobbet körs asynkront så att kontrollen återgår till kommandogränssnittet omedelbart.

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

-SubnetVLan

Anger ett eller flera IP-undernät och VLAN-uppsättningar.

Om du vill ha information om hur du skapar ett SubnetVLan skriver du Get-Help New-SCSubNetVLan.

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

-UplinkPortProfileSet

Anger ett portprofiluppsättningsobjekt för överordnad länk.

Om du vill hämta ett portprofiluppsättningsobjekt för överordnad länk använder du cmdleten Get-SCUplinkPortProfileSet .

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

-UsedForManagement

Anger om objektet används för att hantera värdar.

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

-VLanEnabled

Aktiverar ett virtuellt LAN (VLAN) för användning av virtuella datorer på en Hyper-V- eller Citrix XenServer-värd.

  • Exempelformat för ett enda VLAN: -VLANEnabled -VLANMode "Access" -VLANID 35
  • Exempelformat för flera VLAN: -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

Tilldelar en numerisk identifierare i intervallet 1–4094 till ett virtuellt nätverkskort på en virtuell dator eller till ett fysiskt nätverkskort på en virtuell datorvärd.

Konfigurera ett VLanID på en Hyper-V-, VMware ESX- eller Citrix XenServer-värd:

  • På ett externt bundet fysiskt nätverkskort när VLan-läget är Access.

Konfigurera ett VLanID på ett virtuellt nätverkskort för en virtuell dator:

  • Bunden till ett fysiskt nätverkskort på värden, eller
  • Bunden till ett internt virtuellt nätverk på värden.

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

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

-VLanMode

Anger om ett virtuellt LAN (VLAN) på en virtuell datorvärd stöder trafik över ett enda VLAN (åtkomstläge) eller över flera VLAN (trunkläge). Giltiga värden är: 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

Tilldelar en lista över numeriska identifierare i intervallet 1–4094 till ett fysiskt nätverkskort på en Hyper-V-värd.

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

Anger ett fysiskt nätverkskortsobjekt på en värd som virtuella datorer som distribueras på värden kan ansluta till.

Exempelformat: -VMHostNetworkAdapter $VMHostNIC

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

Utdata

VMHostNetworkAdapter

Den här cmdleten returnerar ett VMHostNetworkAdapter-objekt .