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 Set-SCVMHostNetworkAdapter Cmdlet ändert netzwerkbezogene Eigenschaften für einen physischen Netzwerkadapter auf einem Host, der von Virtual Machine Manager (VMM) verwaltet wird.

Zu den Eigenschaften, die Sie mit diesem Cmdlet ändern können, gehören:

  • 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 zusätzlichen Beispielen, die VLAN-Einstellungen veranschaulichen, geben Sie Get-Help Add-SCVMHostNetworkAdapter -Detailedein.

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 mit dem Namen VMHost02 ab und speichert das Objekt in der variablen $VMHost.

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 hostadapter gebunden ist, der in $HostAdapter gespeichert ist.

Der letzte Befehl aktiviert ein VLAN, legt den Modus auf Access fest (der Datenverkehr intern innerhalb eines einzelnen VLAN 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 über zwei Netzwerkadapter verfügt. Wenn Ihr Host über einen einzelnen Netzwerkadapter verfügt, verhindert das Zuweisen des Adapters zu einem VLAN, das für den VMM-Server nicht verfügbar ist, die Verwaltung des Hosts durch VMM.

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 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 parameter VLANMode muss den Wert "Trunk" angeben, wenn der VLANTrunkID Parameter verwendet wird, um die Liste der numerischen VLAN-Trunk-IDs zu ändern.

Parameter

-AddOrSetLogicalNetwork

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

Typ:LogicalNetwork
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AvailableForPlacement

Gibt an, ob der VMM-Platzierungsprozess diesen Host oder dieses Volume auf einem Host als einen möglichen Speicherort betrachtet, an dem virtuelle Computer bereitgestellt werden sollen. Wenn dieser Parameter auf $False festgelegt ist, können Sie festlegen, dass virtuelle Computer auf diesem Host oder Volume trotzdem bereitgestellt werden sollen. Der Standardwert ist $True. Dieser Parameter gilt nicht für VMware ESX-Hosts.

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

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Description

Gibt eine Beschreibung für das angegebene Objekt an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableNetworkVirtualization

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

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-JobGroup

Gibt einen Bezeichner für eine Reihe von Befehlen an, die direkt vor dem endgültigen Befehl ausgeführt werden, der denselben Auftragsgruppenbezeichner enthält.

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-JobVariable

Gibt an, dass der Auftragsfortschritt nachverfolgt und in der Variablen gespeichert wird, die von diesem Parameter benannt wird.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RemoveLogicalNetwork

Gibt ein logisches Netzwerk an, das entfernt wird.

Typ:LogicalNetwork
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RemoveUnassignedVLan

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

Typ:UInt16[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RemoveUplinkPortProfileSet

Entfernt den Uplink-Portprofilsatz aus dem Hostnetzwerkadapter.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RunAsynchronously

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SubnetVLan

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

Geben Sie Get-Help New-SCSubNetVLanein, um Informationen zum Erstellen eines SubnetVLan zu erstellen.

Typ:SubnetVLan[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UplinkPortProfileSet

Gibt ein Uplink-Portprofilsatzobjekt an.

Um ein Uplink-Portprofilsatzobjekt abzurufen, verwenden Sie das Cmdlet Get-SCUplinkPortProfileSet.

Typ:UplinkPortProfileSet
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UsedForManagement

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

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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
Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VLanID

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

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

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

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

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

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

Typ:UInt16
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VLanMode

Gibt an, ob ein virtuelles LAN (VLAN) auf einem virtuellen Computerhost Datenverkehr über einen einzelnen VLAN (Zugriffsmodus) oder über mehrere VLANs (Trunkmodus) unterstützt. Gültige Werte sind: Access, Trunk.

Typ:VlanMode
Zulässige Werte:Access, Trunk, Invalid
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VLanTrunkID

Weist eine Liste numerischer Bezeichner im Bereich 1-4094 einem physischen Netzwerkadapter auf einem Hyper-V-Host zu.

Beispielformat: -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124

Typ:UInt16[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VMHostNetworkAdapter

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

Beispielformat: -VMHostNetworkAdapter $VMHostNIC

Typ:HostNetworkAdapter
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Ausgaben

VMHostNetworkAdapter

Dieses Cmdlet gibt ein VMHostNetworkAdapter-Objekt zurück.