Freigeben über

Add-SCVMHostNetworkAdapter

  • Referenz
Modul:
VirtualMachineManager

Fügt einem von VMM verwalteten Host einen physischen Netzwerkadapter zu einem virtuellen Netzwerk hinzu.

Syntax

Add-SCVMHostNetworkAdapter
   -VirtualNetwork <VirtualNetwork>
   [-VLanEnabled]
   [-VLanMode <VlanMode>]
   [-VLanID <UInt16>]
   [-VLanTrunkID <UInt16[]>]
   [-VMHostNetworkAdapter] <HostNetworkAdapter>
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Beschreibung

Das Add-SCVMHostNetworkAdapter-Cmdlet fügt einem virtuellen Netzwerk einen physischen Netzwerkadapter (auch als Netzwerkschnittstellenkarte oder NIC bezeichnet) auf einem Host hinzu, der von Virtual Machine Manager (VMM) verwaltet wird. Jeder virtuelle Computer auf diesem Host kann auch eine Verbindung über einen virtuellen Netzwerkadapter mit diesem virtuellen Netzwerk herstellen.

Ein auf einem Host konfiguriertes virtuelles Netzwerk kann Verbindungen mit mehreren virtuellen Netzwerkadaptern auf virtuellen Maschinen herstellen, die auf diesem Host bereitgestellt werden.

VMM für System Center 2019 umfasst die Unterstützung für virtuelle Netzwerke zum Konfigurieren eines oder mehrerer virtual Local Area Networks (VLANs) auf einem Host. Sie können das Cmdlet "Add-SCVMHostNetworkAdapter " oder das Cmdlet "Set-SCVMHostNetworkAdapter " verwenden, um ein einzelnes VLAN oder mehrere VLANs auf einem Host zu konfigurieren. Verwenden Sie zum Konfigurieren entsprechender VLAN-Einstellungen auf einem virtuellen Computer das Cmdlet New-SCVirtualNetworkAdapter oder das Cmdlet Set-SCVirtualNetworkAdapter .

Eine Darstellung der einzelnen VLAN-Typen finden Sie in den Beispielen für dieses Cmdlet.

Beispiele

Beispiel 1: Hinzufügen eines physischen Hostnetzwerkadapters zu einem virtuellen Netzwerk

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01.Contoso.com"
PS C:\> $VirtualNetwork = Get-SCVirtualNetwork -VMHost $VMHost -Name "ExternalVirtualNetwork01"
PS C:\> $VMHostNetworkAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "HostAdapter01"
PS C:\> Add-SCVMHostNetworkAdapter -VirtualNetwork $VirtualNetwork -VMHostNetworkAdapter $VMHostNetworkAdapter

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

Der zweite Befehl ruft das virtuelle Netzwerkobjekt mit dem Namen ExternalVirtualNetwork01 auf VMHost01 ab und speichert das Objekt in der $VirtualNetwork Variablen.

Der dritte Befehl ruft das physische Netzwerkadapterobjekt namens HostAdapter01 auf VMHost01 ab und speichert das Objekt in der $VMHostNetworkAdapter Variablen.

Der letzte Befehl fügt HostAdapter01 zu ExternalVirtualNetwork01 hinzu.

Hinweis: Sie können nur einen physischen Hostadapter pro virtuelles Netzwerk hinzufügen. Daher schlägt der letzte Befehl fehl, wenn ein Adapter bereits dem angegebenen virtuellen Netzwerk zugeordnet ist. Um dem virtuellen Netzwerk einen neuen Adapter hinzuzufügen, müssen Sie zuerst den vorhandenen Hostadapter entfernen.

Beispiel 2: Hinzufügen eines physischen Hostnetzwerkadapters zu einem VLAN, das den Trunkmodus verwendet

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost02"
PS C:\> $VirtualNetwork = Get-SCVirtualNetwork -VMHost $VMHost -Name "ExternalNetwork02"
PS C:\> $VMHostNetworkAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "HostAdapter02"
PS C:\> Add-SCVMHostNetworkAdapter -VirtualNetwork $VirtualNetwork -VMHostNetworkAdapter $VMHostNetworkAdapter -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124

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

Der zweite Befehl ruft das virtuelle Netzwerkobjekt "ExternalNetwork02" auf VMHost02 ab und speichert das Objekt in der $VirtualNetwork Variablen.

Der dritte Befehl ruft das Netzwerkadapterobjekt namens HostAdapter02 auf VMHost02 ab und speichert das Adapterobjekt in der $VMHostNetworkAdapter Variablen.

Der letzte Befehl fügt HostAdapter02 zu virtual network ExternalNetwork02 hinzu und ermöglicht den Zugriff von ExternalNetwork02 auf ein externes Netzwerkgerät mithilfe von 802.1Q mit dem Stichwort VLANs 1, 2, 100, 200 und 1124.

Hinweis: Sie können nur einen Hostadapter pro virtuelles Netzwerk hinzufügen, sodass der letzte Befehl fehlschlägt, wenn ein Adapter bereits dem angegebenen virtuellen Netzwerk zugeordnet ist.

Beispiel 3: Hinzufügen eines physischen Hostnetzwerkadapters zu einem VLAN, das den Modus "Access" verwendet

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost03.Contoso.com"
PS C:\> $VirtualNetwork = Get-SCVirtualNetwork -VMHost $VMHost -Name "ExternalVirtualNetwork03"
PS C:\> $VMHostNetworkAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "HostAdapter03"
PS C:\> Add-SCVMHostNetworkAdapter -VirtualNetwork $VirtualNetwork -VMHostNetworkAdapter $VMHostNetworkAdapter -VLanEnabled -VLanMode "Access" -VLanID 22

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

Der zweite Befehl ruft das virtuelle Netzwerkobjekt mit dem Namen ExternalNetwork03 auf VMHost03 ab und speichert das Objekt in der $VirtualNetwork Variablen.

Der dritte Befehl ruft das Netzwerkadapterobjekt "HostAdapter03" auf VMHost03 ab und speichert das Adapterobjekt in der Variablen $VMHostNetworkAdapter.

Der letzte Befehl fügt HostAdapter03 zu virtual network ExternalNetwork03 hinzu und beschränkt den Zugriff auf ExternalNetwork03 auf VLANID 22.

Hinweis: Sie können nur einen Hostadapter pro virtuelles Netzwerk hinzufügen, sodass der letzte Befehl fehlschlägt, wenn ein Adapter bereits dem angegebenen virtuellen Netzwerk zugeordnet ist.

Vorsicht: In diesem Beispiel wird davon ausgegangen, dass Ihr Host bereits mit einem VLAN verbunden ist oder wenn nicht, sicherstellen, 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. Sie können die Schritte in diesem Beispiel auf einem Host mit nur einem Netzwerkadapter ausführen, wenn Sie zuerst den Microsoft Loopbackadapter auf dem Server installieren.

Parameter

-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

-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

-VirtualNetwork

Gibt ein virtuelles Netzwerkobjekt an.

Type:VirtualNetwork
Position:Named
Default value:None
Required:True
Accept pipeline input:True
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: Beispielformat für mehrere VLANs: -VLANEnabled -VLANMode "Access" -VLANID 35-VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124

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