Freigeben über

Set-SCVirtualNetworkAdapterConfiguration

Modul:
VirtualMachineManager Module

Ändert die Konfiguration des virtuellen Netzwerkadapters, die in einer Konfiguration des virtuellen Computers enthalten ist.

Syntax

Default (Standardwert) 

Set-SCVirtualNetworkAdapterConfiguration
    [-IPv4PAAddressPool <StaticIPAddressPool>]
    [-IPv4AddressPool <StaticIPAddressPool>]
    [-PinIPv4PAAddressPool <Boolean>]
    [-PinIPv4AddressPool <Boolean>]
    [-IPv6PAAddressPool <StaticIPAddressPool>]
    [-IPv6AddressPool <StaticIPAddressPool>]
    [-PinIPv6AddressPool <Boolean>]
    [-PinIPv6PAAddressPool <Boolean>]
    [-MACAddressPool <MACAddressPool>]
    [-PinMACAddressPool <Boolean>]
    [-IPv4PAAddress <String>]
    [-IPv4Address <String>]
    [-IPv6PAAddress <String>]
    [-IPv6Address <String>]
    [-MACAddress <String>]
    -VirtualNetworkAdapterConfiguration <VirtualNetworkAdapterConfiguration>
    [-VMSubnet <VMSubnet>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

Beschreibung

Mit dem Cmdlet Set-SCVirtualNetworkAdapterConfiguration werden die Konfigurationsinformationen für virtuelle Netzwerkadapter geändert, die in einer VM-Konfiguration enthalten sind.

Beispiele

Beispiel 1: Festlegen der Eigenschaften der Konfiguration des virtuellen Netzwerkadapters für eine VM-Konfiguration

PS C:\> $ServiceConfig = Get-SCServiceConfiguration -Name "Service01"
PS C:\> $TierConfig = Get-SCComputerTierConfiguration -ServiceConfiguration $ServiceConfig
PS C:\> $VMConfig = Get-SCVMConfiguration -ComputerTierConfiguration $TierConfig
PS C:\> $VNAConfig = Get-SCVirtualNetworkAdapterConfiguration -VMConfiguration $VMConfig[0]
PS C:\> Set-SCVirtualNetworkAdapterConfiguration -VirtualNetworkAdapterConfiguration $VNAConfig -IPv4Address "10.255.234.155" -PinIPv4AddressPool $True

Der erste Befehl ruft das Dienstkonfigurationsobjekt mit dem Namen Service01 ab und speichert das Objekt in der Variablen $ServiceConfig.

Der zweite Befehl ruft die Konfiguration der Computerebene für die in $ServiceConfig gespeicherte Dienstkonfiguration ab und speichert das Objekt in der Variablen $TierConfig.

Mit dem dritten Befehl wird die Konfiguration des virtuellen Computers für die in $TierConfig gespeicherte Konfiguration der Computerebene abgerufen und das Objekt in der Variablen $VMConfig gespeichert.

Mit dem vierten Befehl wird die Konfiguration des virtuellen Netzwerkadapters für die erste Konfiguration des virtuellen Computers abgerufen, die in $VMConfig gespeichert ist, und das Objekt in der Variablen $VNAConfig gespeichert.

Der letzte Befehl ändert die IPv4Address-Eigenschaft der in $VNAConfig gespeicherten Netzwerkadapterkonfiguration und heftet den Wert der IP-Adresse an, wodurch verhindert wird, dass sie während der Platzierung geändert wird.

Parameter

-IPv4Address

Gibt eine IPv4-Adresse 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

-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

-IPv4PAAddress

Gibt eine Anbieter-IP-Adresse im IPv4-Format 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

-IPv4PAAddressPool

Gibt einen Anbieter-IP-Adresspool an, der IP-Adressen im IPv4-Format 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

-IPv6Address

Gibt eine IPv6-Adresse 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

-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

-IPv6PAAddress

Gibt eine Anbieter-IP-Adresse im IPv6-Format 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

-IPv6PAAddressPool

Gibt einen Anbieter-IP-Adresspool an, der IP-Adressen im IPv6-Format 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

-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

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

  • Beispielformat für eine einzelne MAC-Adresse: -MACAddress "00-15-5D-B4-DC-00"
  • Beispielformat für einen Satz von MAC-Adressen: -MACAddress "00-15-5D-B4-DC-00", "00-1A-A0-E3-75-29"

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

-MACAddressPool

Gibt einen MAC-Adresspool an.

Parametereigenschaften

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

-PinIPv4AddressPool

Gibt an, ob der vom Benutzer ausgewählte IPv4-Adresspool während der Konfiguration der Dienstbereitstellung beibehalten 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

-PinIPv4PAAddressPool

Gibt an, ob der vom Benutzer ausgewählte Adresspool des IPv4-Anbieters während der Konfiguration der Dienstbereitstellung beibehalten 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

-PinIPv6AddressPool

Gibt an, ob der vom Benutzer ausgewählte IPv6-Adresspool während der Konfiguration der Dienstbereitstellung beibehalten 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

-PinIPv6PAAddressPool

Gibt an, ob der vom Benutzer ausgewählte Adresspool des IPv6-Anbieters während der Konfiguration der Dienstbereitstellung beibehalten 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

-PinMACAddressPool

Gibt an, ob der vom Benutzer ausgewählte MAC-Adresspool während der Konfiguration der Dienstbereitstellung beibehalten 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

-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

-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

-VirtualNetworkAdapterConfiguration

Gibt ein Konfigurationsobjekt für einen virtuellen Netzwerkadapter an.

Parametereigenschaften

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

Parametersätze

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

Ausgaben

VirtualNetworkAdapterConfiguration

Dieses Cmdlet gibt ein VirtualNetworkAdapterConfiguration-Objekt zurück.