Freigeben über

Set-SCVMHostNetworkAdapter

  • Referenz
Modul:
VirtualMachineManager

Ändert netzwerkbezogene Eigenschaften für einen physischen Netzwerkadapter auf einem von VMM verwalteten Host.

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

Beschreibung

Das Cmdlet Set-SCVMHostNetworkAdapter ändert netzwerkbezogene Eigenschaften für einen physischen Netzwerkadapter auf einem Host, der von Virtual Machine Manager (VMM) verwaltet wird.

Folgende Eigenschaften können Sie mit diesem Cmdlet ändern:

  • VLAN-Einstellungen: Sie können die VLAN-Parameter verwenden, um ein einzelnes VLAN oder mehrere VLANs zu erstellen oder zu ändern. Eine Abbildung der Angabe von VLAN-Einstellungen finden Sie in den Beispielen.

Weitere Informationen zu VLANs und weiteren Beispielen, die VLAN-Einstellungen veranschaulichen, geben Sie den Typ Get-Help Add-SCVMHostNetworkAdapter -Detailed.

Beispiele

Beispiel 1: Erstellen eines neuen virtuellen Netzwerks auf einem Hostnetzwerkadapter und Angeben einer VLAN-ID für das virtuelle Netzwerk

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

Der erste Befehl ruft das Hostobjekt namens VMHost02 ab und speichert das Objekt in der $VMHost Variablen.

Der zweite Befehl ruft das Hostnetzwerkadapterobjekt mit einem Namen ab, der mit "Intel(R) PRO/1000 auf VMHost02 beginnt und das Objekt in der $HostAdapter Variablen speichert.

Der dritte Befehl erstellt ein virtuelles Netzwerk namens VirtualNetwork01 auf VMHost02, das an den in $HostAdapter gespeicherten Hostadapter gebunden ist.

Der letzte Befehl aktiviert ein VLAN, legt den Modus auf Access fest (der Datenverkehr intern innerhalb eines einzelnen VLANs leitet) und weist dem Netzwerkadapter eine VLANID von 35 zu.

Hinweis: In diesem Beispiel wird davon ausgegangen, dass Ihr Host bereits mit einem VLAN verbunden ist oder wenn nicht, dass Ihr Host zwei Netzwerkadapter aufweist. Wenn Ihr Host über einen einzelnen Netzwerkadapter verfügt, wird durch Zuweisen des Adapters zu einem VLAN, das nicht für den VMM-Server verfügbar ist, verhindert, dass VMM den Host verwaltet.

Beispiel 2: Hinzufügen von VLan-Tags zu einem Hostnetzwerkadapter, der im Trunkmodus konfiguriert ist

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

Der erste Befehl ruft das Hostobjekt mit dem Namen VMHost03 ab und speichert das Objekt in der $VMHost Variablen.

Der zweite Befehl ruft das Hostnetzwerkadapterobjekt ab, indem er den Adapternamen angibt und das Objekt in der $VMHostNIC Variablen speichert.

Der dritte Befehl verwendet die VlanTags-Eigenschaft des Hostnetzwerkadapterobjekts ($VMHostNIC.VlanTags) und verkettet ein neues Array von Tags. Das aktualisierte Array behält die exisiting VlanTags bei und fügt die aufgelisteten Tags dem Array hinzu. Das Ergebnis der Verkettung wird in $NewVlanTags gespeichert.

Der letzte Befehl übergibt die neue Liste der VLAN-Tags an den VLANTrunkID-Parameter von Set-VMHostNetworkAdapter. Der VLANMode-Parameter muss den Wert "Trunk" angeben, wenn der VLANTrunkID-Parameter verwendet wird, um die Liste der numerischen VLAN-Trunkbezeichner zu ändern.

Parameter

-AddOrSetLogicalNetwork

Gibt ein logisches Netzwerk an, das hinzugefügt oder aktualisiert wird.

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

-AvailableForPlacement

Gibt an, ob der VMM-Platzierungsprozess diesen Host oder dieses Volume auf einem Host als möglicher Ort für die Bereitstellung virtueller Computer betrachtet. Wenn dieser Parameter auf $False festgelegt ist, können Sie trotzdem virtuelle Computer auf diesem Host oder Volume bereitstellen. Der Standardwert ist $True. Dieser Parameter gilt nicht für VMware ESX-Hosts.

