Freigeben über

Set-SCLogicalSwitchVirtualNetworkAdapter

Modul:
VirtualMachineManager Module

Führt einen Commit für alle Änderungen an den Einstellungen an einen vorhandenen virtuellen Netzwerkadapter (VNIC) aus, der mit einem logischen Switch verbunden ist.

Syntax

Default (Standardwert) 

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 Cmdlet Set-SCLogicalSwitchVirtualNetworkAdapter werden Änderungen an einem vorhandenen virtuellen Netzwerkadapter ausgeführt, der dem Uplinkportprofil als Teil der Definition des logischen Switches hinzugefügt wurde.

Beispiele

Beispiel 1: Umbenennen eines virtuellen Netzwerkadapters für logische Switches

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

Mit dem ersten Befehl wird mithilfe des Cmdlets Get-SCLogicalSwitchVirtualNetworkAdapter ein virtueller Netzwerkadapter für logische Switches abgerufen und dann in der Variablen $HostVNic gespeichert.

Der zweite Befehl benennt den Adapter in $HostVNic um.

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

-LogicalSwitchVirtualNetworkAdapter

Gibt ein Objekt für einen virtuellen Netzwerkadapter für logische Switches an.

Parametereigenschaften

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

Parametersätze

(All)
Position:0
Obligatorisch.:True
Wert aus Pipeline:True
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:Named
Obligatorisch.:False
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

-RemoveIPv4AddressPool

Gibt an, dass mit diesem Cmdlet ein IPv4-Adresspool entfernt wird.

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

-RemoveIPv6AddressPool

Gibt an, dass mit diesem Cmdlet ein IPv6-Adresspool entfernt wird.

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

-RemovePortClassification

Gibt an, dass mit diesem Cmdlet eine Portklassifizierung entfernt wird.

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

-RemoveVMNetwork

Gibt an, dass mit diesem Cmdlet ein Netzwerk eines virtuellen Computers entfernt wird.

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

-RemoveVMSubnet

Gibt an, dass mit diesem Cmdlet ein Subnetz eines virtuellen Computers entfernt wird.

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

-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

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

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.