New-SCVirtualNetworkAdapter
Erstellt einen virtuellen Netzwerkadapter auf einem virtuellen Computer, einer VM-Vorlage 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 VM-Vorlage oder einem Hardwareprofil, das zum Erstellen virtueller Computer verwendet wird, die von Virtual Machine Manager (VMM) verwaltet werden.
Netzwerkadresse
Sie können das Cmdlet New-SCVirtualNetworkAdapter verwenden, um einen Netzwerkspeicherort anzugeben und den virtuellen Netzwerkadapter mit einem auf dem Host konfigurierten virtuellen Netzwerk zu verbinden, 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 Virtual Network Adapter
Sie können das Cmdlet New-SCVirtualNetworkAdapter verwenden, um einen Adapter zu erstellen, dessen Typ entweder emuliert (Standard) oder synthetisch 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 für virtuelle Computer auf Hyper-V-Hosts das auf einem virtuellen Computer installierte Gastbetriebssystem 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 hochleistungsfähigen synthetischen virtuellen Netzwerkadapter auf dem virtuellen Computer für die Kommunikation mit der physischen Hardware auf dem Host konfigurieren. Sie müssen explizit angeben, dass ein virtueller Netzwerkadapter synthetisch ist, indem Sie den Synthetic-Parameter verwenden.
Virtuelles lokales Netzwerk
VMM bietet Unterstützung für die Konfiguration eines oder mehrerer VMS (Virtual Area Networks, 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 VLAN-Parametern verwenden, um den virtuellen Netzwerkadapter auf einem virtuellen Computer an ein VLAN anzufügen. Verwenden Sie zum Konfigurieren der entsprechenden VLAN-Einstellungen auf dem Hostnetzwerkadapter das Cmdlet Add-SCVMHostNetworkAdapter oder das Cmdlet Set-SCVMHostNetworkAdapter .
Eine Abbildung zum Konfigurieren von VLANs finden Sie in den Beispielen für dieses Cmdlet und in den Beispielen für New-SCVMHostNetworkAdapterConfig und Set-SCVMHostNetworkAdapter.
Hinweis
Beispiele
Beispiel 1: Erstellen eines virtuellen Netzwerkadapters auf einem virtuellen Computer
PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> New-SCVirtualNetworkAdapter -VM $VMDer erste Befehl ruft das VM-Objekt mit dem Namen VM01 ab und speichert das Objekt in der variablen $VM.
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 $VMTemplateDer erste Befehl ruft das Vorlagenobjekt des virtuellen Computers mit dem Namen VMTemplate01 ab und speichert das Objekt in der variablen $VMTemplate.
Der zweite Befehl erstellt einen virtuellen Netzwerkadapter für 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 -SyntheticDer erste Befehl ruft das Hardwareprofilobjekt namens NewHWProfile01 aus der VMM-Bibliothek ab und speichert das Objekt in der variablen $HWProfile.
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 $VNICDer erste Befehl ruft das Objekt des virtuellen Computers mit dem Namen 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 variablen $VNIC.
Der dritte Befehl ruft das MAC-Adresspoolobjekt mit dem Namen MAC-Adresspool 01 ab und speichert das Objekt in der variablen $MACPool.
Der letzte Befehl ruft die nächste verfügbare MAC-Adresse aus dem in $MACPool gespeicherten Adresspool ab und weist sie dem in $VNIC gespeicherten virtuellen Netzwerkadapter zu.
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 3Der erste Befehl ruft das VM-Objekt mit dem Namen VM05 ab und speichert das Objekt in der variablen $VM.
Der zweite Befehl ruft das logische Netzwerkobjekt mit dem Namen LogicalNetwork01 ab und speichert das Objekt in der variablen $LogicalNet.
Der dritte Befehl ruft das virtuelle Netzwerkobjekt mit dem Namen ExternalVirtualNetwork01 ab und speichert das Objekt in der variablen $VirtualNet.
Der letzte Befehl erstellt einen neuen virtuellen Netzwerkadapter für VM05, verbindet den Adapter mit dem in $LogicalNet gespeicherten logischen Netzwerk und dem in $VirtualNet gespeicherten virtuellen Netzwerk. 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, falls nicht, dass Ihr Host über zwei Netzwerkadapter verfügt. Wenn Ihr Host über einen einzelnen Netzwerkadapter verfügt, verhindert die Zuweisung 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}}
| Type: | VirtualNetworkAdapterFlags |
| Accepted values: | None, ApplyInfrastructurePortProfileForNetworkController, ApplyNCPortProfileForNetworkController, ApplyInstaceIDPortProfileForNetworkController |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowedVLanList
Gibt eine Liste von virtuellen LANs an, die auf einem Netzwerkadapter eines virtuellen Computers zulässig sind.
Hinweis
Dieser Parameter gilt für VMM 2019 UR3 und höher.
| Type: | UInt16 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DevicePropertiesAdapterName
Gibt den Namen eines Netzwerkadapters an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DevicePropertiesAdapterNameMode
Gibt den Adapternamenmodus an.
| Type: | DevicePropertiesAdapterNameMode |
| Accepted values: | Disabled, VMNetwork, Custom |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableGuestIPNetworkVirtualizationUpdates
Gibt an, ob IP-Netzwerkvirtualisierungsupdates durch einen Gast aktiviert sind.
| Type: | Boolean |
| Aliases: | GuestIPNetworkVirtualizationUpdatesEnabled |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableMACAddressSpoofing
Aktiviert bei Festlegung auf $True das Spoofing von MAC-Adressen.
| Type: | Boolean |
| Aliases: | MACAddressesSpoofingEnabled |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableVMNetworkOptimization
Aktiviert bei Festlegung auf $True die Netzwerkoptimierung für virtuelle Computer.
Dieses Feature verbessert die Netzwerkleistung für virtuelle Computer mit Netzwerkadaptern, die die VM-Warteschlange (VMQ) 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 Auslagern von Netzwerkdatenverkehr aus dem Netzwerkstapel.
| Type: | Boolean |
| Aliases: | VMNetworkOptimizationEnabled |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-HardwareProfile
Gibt ein Hardwareprofilobjekt an.
| Type: | HardwareProfile |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| 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 |
-IPv4Address
Gibt eine IPv4-Adresse an.
| Type: | String |
| 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 |
-IPv6Address
Gibt eine IPv6-Adresse an.
| Type: | String |
| 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 |
-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: | True |
| 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 |
-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 wird.
| Type: | LogicalNetwork |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LogicalSwitch
Gibt ein logisches Switchobjekt an.
| Type: | LogicalSwitch |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-MACAddress
Gibt die MAC-Adresse oder einen Satz 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 Reihe von MAC-Adressen:
-MACAddress "00-15-5D-B4-DC-00", "00-1A-A0-E3-75-29"
| Type: | String |
| Aliases: | EthernetAddress, PhysicalAddress |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MACAddressType
Gibt den Typ der MAC-Adresse an, die für einen virtuellen Netzwerkadapter verwendet werden soll. Gültige Werte sind: Statisch, Dynamisch.
| Type: | String |
| Aliases: | EthernetAddressType, PhysicalAddressType |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Gibt den Namen eines Netzwerkobjekts an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NativeVLanId
Gibt die systemeigene ID des virtuellen LAN für den Netzwerkadapter eines virtuellen Computers an.
Hinweis
Dieser Parameter gilt für VMM 2019 UR3 und höher.
| Type: | UInt16 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NetworkLocation
Gibt die Netzwerkadresse für einen physischen Netzwerkadapter oder für einen virtuellen Netzwerkadapter an oder ändert die Standardnetzwerkadresse des physischen Netzwerkadapters eines Hosts.
Beispielformate: -NetworkLocation $NetLoc ($NetLoc können Corp.Contoso.com enthalten) -OverrideNetworkLocation $True -NetworkLocation "HostNICNewLocation.Contoso.com"
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NetworkTag
Gibt ein Wort oder einen Ausdruck an, um dieses bzw. diesen einem virtuellen Netzwerkadapter zuzuordnen, der für das Herstellen von Verbindungen mit einem bestimmten internen oder externen Netzwerk auf dem Host konfiguriert ist.
Der Parameter NetworkTag identifiziert alle virtuellen Computer mit dem gleichen NetworkTag als Mitglieder desselben Netzwerks. VMM verwendet ein NeworkTag (sofern vorhanden), wenn Hosts als mögliche Kandidaten für die Bereitstellung eines virtuellen Computers ausgewertet werden. Wenn der Host keine virtuellen Computer im Netzwerk mit demselben NetworkTag wie der zu platzierende virtuelle Computer enthält, erhält der Host null Sterne im Platzierungsprozess.
| Type: | String |
| Aliases: | Tag |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NoConnection
Trennt einen virtuellen Netzwerkadapter von einem virtuellen Netzwerk.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NoVMNetwork
Gibt an, dass kein VM-Netzwerk angegeben ist.
| Type: | SwitchParameter |
| Aliases: | NoLogicalNetwork |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUser
Gibt einen Benutzernamen an. Dieses Cmdlet wird im Namen des Benutzers ausgeführt, den dieser Parameter angibt.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PhysicalNetworkAdapterName
Gibt den Namen des physischen Netzwerkadapters an.
Hinweis
Dieser Parameter gilt für VMM 2019 UR2 und höher.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PortACL
Gibt ein Port-ACL-Objekt an.
| Type: | PortACL |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PortClassification
Gibt die Portklassifizierung des Switches an, mit dem der virtuelle Netzwerkadapter verbunden ist.
| 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, sodass das Steuerelement sofort zur Befehlsshell zurückkehrt.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 synthetisches Hochleistungsgerät ist. Erfordert ein Gastbetriebssystem, das die Virtualisierung unterstützt, auf der virtuellen Maschine.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VirtualNetwork
Gibt ein virtuelles Netzwerkobjekt an.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| 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 einem virtuellen Netzwerkadapter auf einem virtuellen Computer oder einem physischen Netzwerkadapter auf einem hostigen 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
| Type: | UInt16 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VM
Gibt ein Objekt virtueller Maschinen an.
| Type: | VM |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VMHost
Gibt ein Hostobjekt für virtuelle Maschinen an. VMM unterstützt Hyper-V-Hosts, VMware ESX-Hosts und Citrix XenServer-Hosts.
Weitere Informationen zu den einzelnen Hosttypen finden Sie im Cmdlet Add-SCVMHost .
| Type: | Host |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VMMServer
Gibt ein VMM-Serverobjekt an.
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMNetwork
Gibt ein Vm-Netzwerkobjekt an.
Verwenden Sie zum Abrufen eines Vm-Netzwerkobjekts das Cmdlet Get-SCVMNetwork .
| Type: | VMNetwork |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VMNetworkServiceSetting
Gibt eine Netzwerkdiensteinstellung für virtuelle Computer an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMSubnet
Gibt ein Subnetzobjekt des 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: | False |
| Accept wildcard characters: | False |
-VMTemplate
Gibt ein zum Erstellen virtueller Maschinen verwendetes VMM-Vorlagenobjekt an.
| Type: | Template |
| Aliases: | Template |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VMwarePortGroup
Gibt die VMware-Portgruppe an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Ausgaben
VirtualNetworkAdapter
Dieses Cmdlet gibt ein VirtualNetworkAdapter-Objekt zurück.
Hinweise
- Erfordert ein VMM-VM-Objekt, ein Vorlagenobjekt für virtuelle Computer oder ein Hardwareprofilobjekt, das mit den Cmdlets Get-SCVirtualMachine, Get-SCVMTemplate und Get-SCHardwareProfile abgerufen werden kann.