Freigeben über

New-SCLogicalSwitchVirtualNetworkAdapter

  • Referenz
Modul:
VirtualMachineManager

Fügt einem logischen Switch einen virtuellen Netzwerkadapter (VNIC) hinzu.

Syntax

New-SCLogicalSwitchVirtualNetworkAdapter
   -UplinkPortProfileSet <UplinkPortProfileSet>
   [-EthernetAddressType <EthernetAddressType>]
   [-IPv4AddressType <EthernetAddressType>]
   [-IPv6AddressType <EthernetAddressType>]
   [-VMNetwork <VMNetwork>]
   [-VMSubnet <VMSubnet>]
   [-PortClassification <PortClassification>]
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-IPv4AddressPool <StaticIPAddressPool>]
   [-IPv6AddressPool <StaticIPAddressPool>]
   [-InheritsAddressFromPhysicalNetworkAdapter <Boolean>]
   [-IsUsedForHostManagement <Boolean>]
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [[-Description] <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet New-SCLogicalSwitchVirtualNetworkAdapter fügt einen virtuellen Netzwerkadapter (VNIC) für den Host zum Uplink-Portprofil als Teil der logischen Switchdefinition hinzu.

Beispiele

Beispiel 1: Erstellt einen neuen virtuellen Switch für virtuelle Netzwerkadapter

PS C:\> $UPPSet = Get-SCUplinkPortProfileSet -Name "R1Uplink"
PS C:\> $VmNetwork = Get-SCVMNetwork -Name "MgmtNet"
PS C:\> New-SCLogicalSwitchVirtualNetworkAdapter -Name "LogSw01_Storage" -UplinkPortProfileSet $uppSetVar -RunAsynchronously -VMNetwork $vmNetwork -VLanEnabled $true -VLanID 2162 -IsUsedForHostManagement $false -IPv4AddressType "Dynamic" -IPv6AddressType "Dynamic"

Der erste Befehl ruft ein uplink-Portprofil mithilfe des Cmdlets Get-SCUplinkPortProfileSet ab und speichert es dann in der $UPPSet Variablen.

Der zweite Befehl ruft das virtuelle Computernetzwerk mit dem Namen MgmtNet mithilfe des Cmdlets Get-SCVMNetwork ab und speichert es dann in der $VmNetwork Variablen.

Der letzte Befehl erstellt einen virtuellen Switch-Adapter, der zusammen mit dem logischen Switch auf dem Host bereitgestellt wird.

Parameter

-Description

Gibt eine Beschreibung für den virtuellen Netzwerkadapter an.

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

-EthernetAddressType

Gibt einen Ethernet-Adresstyp an. Zulässige Werte für diesen Parameter:

  • Dynamisch
  • statischen
Type:EthernetAddressType
Accepted values:Dynamic, Static
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InheritsAddressFromPhysicalNetworkAdapter

Gibt an, ob der Netzwerkadapter seine Adresse von einem physischen Netzwerkadapter erbt.

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

-IPv4AddressPool

Gibt einen statischen Adresspool an, der IPv4-Adressen enthält.

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

-IPv4AddressType

Gibt einen IPv4-Adresstyp an. Zulässige Werte für diesen Parameter:

  • Dynamisch
  • statischen
Type:EthernetAddressType
Accepted values:Dynamic, Static
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IPv6AddressPool

Gibt einen statischen Adresspool an, der IPv6-Adressen enthält.

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

-IPv6AddressType

Gibt einen IPv6-Adresstyp an. Zulässige Werte für diesen Parameter:

  • Dynamisch
  • statischen
Type:EthernetAddressType
Accepted values:Dynamic, Static
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IsUsedForHostManagement

Gibt an, ob der virtuelle Netzwerkadapter für die Hostverwaltung verwendet wird.

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

-Name

Gibt den Namen des Netzwerkadapters an.

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

-PortClassification

Gibt die Portklassifizierung des Switchs an, mit dem der virtuelle Netzwerkadapter eine Verbindung herstellt.

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

-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:True
Accept pipeline input:True
Accept wildcard characters:False

-VLanEnabled

Gibt an, ob ein virtuelles LAN (VLAN) für die Verwendung durch virtuelle Computer auf einem Hyper-V- oder Citrix XenServer-Host aktiviert werden soll.

  • 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 auf einem extern gebundenen physischen Netzwerkadapter, wenn der VLan-Modus Access ist.

Konfigurieren Sie eine VLanID auf einem virtuellen Netzwerkadapter eines virtuellen Computers, der an einen physischen Netzwerkadapter auf dem Host gebunden ist oder an ein internes virtuelles Netzwerk auf dem Host gebunden ist.

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

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

-VMMServer

Gibt ein VMM-Serverobjekt an.

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

-VMNetwork

Gibt ein VM-Netzwerkobjekt an.

Um ein VM-Netzwerkobjekt abzurufen, verwenden Sie das Cmdlet Get-SCVMNetwork .

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

-VMSubnet

Gibt ein Subnetzobjekt eines virtuellen Computers an.

Verwenden Sie zum Abrufen eines VMSubnet-Objekts das Cmdlet Get-SCVMSubnet .

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