Freigeben über


Set-SCLogicalSwitchVirtualNetworkAdapter

Führt einen Commit für Alle Änderungen an den Einstellungen auf einen vorhandenen virtuellen Netzwerkadapter (Virtual Network Adapter, VNIC) durch, der mit einem logischen Switch verbunden ist.

Syntax

Set-SCLogicalSwitchVirtualNetworkAdapter
   [-LogicalSwitchVirtualNetworkAdapter] <LogicalSwitchVirtualNetworkAdapter>
   [-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>]
   [-RemoveVMNetwork]
   [-RemoveVMSubnet]
   [-RemovePortClassification]
   [-RemoveIPv4AddressPool]
   [-RemoveIPv6AddressPool]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Beschreibung

Mit dem Set-SCLogicalSwitchVirtualNetworkAdapter Cmdlet werden Änderungen an einem vorhandenen virtuellen Netzwerkadapter übernommen, der dem Uplink-Portprofil als Teil der logischen Switchdefinition hinzugefügt wurde.

Beispiele

Beispiel 1: Umbenennen eines virtuellen Switch-Adapters

PS C:\> $HostVNic= Get-SCLogicalSwitchVirtualNetworkAdapter -Name "LogSw01_hostMgmt"
PS C:\> Set-SCLogicalSwitchVirtualNetworkAdapter -LogicalSwitchVirtualNetworkAdapter $HostVNic -Name "LogSw01_cluster"

Der erste Befehl ruft einen virtuellen Switch-Netzwerkadapter mit dem cmdlet Get-SCLogicalSwitchVirtualNetworkAdapter ab und speichert ihn dann in der $HostVNic Variablen.

Der zweite Befehl benennt den Adapter in $HostVNic um.

Parameter

-Description

Gibt eine Beschreibung für den virtuellen Netzwerkadapter an.

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

-EthernetAddressType

Gibt einen Ethernet-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

-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

-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

-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

-IsUsedForHostManagement

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

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

-LogicalSwitchVirtualNetworkAdapter

Gibt ein Logisches Switch-Objekt für virtuelle Netzwerkadapter an.

Typ:LogicalSwitchVirtualNetworkAdapter
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen des Netzwerkadapters an.

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

-RemoveIPv4AddressPool

Gibt an, dass dieses Cmdlet einen IPv4-Adresspool entfernt.

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

-RemoveIPv6AddressPool

Gibt an, dass dieses Cmdlet einen IPv6-Adresspool entfernt.

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

-RemovePortClassification

Gibt an, dass dieses Cmdlet eine Portklassifizierung entfernt.

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

-RemoveVMNetwork

Gibt an, dass dieses Cmdlet ein Netzwerk eines virtuellen Computers entfernt.

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

-RemoveVMSubnet

Gibt an, dass dieses Cmdlet ein Subnetz eines virtuellen Computers entfernt.

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

-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

-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.

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