Wenn dieser Parameter mit Netzwerkadaptern verwendet wird, wenn er auf $False festgelegt ist, berücksichtigt die Platzierung nicht die logischen Netzwerke, die auf diesem Netzwerkadapter konfiguriert sind, um festzustellen, ob der Host für die Verbindung eines virtuellen Computers geeignet ist.

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

-Description

Gibt eine Beschreibung für das angegebene Objekt an.

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

-EnableNetworkVirtualization

Gibt an, ob die Netzwerkvirtualisierung aktiviert ist. Der Standardwert ist $False.

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

-JobGroup

Gibt einen Bezeichner für eine Reihe von Befehlen an, die als Satz unmittelbar vor dem letzten Befehl, der den gleichen Auftragsgruppenbezeichner enthält, ausgeführt werden.

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

-JobVariable

Gibt an, dass der Status des Auftrags überwacht und in der von diesem Parameter benannten Variablen gespeichert wird.

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

-PROTipID

Gibt die ID des Tipps zur Leistungs- und Ressourcenoptimierung (PRO-Tipp) an, der diese Aktion ausgelöst hat. Mit diesem Parameter können Sie PRO-Tipps überwachen.

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

-RemoveLogicalNetwork

Gibt ein logisches Netzwerk an, das entfernt wird.

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

-RemoveUnassignedVLan

Gibt an, dass die angegebenen VLANs aus dem VLAN-Trunk des Adapters entfernt werden, wenn sie keinem logischen Netzwerk zugeordnet sind.

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

-RemoveUplinkPortProfileSet

Entfernt das uplink-Portprofil aus dem Hostnetzwerkadapter.

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

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.

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

-SubnetVLan

Gibt einen oder mehrere IP-Subnetz- und VLAN-Sätze an.

Informationen zum Erstellen eines SubnetVLan-Typs Get-Help New-SCSubNetVLan.

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

-UplinkPortProfileSet

Gibt ein Uplink-Portprofilsatzobjekt an.

Verwenden Sie das Cmdlet Get-SCUplinkPortProfileSet , um ein Uplink-Portprofil-Set-Objekt abzurufen.

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

-UsedForManagement

Gibt an, ob das Objekt zum Verwalten von Hosts verwendet wird.

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

-VLanEnabled

Aktiviert ein virtuelles LAN (VLAN) für die Verwendung durch virtuelle Computer auf einem Hyper-V- oder Citrix XenServer-Host.

  • Beispielformat für ein einzelnes VLAN: -VLANEnabled -VLANMode "Access" -VLANID 35
  • Beispielformat für mehrere VLANs: -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

Weist einen numerischen Bezeichner im Bereich 1-4094 einem virtuellen Netzwerkadapter auf einem virtuellen Computer oder einem physischen Netzwerkadapter auf einem virtuellen Computerhost zu.

Konfigurieren Sie eine VLanID auf einem Hyper-V-, VMware ESX- oder Citrix XenServer-Host:

  • Bei einem extern gebundenen physischen Netzwerkadapter, wenn der VLan-Modus Access ist.

Konfigurieren sie eine VLanID auf einem virtuellen Netzwerkadapter eines virtuellen Computers:

  • Gebunden an einen physischen Netzwerkadapter auf dem Host oder
  • Gebunden an ein internes virtuelles Netzwerk auf dem Host.

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

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

-VLanMode

Gibt an, ob ein virtuelles LAN (VLAN) auf einem virtuellen Computerhost Datenverkehr über einen einzelnen VLAN (Access-Modus) oder über mehrere VLANs (Trunkmodus) hinweg unterstützt. Gültige Werte sind: 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

Weist einem physischen Netzwerkadapter auf einem Hyper-V-Host eine Liste mit numerischen Bezeichnern im Bereich 1 - 4094 zu.

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

Gibt ein physisches Netzwerkadapterobjekt auf einem Host an, mit dem virtuelle Computer, die auf diesem Host bereitgestellt werden, eine Verbindung herstellen kann.

Beispielformat: -VMHostNetworkAdapter $VMHostNIC

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

Ausgaben

VMHostNetworkAdapter

Dieses Cmdlet gibt ein VMHostNetworkAdapter -Objekt zurück.