Freigeben über

New-SCVMHostNetworkAdapterConfig

  • Referenz
Modul:
VirtualMachineManager

Erstellt eine Hostnetzwerkadapterkonfiguration.

Syntax

New-SCVMHostNetworkAdapterConfig
   [-VMMServer <ServerConnection>]
   [-SetAsPhysicalNetworkAdapter]
   -LogicalSwitch <LogicalSwitch>
   -UplinkPortProfileSet <UplinkPortProfileSet>
   [-MACAddress <String>]
   [-ConsistentDeviceName <String>]
   [-DisableAdapterDNSRegistration <Boolean>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCVMHostNetworkAdapterConfig
   [-VMMServer <ServerConnection>]
   [-SetAsPhysicalNetworkAdapter]
   [-SetAsGenericNIC]
   [-UseStaticIPForIPConfiguration]
   -LogicalNetwork <LogicalNetwork>
   [-MACAddress <String>]
   [-ConsistentDeviceName <String>]
   [-IPv4Subnet <String>]
   [-IPv6Subnet <String>]
   [-IPv4Address <String>]
   [-IPv6Address <String>]
   [-DisableAdapterDNSRegistration <Boolean>]
   [-AdapterName <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCVMHostNetworkAdapterConfig
   [-VMMServer <ServerConnection>]
   [-SetAsPhysicalNetworkAdapter]
   [-SetAsManagementNIC]
   [-UseDhcpForIPConfiguration]
   [-MACAddress <String>]
   [-ConsistentDeviceName <String>]
   [-AdapterName <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCVMHostNetworkAdapterConfig
   [-VMMServer <ServerConnection>]
   [-SetAsPhysicalNetworkAdapter]
   [-SetAsGenericNIC]
   [-UseDhcpForIPConfiguration]
   [-MACAddress <String>]
   [-ConsistentDeviceName <String>]
   [-DisableAdapterDNSRegistration <Boolean>]
   [-AdapterName <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCVMHostNetworkAdapterConfig
   [-VMMServer <ServerConnection>]
   [-SetAsPhysicalNetworkAdapter]
   [-SetAsManagementNIC]
   [-UseStaticIPForIPConfiguration]
   -LogicalNetwork <LogicalNetwork>
   [-MACAddress <String>]
   [-ConsistentDeviceName <String>]
   [-IPv4Subnet <String>]
   [-IPv6Subnet <String>]
   [-IPv4Address <String>]
   [-IPv6Address <String>]
   [-AdapterName <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCVMHostNetworkAdapterConfig
   [-VMMServer <ServerConnection>]
   [-SetAsVirtualNetworkAdapter]
   [-SetAsGenericNIC]
   [-UseDhcpForIPConfiguration]
   -LogicalSwitch <LogicalSwitch>
   [-PortClassification <PortClassification>]
   -VMNetwork <VMNetwork>
   [-MACAddress <String>]
   [-AdapterName <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCVMHostNetworkAdapterConfig
   [-VMMServer <ServerConnection>]
   [-SetAsVirtualNetworkAdapter]
   [-SetAsGenericNIC]
   [-UseStaticIPForIPConfiguration]
   -LogicalSwitch <LogicalSwitch>
   [-PortClassification <PortClassification>]
   -VMNetwork <VMNetwork>
   [-MACAddress <String>]
   [-IPv4Subnet <String>]
   [-IPv6Subnet <String>]
   [-IPv4Address <String>]
   [-IPv6Address <String>]
   [-AdapterName <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCVMHostNetworkAdapterConfig
   [-VMMServer <ServerConnection>]
   [-SetAsVirtualNetworkAdapter]
   [-SetAsManagementNIC]
   -TransientManagementNetworkAdapter <PhysicalComputerNetworkAdapterConfig>
   [-UseDhcpForIPConfiguration]
   -LogicalSwitch <LogicalSwitch>
   [-PortClassification <PortClassification>]
   -VMNetwork <VMNetwork>
   [-MACAddress <String>]
   [-AdapterName <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCVMHostNetworkAdapterConfig
   [-VMMServer <ServerConnection>]
   [-SetAsVirtualNetworkAdapter]
   [-SetAsManagementNIC]
   -TransientManagementNetworkAdapter <PhysicalComputerNetworkAdapterConfig>
   [-UseStaticIPForIPConfiguration]
   -LogicalSwitch <LogicalSwitch>
   [-PortClassification <PortClassification>]
   -VMNetwork <VMNetwork>
   [-MACAddress <String>]
   [-IPv4Subnet <String>]
   [-IPv6Subnet <String>]
   [-IPv4Address <String>]
   [-IPv6Address <String>]
   [-AdapterName <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet New-SCVMHostNetworkAdapterConfig erstellt eine Hostnetzwerkadapterkonfiguration, die während des Bereitstellungsprozesses des Hostbetriebssystems verwendet wird.

Beispiele

Beispiel 1: Erstellen einer Konfiguration des physischen Hostnetzwerkadapters für die Verwaltung mithilfe einer statischen IP-Adresse

PS C:\> $LogicalNetwork = Get-SCLogicalNetwork -Name "LogicalNetwork01"
PS C:\> New-SCVMHostNetworkAdapterConfig -SetAsPhysicalNetworkAdapter -SetAsManagementNIC -UseStaticIPForIPConfiguration -LogicalNetwork $LogicalNetwork -MacAddress "00-1D-D8-B7-1C-00" -IPv4Subnet "10.0.0.1/24"

Der erste Befehl ruft das logische Netzwerkobjekt mit dem Namen LogicalNetwork01 ab und speichert das Objekt in der $LogicalNetwork Variablen.

Der zweite Befehl erstellt eine Konfiguration des physischen Hostnetzwerkadapters und legt sie als Verwaltungsnetzwerkadapter fest und verwendet während der IP-Konfiguration eine statische IP-Adresse. Die Konfiguration umfasst LogicalNetwork01, die bereitgestellte MAC-Adresse und das angegebene Subnetz.

Beispiel 2: Erstellen einer Konfiguration eines physischen Hostnetzwerkadapters, die einen logischen Switch verwendet

PS C:\> $LogicalSwitch = Get-SCLogicalSwitch -Name "LogicalSwitch01"
PS C:\> $UplinkPortProfSet = Get-SCUplinkPortProfileSet -Name "UplinkPortProfileSet01"
PS C:\> New-SCVMHostNetworkAdapterConfig -SetAsPhysicalNetworkAdapter -LogicalSwitch $LogicalSwitch -UplinkPortProfileSet $UplinkPortProfSet

Der erste Befehl ruft das logische Switchobjekt mit dem Namen LogicalSwitch01 ab und speichert das Objekt in der $LogicalSwitch Variablen.

Der zweite Befehl ruft das Uplink-Portprofil-Set-Objekt mit dem Namen UplinkPortProfileSet01 ab und speichert das Objekt in der $UplinkPortProfSet Variablen.

Der letzte Befehl erstellt eine Konfiguration des physischen Hostnetzwerkadapters mit LogicalSwitch01 und UplinkPortProfileSet01.

Beispiel 3: Erstellen einer generischen Konfiguration des virtuellen Hostnetzwerkadapters mithilfe von DHCP

PS C:\> $LogicalSwitch = Get-SCLogicalSwitch -Name "LogicalSwitch01"
PS C:\> $VMNetwork = Get-SCVMNetwork -Name "VMNetwork01"
PS C:\> New-SCVMHostNetworkAdapterConfig -SetAsVirtualNetworkAdapter -SetAsGenericNIC -UseDhcpForIPConfiguration -LogicalSwitch $LogicalSwitch -VMNetwork $VMNetwork

Der erste Befehl ruft das logische Switchobjekt mit dem Namen LogicalSwitch01 ab und speichert das Objekt in der $LogicalSwitch Variablen.

Der zweite Befehl ruft das VM-Netzwerkobjekt mit dem Namen VMNetwork01 ab und speichert das Objekt in der variablen $VMNetwork.

Der letzte Befehl erstellt eine generische Konfiguration für virtuelle Hostnetzwerke mit LogicalSwtich01 und VMNetwork01, die DHCP zum Abrufen einer IP-Adresse verwendet.

Parameter

-AdapterName

Gibt den Namen des Netzwerkadapters an.

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

-ConsistentDeviceName

Gibt einen konsistenten Gerätenamen für einen Netzwerkadapter an.

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

-DisableAdapterDNSRegistration

Gibt an, ob die DNS-Registrierung für den Netzwerkadapter deaktiviert werden soll.

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

-IPv4Subnet

Gibt ein IPv4-Subnetz an.

Typ:String
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

-IPv6Subnet

Gibt ein IPv6-Subnetz an.

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

-LogicalSwitch

Gibt ein logisches Switch-Objekt an.

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

-MACAddress

Gibt die Mac-Adresse (Media Access Control) oder eine Gruppe von MAC-Adressen für einen physischen oder virtuellen Netzwerkadapter auf einem Computer an. Gültige Werte sind: eine oder mehrere MAC-Adressen.

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"

Beispielformat für eine Gruppe von MAC-Adressen:

$Macs = "00-15-5D-B4-DC-00", "00-1A-A0-E3-75-29"

Set-SCPXEServer -MACAddress $Macs

Typ:String
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:False
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

-SetAsGenericNIC

Gibt an, dass der Netzwerkadapter nicht der Verwaltungsnetzwerkadapter für den Host ist.

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

-SetAsManagementNIC

Gibt an, dass der Netzwerkadapter der Verwaltungsnetzwerkadapter für den Host ist.

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

-SetAsPhysicalNetworkAdapter

Gibt an, dass der Netzwerkadapter ein physischer Netzwerkadapter ist.

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

-SetAsVirtualNetworkAdapter

Gibt an, dass der Netzwerkadapter ein virtueller Netzwerkadapter ist.

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

-TransientManagementNetworkAdapter

Gibt den physischen Netzwerkadapter an, an den der virtuelle Verwaltungsnetzwerkadapter während der ersten Bereitstellungsphase des Betriebssystems gebunden wird. Diese Eigenschaft wird vorübergehend verwendet, bevor der Host bereitgestellt wird.

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

-UplinkPortProfileSet

Gibt ein Uplink-Portprofilsatzobjekt an.

Um ein Uplink-Portprofilsatzobjekt abzurufen, verwenden Sie das Cmdlet Get-SCUplinkPortProfileSet.

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

-UseDhcpForIPConfiguration

Gibt an, dass die IP-Adresse für den Netzwerkadapter mithilfe von DHCP abgerufen wird.

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

-UseStaticIPForIPConfiguration

Gibt an, dass der Netzwerkadapter mit einer statischen IP-Adresse konfiguriert ist.

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

-VMMServer

Gibt ein VMM-Serverobjekt an.

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

-VMNetwork

Gibt ein VM-Netzwerkobjekt an.

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

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

Ausgaben

HostNetworkAdapterConfig

Dieses Cmdlet gibt ein HostNetworkAdapterConfig-Objekt zurück.