Freigeben über

New-SCVirtualNetworkAdapter

  • Referenz
Modul:
VirtualMachineManager

Erstellt einen virtuellen Netzwerkadapter auf einem virtuellen Computer, einer Virtuellen Computervorlage oder einem Hardwareprofil, das in VMM verwendet wird.

Syntax

New-SCVirtualNetworkAdapter
   [-IPv4AddressType <EthernetAddressType>]
   [-IPv6AddressType <EthernetAddressType>]
   [-EnableMACAddressSpoofing <Boolean>]
   [-EnableGuestIPNetworkVirtualizationUpdates <Boolean>]
   [-EnableVMNetworkOptimization <Boolean>]
   [-VMNetwork <VMNetwork>]
   [-PortClassification <PortClassification>]
   [-VMSubnet <VMSubnet>]
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-AdapterFlags <VirtualNetworkAdapterFlags>]
   -VM <VM>
   [[-VirtualNetwork] <String>]
   [-MACAddress <String>]
   [-MACAddressType <String>]
   [-NoConnection]
   [-Synthetic]
   [-LogicalNetwork <LogicalNetwork>]
   [-NoVMNetwork]
   [-VMwarePortGroup <String>]
   [-NetworkLocation <String>]
   [-NetworkTag <String>]
   [-PortACL <PortACL>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVirtualNetworkAdapter
   [-VMMServer <ServerConnection>]
   [-IPv4AddressType <EthernetAddressType>]
   [-IPv6AddressType <EthernetAddressType>]
   [-EnableMACAddressSpoofing <Boolean>]
   [-EnableGuestIPNetworkVirtualizationUpdates <Boolean>]
   [-EnableVMNetworkOptimization <Boolean>]
   [-VMNetwork <VMNetwork>]
   [-PortClassification <PortClassification>]
   [-VMSubnet <VMSubnet>]
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-DevicePropertiesAdapterNameMode <DevicePropertiesAdapterNameMode>]
   [-AdapterFlags <VirtualNetworkAdapterFlags>]
   [-VMHost <Host>]
   [-LogicalSwitch <LogicalSwitch>]
   -JobGroup <Guid>
   [[-VirtualNetwork] <String>]
   [-MACAddress <String>]
   [-MACAddressType <String>]
   [-NoConnection]
   [-Synthetic]
   [-LogicalNetwork <LogicalNetwork>]
   [-VMNetworkServiceSetting <String>]
   [-NoVMNetwork]
   [-VMwarePortGroup <String>]
   [-NetworkLocation <String>]
   [-NetworkTag <String>]
   [-DevicePropertiesAdapterName <String>]
   [-PortACL <PortACL>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVirtualNetworkAdapter
   [-IPv4AddressType <EthernetAddressType>]
   [-IPv6AddressType <EthernetAddressType>]
   [-EnableMACAddressSpoofing <Boolean>]
   [-EnableGuestIPNetworkVirtualizationUpdates <Boolean>]
   [-EnableVMNetworkOptimization <Boolean>]
   [-VMNetwork <VMNetwork>]
   [-PortClassification <PortClassification>]
   [-VMSubnet <VMSubnet>]
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-DevicePropertiesAdapterNameMode <DevicePropertiesAdapterNameMode>]
   [-AdapterFlags <VirtualNetworkAdapterFlags>]
   -VMTemplate <Template>
   [[-VirtualNetwork] <String>]
   [-MACAddress <String>]
   [-MACAddressType <String>]
   [-NoConnection]
   [-Synthetic]
   [-LogicalNetwork <LogicalNetwork>]
   [-VMNetworkServiceSetting <String>]
   [-NoVMNetwork]
   [-VMwarePortGroup <String>]
   [-NetworkLocation <String>]
   [-NetworkTag <String>]
   [-DevicePropertiesAdapterName <String>]
   [-PortACL <PortACL>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVirtualNetworkAdapter
   [-IPv4AddressType <EthernetAddressType>]
   [-IPv6AddressType <EthernetAddressType>]
   [-EnableMACAddressSpoofing <Boolean>]
   [-EnableGuestIPNetworkVirtualizationUpdates <Boolean>]
   [-EnableVMNetworkOptimization <Boolean>]
   [-VMNetwork <VMNetwork>]
   [-PortClassification <PortClassification>]
   [-VMSubnet <VMSubnet>]
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-DevicePropertiesAdapterNameMode <DevicePropertiesAdapterNameMode>]
   [-AdapterFlags <VirtualNetworkAdapterFlags>]
   -HardwareProfile <HardwareProfile>
   [[-VirtualNetwork] <String>]
   [-MACAddress <String>]
   [-MACAddressType <String>]
   [-NoConnection]
   [-Synthetic]
   [-LogicalNetwork <LogicalNetwork>]
   [-VMNetworkServiceSetting <String>]
   [-NoVMNetwork]
   [-VMwarePortGroup <String>]
   [-NetworkLocation <String>]
   [-NetworkTag <String>]
   [-DevicePropertiesAdapterName <String>]
   [-PortACL <PortACL>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVirtualNetworkAdapter
   [-IPv4AddressType <EthernetAddressType>]
   [-IPv6AddressType <EthernetAddressType>]
   [-VMNetwork <VMNetwork>]
   [-PortClassification <PortClassification>]
   [-VMSubnet <VMSubnet>]
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-IPv4AddressPool <StaticIPAddressPool>]
   [-IPv6AddressPool <StaticIPAddressPool>]
   [-InheritsAddressFromPhysicalNetworkAdapter <Boolean>]
   -VMHost <Host>
   -LogicalSwitch <LogicalSwitch>
   [-JobGroup <Guid>]
   [-Name <String>]
   [-MACAddress <String>]
   [-MACAddressType <String>]
   [-IPv4Address <String>]
   [-IPv6Address <String>]
   [-PortACL <PortACL>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet New-SCVirtualNetworkAdapter erstellt einen virtuellen Netzwerkadapter auf einem virtuellen Computer, einer Virtuellen Computervorlage oder einem Hardwareprofil, mit dem virtuelle Computer erstellt werden, die vom Virtual Machine Manager (VMM) verwaltet werden.

Netzwerkspeicherort

Sie können das Cmdlet New-SCVirtualNetworkAdapter verwenden, um einen Netzwerkspeicherort anzugeben und den virtuellen Netzwerkadapter mit einem virtuellen Netzwerk zu verbinden, das auf dem Host konfiguriert ist, wenn Sie den Adapter erstellen, oder Sie können diese und andere Einstellungen später mithilfe des Cmdlets Set-SCVirtualNetworkAdapter konfigurieren.

Statische oder dynamische MAC-Adresse

Sie können angeben, ob der virtuelle Netzwerkadapter eine statische oder dynamische MAC-Adresse verwendet, und Sie können eine statische MAC-Adresse angeben.

Emulierte oder synthetische virtuelle Netzwerkadapter

Sie können das Cmdlet New-SCVirtualNetworkAdapter verwenden, um einen Adapter zu erstellen, dessen Typ entweder emuliert (Standard) oder synthetischer Typ ist.

Für virtuelle Computer auf einem beliebigen Hosttyp (Hyper-V, VMware oder XenServer) können Sie einen virtuellen Netzwerkadapter auf dem virtuellen Computer konfigurieren, der einen bestimmten physischen Netzwerkadapter emuliert.

Wenn das Gastbetriebssystem auf einem virtuellen Computer auf Hyper-V Hosts ein virtualisierungsfähiges Betriebssystem ist (z. B. Windows Server 2008 oder Windows Server 2016 und einige Versionen von Linux), können Sie mit VMM einen leistungsfähigen synthetischen virtuellen Netzwerkadapter auf dem virtuellen Computer konfigurieren, um mit der physischen Hardware auf dem Host zu kommunizieren. Sie müssen explizit angeben, dass ein virtueller Netzwerkadapter mithilfe des Parameters Synthetic synthetisch ist.

Virtuelles Lokales Netzwerk

VMM enthält Unterstützung für die Konfiguration eines oder mehrerer virtueller Flächennetzwerke (VLANs) auf einem Host für die Verwendung durch virtuelle Computer, die auf diesem Host bereitgestellt werden. Sie können das Cmdlet New-SCVirtualNetworkAdapter (oder das Cmdlet Set-SCVirtualNetworkAdapter) mit den parametern VLAN- verwenden, um den virtuellen Netzwerkadapter auf einem virtuellen Computer an ein VLAN anzufügen. Um die entsprechenden VLAN-Einstellungen auf dem Hostnetzwerkadapter zu konfigurieren, verwenden Sie das cmdlet Add-SCVMHostNetworkAdapter Cmdlet oder das cmdlet Set-SCVMHostNetworkAdapter.

Eine Abbildung der Konfiguration von VLANs finden Sie in den Beispielen für dieses Cmdlet und finden Sie in den Beispielen für New-SCVMHostNetworkAdapterConfig und Set-SCVMHostNetworkAdapter.

Anmerkung

  • Ein neuer Parameter [-PhysicalNetworkAdapterName] ist in VMM 2019 UR2 und höher enthalten. Weitere Informationen finden Sie unter Parameter.
  • Neue Parameter [-AllowedVLanList] und [-NativeVLanId] sind in VMM 2019 UR3 und höher enthalten. Weitere Informationen finden Sie unter Parameter.

Beispiele

Beispiel 1: Erstellen eines virtuellen Netzwerkadapters auf einem virtuellen Computer

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> New-SCVirtualNetworkAdapter -VM $VM

Der erste Befehl ruft das Objekt des virtuellen Computers mit dem Namen VM01 ab und speichert das Objekt in der $VM Variablen.

Der zweite Befehl erstellt einen virtuellen Netzwerkadapter auf VM01.

Beispiel 2: Erstellen eines virtuellen Netzwerkadapters auf einer Vorlage für virtuelle Computer

PS C:\> $VMTemplate = Get-SCVMTemplate | where { $_.Name -eq "VMTemplate01" }
PS C:\> New-SCVirtualNetworkAdapter -VMTemplate $VMTemplate

Der erste Befehl ruft das VmTemplate01-Vorlagenobjekt des virtuellen Computers ab und speichert das Objekt in der $VMTemplate Variablen.

Der zweite Befehl erstellt einen virtuellen Netzwerkadapter auf VMTemplate01.

Beispiel 3: Erstellen eines emulierten virtuellen Netzwerkadapters und eines synthetischen virtuellen Netzwerkadapters in einem Hardwareprofil

PS C:\> $HWProfile = Get-SCHardwareProfile | where { $_.Name -eq "NewHWProfile01" }
PS C:\> New-SCVirtualNetworkAdapter -HardwareProfile $HWProfile
PS C:\> New-SCVirtualNetworkAdapter -HardwareProfile $HWProfile -Synthetic

Der erste Befehl ruft das Hardwareprofilobjekt "NewHWProfile01" aus der VMM-Bibliothek ab und speichert das Objekt in der $HWProfile Variablen.

Der zweite Befehl erstellt einen virtuellen Netzwerkadapter (einen "nativen" oder emulierten Adapter) auf NewHWProfile01.

Der letzte Befehl erstellt einen synthetischen virtuellen Netzwerkadapter auf NewHWProfile01.

Beispiel 4: Erstellen eines virtuellen Netzwerkadapters auf einem virtuellen Computer und Zuweisen einer eindeutigen MAC-Adresse

PS C:\> $VM = Get-SCVirtualMachine -Name "VM04"
PS C:\> $VNIC = New-SCVirtualNetworkAdapter -VM $VM
PS C:\> $MACPool = Get-SCMACAddressPool -Name "MAC Address Pool 01"
PS C:\> Grant-SCMACAddress -MACAddressPool $MACPool -VirtualNetworkAdapter $VNIC

Der erste Befehl ruft das Objekt des virtuellen Computers namens VM04 ab und speichert das Objekt in der $VM Variablen.

Der zweite Befehl erstellt einen virtuellen Netzwerkadapter auf dem virtuellen Computer, der in $VM (VM04) gespeichert ist, und speichert das Objekt in der $VNIC Variablen.

Der dritte Befehl ruft das MAC-Adresspoolobjekt namens MAC Address Pool 01 ab und speichert das Objekt in der $MACPool Variablen.

Der letzte Befehl ruft die nächste verfügbare MAC-Adresse aus dem Adresspool ab, der in $MACPool gespeichert ist, und weist sie dem virtuellen Netzwerkadapter zu, der in $VNIC gespeichert ist.

Beispiel 5: Erstellen eines virtuellen Netzwerkadapters mit einer statischen MAC-Adresse und einer bestimmten VLAN-ID

PS C:\> $VM = Get-SCVirtualMachine -Name "VM05"
PS C:\> $LogicalNet = Get-SCLogicalNetwork -Name "LogicalNetwork01"
PS C:\> $VirtualNet = Get-SCVirtualNetwork -Name "ExternalVirtualNetwork01"
PS C:\> New-SCVirtualNetworkAdapter -VM $VM -LogicalNetwork $LogicalNet -VirtualNetwork $VirtualNet -MACAddress "00-16-D3-CC-00-1A" -MACAddressType "Static" -VLANEnabled $True -VLANId 3

Der erste Befehl ruft das Objekt des virtuellen Computers namens VM05 ab und speichert das Objekt in der $VM Variablen.

Der zweite Befehl ruft das logische Netzwerkobjekt "LogicalNetwork01" ab und speichert das Objekt in der $LogicalNet Variablen.

Der dritte Befehl ruft das virtuelle Netzwerkobjekt mit dem Namen ExternalVirtualNetwork01 ab und speichert das Objekt in der $VirtualNet Variablen.

Der letzte Befehl erstellt einen neuen virtuellen Netzwerkadapter für VM05, verbindet den Adapter mit dem logischen Netzwerk, das in $LogicalNet gespeichert ist, und das virtuelle Netzwerk, das in $VirtualNet gespeichert ist. Der Befehl stellt eine statische MAC-Adresse für den virtuellen Netzwerkadapter bereit, aktiviert VLAN und gibt eine VLAN-ID von 3 an.

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.

Parameter

-AdapterFlags

{{Fill AdapterFlags Description}}

Typ:VirtualNetworkAdapterFlags
Zulässige Werte:None, ApplyInfrastructurePortProfileForNetworkController, ApplyNCPortProfileForNetworkController, ApplyInstaceIDPortProfileForNetworkController
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AllowedVLanList

Gibt eine Liste der zulässigen virtuellen LANs auf einem Netzwerkadapter für virtuelle Computer an.

Anmerkung

Dieser Parameter gilt für VMM 2019 UR3 und höher.

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

-DevicePropertiesAdapterName

Gibt den Namen eines Netzwerkadapters an.

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

-DevicePropertiesAdapterNameMode

Gibt den Adapternamenmodus an.

Typ:DevicePropertiesAdapterNameMode
Zulässige Werte:Disabled, VMNetwork, Custom
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableGuestIPNetworkVirtualizationUpdates

Gibt an, ob IP-Netzwerkvirtualisierungsupdates von einem Gast aktiviert sind.

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

-EnableMACAddressSpoofing

Aktiviert, wenn sie auf $True festgelegt ist, MAC-Adressspoofing.

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

-EnableVMNetworkOptimization

Aktiviert, wenn sie auf $True festgelegt ist, die Netzwerkoptimierung für virtuelle Computer.

Dieses Feature verbessert die Netzwerkleistung für virtuelle Computer mit Netzwerkadaptern, die vmQ (Virtual Machine Queue) oder TCP Chimney Offload unterstützen. VMQ ermöglicht das Erstellen einer eindeutigen Netzwerkwarteschlange für jeden virtuellen Netzwerkadapter. Tcp Chimney Offload ermöglicht das Entladen von Netzwerkdatenverkehr aus dem Netzwerkstapel.

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

-HardwareProfile

Gibt ein Hardwareprofilobjekt an.

Typ:HardwareProfile
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-InheritsAddressFromPhysicalNetworkAdapter

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

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

-IPv4Address

Gibt eine IPv4-Adresse an.

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

-IPv4AddressPool

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

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

-IPv4AddressType

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

  • Dynamisch
  • Statisch
Typ:EthernetAddressType
Zulässige Werte:Dynamic, Static
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-IPv6Address

Gibt eine IPv6-Adresse an.

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

-IPv6AddressPool

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

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

-IPv6AddressType

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

  • Dynamisch
  • Statisch
Typ:EthernetAddressType
Zulässige Werte:Dynamic, Static
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:True
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

-LogicalNetwork

Gibt ein logisches Netzwerk an. Ein logisches Netzwerk ist eine benannte Gruppierung von IP-Subnetzen und VLANs, die zum Organisieren und Vereinfachen von Netzwerkzuweisungen verwendet werden.

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

-LogicalSwitch

Gibt ein logisches Switch-Objekt an.

Typ:LogicalSwitch
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-MACAddress

Gibt die MAC-Adresse oder eine Gruppe von MAC-Adressen für einen physischen oder virtuellen Netzwerkadapter auf einem Computer an.

  • Beispielformat für eine einzelne MAC-Adresse: -MACAddress "00-15-5D-B4-DC-00"
  • Beispielformat für eine Gruppe von MAC-Adressen: -MACAddress "00-15-5D-B4-DC-00", "00-1A-A0-E3-75-29"
Typ:String
Aliase:EthernetAddress, PhysicalAddress
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MACAddressType

Gibt den Typ der MAC-Adresse an, die für einen virtuellen Netzwerkadapter verwendet werden soll. Gültige Werte sind: Statisch, dynamisch.

Typ:String
Aliase:EthernetAddressType, PhysicalAddressType
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen eines Netzwerkobjekts an.

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

-NativeVLanId

Gibt den systemeigenen virtuellen LAN-Bezeichner für einen Netzwerkadapter eines virtuellen Computers an.

Anmerkung

Dieser Parameter gilt für VMM 2019 UR3 und höher.

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

-NetworkLocation

Gibt den Netzwerkspeicherort für einen physischen Netzwerkadapter oder für einen virtuellen Netzwerkadapter an oder ändert den Standardnetzwerkspeicherort des physischen Netzwerkadapters eines Hosts.

Beispielformate: -NetworkLocation $NetLoc ($NetLoc kann Corp.Contoso.com enthalten) -OverrideNetworkLocation $True -NetworkLocation "HostNICNewLocation.Contoso.com"

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

-NetworkTag

Gibt ein Wort oder einen Ausdruck an, der einem virtuellen Netzwerkadapter zugeordnet werden soll, der für die Verbindung mit einem bestimmten internen oder externen Netzwerk auf dem Host konfiguriert ist.

Der parameter NetworkTag identifiziert alle virtuellen Computer mit demselben NetworkTag- wie Mitglieder desselben Netzwerks. VMM verwendet eine NeworkTag- (sofern vorhanden), wenn sie Hosts als mögliche Kandidaten auswertet, auf denen ein virtueller Computer bereitgestellt werden soll. Wenn der Host keine virtuellen Computer im Netzwerk mit demselben NetworkTag wie der virtuelle Computer enthält, erhält der Host null Sterne im Platzierungsprozess.

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

-NoConnection

Trennt einen virtuellen Netzwerkadapter von einem virtuellen Netzwerk.

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

-NoVMNetwork

Gibt an, dass kein Netzwerk eines virtuellen Computers angegeben ist.

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

-OnBehalfOfUser

Gibt einen Benutzernamen an. Dieses Cmdlet wird im Auftrag des Benutzers ausgeführt, den dieser Parameter angibt.

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

-OnBehalfOfUserRole

Gibt eine Benutzerrolle an. Verwenden Sie zum Abrufen einer Benutzerrolle das cmdlet Get-SCUserRole. Dieses Cmdlet wird im Auftrag der Benutzerrolle ausgeführt, die dieser Parameter angibt.

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

-PhysicalNetworkAdapterName

Gibt den Namen des physischen Netzwerkadapters an.

Anmerkung

Dieser Parameter gilt für VMM 2019 UR2 und höher.

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

-PortACL

Gibt ein Port-ACL-Objekt an.

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

-PortClassification

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

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

-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

-Synthetic

Gibt an, dass ein Gerät, z. B. ein virtueller Netzwerkadapter, auf einem virtuellen Computer, der auf einem Hyper-V Host bereitgestellt wird, ein leistungsfähiges synthetisches Gerät ist. Erfordert ein virtualisierungsfähiges Gastbetriebssystem auf dem virtuellen Computer.

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

-VirtualNetwork

Gibt ein virtuelles Netzwerkobjekt an.

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

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

-VM

Gibt ein Objekt eines virtuellen Computers an.

Typ:VM
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-VMHost

Gibt ein Hostobjekt eines virtuellen Computers an. VMM unterstützt Hyper-V Hosts, VMware ESX-Hosts und Citrix XenServer-Hosts.

Weitere Informationen zu jedem Hosttyp finden Sie im cmdlet Add-SCVMHost.

Typ:Host
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-VMMServer

Gibt ein VMM-Serverobjekt an.

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

-VMNetwork

Gibt ein Netzwerkobjekt für virtuelle Computer an.

Um ein Netzwerkobjekt eines virtuellen Computers abzurufen, verwenden Sie das Cmdlet Get-SCVMNetwork.

Typ:VMNetwork
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-VMNetworkServiceSetting

Gibt eine Netzwerkdiensteinstellung für virtuelle Computer an.

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

-VMSubnet

Gibt ein Subnetzobjekt eines virtuellen Computers an.

Um ein VMSubnet--Objekt abzurufen, verwenden Sie das Cmdlet Get-SCVMSubnet.

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

-VMTemplate

Gibt ein VMM-Vorlagenobjekt an, das zum Erstellen virtueller Computer verwendet wird.

Typ:Template
Aliase:Template
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-VMwarePortGroup

Gibt die VMware-Portgruppe an.

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

Ausgaben

VirtualNetworkAdapter

Dieses Cmdlet gibt ein VirtualNetworkAdapter--Objekt zurück.

Hinweise

  • Erfordert ein VMM-Objekt, ein Vm-Vorlagenobjekt oder ein Hardwareprofilobjekt, das mithilfe der Get-SCVirtualMachine-, Get-SCVMTemplate-und Get-SCHardwareProfile Cmdlets abgerufen werden kann.