Freigeben über

New-SCLogicalSwitchVirtualNetworkAdapter

Modul:
VirtualMachineManager Module

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

Syntax

Default (Standardwert) 

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 dem Uplinkportprofil als Teil der Definition des logischen Switches einen virtuellen Netzwerkadapter (VNIC) für den Host hinzu.

Beispiele

Beispiel 1: Erstellen eines neuen virtuellen Netzwerkadapters für logische Switches

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"

Mit dem ersten Befehl wird ein Uplinkportprofil abgerufen, das mit dem Cmdlet Get-SCUplinkPortProfileSet festgelegt wurde, und dann in der Variablen $UPPSet gespeichert.

Mit dem zweiten Befehl wird das Netzwerk des virtuellen Computers mit dem Namen "MgmtNet" mithilfe des Cmdlets "Get-SCVMNetwork " abgerufen und dann in der Variablen $VmNetwork gespeichert.

Mit dem letzten Befehl wird ein virtueller Netzwerkadapter für logische Switches erstellt, der zusammen mit dem logischen Switch auf dem Host bereitgestellt wird.

Parameter

-Description

Gibt eine Beschreibung für den virtuellen Netzwerkadapter an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:1
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-EthernetAddressType

Gibt einen Ethernet-Adresstyp an. Die zulässigen Werte für diesen Parameter sind:

  • Dynamisch
  • Statisch

Parametereigenschaften

Typ:EthernetAddressType
Standardwert:None
Zulässige Werte:Dynamic, Static
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-InheritsAddressFromPhysicalNetworkAdapter

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

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-IPv4AddressPool

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

Parametereigenschaften

Typ:StaticIPAddressPool
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-IPv4AddressType

Gibt einen IPv4-Adresstyp an. Die zulässigen Werte für diesen Parameter sind:

  • Dynamisch
  • Statisch

Parametereigenschaften

Typ:EthernetAddressType
Standardwert:None
Zulässige Werte:Dynamic, Static
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-IPv6AddressPool

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

Parametereigenschaften

Typ:StaticIPAddressPool
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-IPv6AddressType

Gibt einen IPv6-Adresstyp an. Die zulässigen Werte für diesen Parameter sind:

  • Dynamisch
  • Statisch

Parametereigenschaften

Typ:EthernetAddressType
Standardwert:None
Zulässige Werte:Dynamic, Static
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-IsUsedForHostManagement

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

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-JobVariable

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Name

Gibt den Namen des Netzwerkadapters an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:0
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PortClassification

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

Parametereigenschaften

Typ:PortClassification
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:Guid
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-RunAsynchronously

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-UplinkPortProfileSet

Gibt ein Set-Objekt für das Uplink-Portprofil an.

Verwenden Sie das Cmdlet Get-SCUplinkPortProfileSet , um ein Uplinkportprofilsatzobjekt abzurufen.

Parametereigenschaften

Typ:UplinkPortProfileSet
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VLanEnabled

Gibt an, ob ein virtuelles LAN (VLAN) für die Verwendung durch virtuelle Maschinen 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

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VLanID

Weist einem virtuellen Netzwerkadapter auf einem virtuellen Computer oder einem physischen Netzwerkadapter auf einem Host eines virtuellen Computers einen numerischen Bezeichner im Bereich von 1 bis 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, der an einen physischen Netzwerkadapter auf dem Host oder an ein internes virtuelles Netzwerk auf dem Host gebunden ist.

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

Parametereigenschaften

Typ:UInt16
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VMMServer

Gibt ein VMM-Serverobjekt an.

Parametereigenschaften

Typ:ServerConnection
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VMNetwork

Gibt ein VM-Netzwerkobjekt an.

Verwenden Sie zum Abrufen eines VM-Netzwerkobjekts das Cmdlet Get-SCVMNetwork .

Parametereigenschaften

Typ:VMNetwork
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VMSubnet

Gibt ein Subnetzobjekt für einen virtuellen Computer an.

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

Parametereigenschaften

Typ:VMSubnet
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.