Freigeben über

Set-SCVirtualNetworkAdapterConfiguration

  • Referenz
Modul:
VirtualMachineManager

Ändert die Konfiguration des virtuellen Netzwerkadapters, die in einer virtuellen Computerkonfiguration enthalten sind.

Syntax

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

Das Cmdlet Set-SCVirtualNetworkAdapterConfiguration ändert die Konfigurationsinformationen des virtuellen Netzwerkadapters, die in einer virtuellen Computerkonfiguration enthalten sind.

Beispiele

Beispiel 1: Festlegen der Eigenschaften der Konfiguration des virtuellen Netzwerkadapters für eine virtuelle Computerkonfiguration

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 namens Service01 ab und speichert das Objekt in der $ServiceConfig Variable.

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

Der dritte Befehl ruft die Konfiguration des virtuellen Computers für die in $TierConfig gespeicherte Computerkonfiguration ab und speichert das Objekt in der $VMConfig Variable.

Der vierte Befehl ruft die Konfiguration des virtuellen Netzwerkadapters für die erste in $VMConfig gespeicherte virtuelle Computerkonfiguration ab und speichert das Objekt in der $VNAConfig Variablen.

Der letzte Befehl ändert die IPv4Address-Eigenschaft der in $VNAConfig gespeicherten Netzwerkadapterkonfiguration und pins 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.

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

-IPv4PAAddress

Gibt eine Anbieter-IP-Adresse im IPv4-Format an.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IPv4PAAddressPool

Gibt einen Anbieter-IP-Adresspool an, der IP-Adressen im IPv4-Format enthält.

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

-IPv6PAAddress

Gibt eine Anbieter-IP-Adresse im IPv6-Format an.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IPv6PAAddressPool

Gibt einen Anbieter-IP-Adresspool an, der IP-Adressen im IPv6-Format enthält.

Type:StaticIPAddressPool
Position:Named
Default value:None
Required:False
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

-MACAddress

Gibt die Adresse der Medienzugriffssteuerung (MAC) 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 Gruppe von MAC-Adressen: -MACAddress "00-15-5D-B4-DC-00", "00-1A-A0-E3-75-29"
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MACAddressPool

Gibt einen MAC-Adresspool an.

Type:MACAddressPool
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PinIPv4AddressPool

Gibt an, ob der vom Benutzer ausgewählte IPv4-Adresspool während der Dienstbereitstellungskonfiguration beibehalten wird.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PinIPv4PAAddressPool

Gibt an, ob der vom Benutzer ausgewählte IPv4-Anbieteradressenpool während der Dienstbereitstellungskonfiguration beibehalten wird.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PinIPv6AddressPool

Gibt an, ob der vom Benutzer ausgewählte IPv6-Adresspool während der Dienstbereitstellungskonfiguration beibehalten wird.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PinIPv6PAAddressPool

Gibt an, ob der vom Benutzer ausgewählte IPv6-Anbieteradressenpool während der Dienstbereitstellungskonfiguration beibehalten wird.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PinMACAddressPool

Gibt an, ob der vom Benutzer ausgewählte MAC-Adresspool während der Dienstbereitstellungskonfiguration beibehalten wird.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

Gibt die ID der Leistungs- und Ressourcenoptimierungs-Tipp (PRO-Tipp) an, die 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 an die Befehlsshell zurückgibt.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VirtualNetworkAdapterConfiguration

Gibt ein Virtuelles Netzwerkadapterkonfigurationsobjekt an.

Type:VirtualNetworkAdapterConfiguration
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMSubnet

Gibt ein virtuelles Computer-Subnetzobjekt 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

Ausgaben

VirtualNetworkAdapterConfiguration

Dieses Cmdlet gibt ein VirtualNetworkAdapterConfiguration-Objekt zurück.