Freigeben über

Set-SCVMConfiguration

  • Referenz
Modul:
VirtualMachineManager

Ändert die Konfiguration des virtuellen Computers für eine Computerebene.

Syntax

Set-SCVMConfiguration
   [-VMLocation <String>]
   [-PinVMLocation <Boolean>]
   [-ComputerName <String>]
   [-PinVMHost <Boolean>]
   [-CapabilityProfile <CapabilityProfile>]
   [-VMMServer <ServerConnection>]
   [-VMConfiguration] <BaseVMConfiguration>
   [-Description <String>]
   [-Tag <String>]
   [-CostCenter <String>]
   [-Name <String>]
   [-NoConnectedHost]
   [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVMConfiguration
   [-VMLocation <String>]
   [-PinVMLocation <Boolean>]
   [-ComputerName <String>]
   -VMHost <Host>
   [-PinVMHost <Boolean>]
   [-CapabilityProfile <CapabilityProfile>]
   [-VMConfiguration] <BaseVMConfiguration>
   [-Description <String>]
   [-Tag <String>]
   [-CostCenter <String>]
   [-Name <String>]
   [-NoConnectedHost]
   [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVMConfiguration
   [-VMLocation <String>]
   [-PinVMLocation <Boolean>]
   [-ComputerName <String>]
   [-PinVMHost <Boolean>]
   [-VMHostGroup <HostGroup>]
   [-CapabilityProfile <CapabilityProfile>]
   [-VMMServer <ServerConnection>]
   [-VMConfiguration] <BaseVMConfiguration>
   [-Description <String>]
   [-Tag <String>]
   [-CostCenter <String>]
   [-Name <String>]
   [-NoConnectedHost]
   [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVMConfiguration
   [-VMLocation <String>]
   [-PinVMLocation <Boolean>]
   [-ComputerName <String>]
   [-PinVMHost <Boolean>]
   -Cloud <Cloud>
   [-CapabilityProfile <CapabilityProfile>]
   [-VMConfiguration] <BaseVMConfiguration>
   [-Description <String>]
   [-Tag <String>]
   [-CostCenter <String>]
   [-Name <String>]
   [-NoConnectedHost]
   [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Set-SCVMConfiguration Cmdlet ändert die Konfiguration des virtuellen Computers für eine Computerebene. Die Konfiguration des virtuellen Computers beschreibt, wie der virtuelle Computer konfiguriert wird, wenn der Dienst bereitgestellt wird.

Beispiele

Beispiel 1: Aktualisieren der Konfiguration des virtuellen Computers für eine Computerebene vor der Bereitstellung des Diensts

PS C:\> $ServiceConfig = Get-SCServiceConfiguration -Name "Service01"
PS C:\> $TierConfig = Get-SCComputerTierConfiguration -ServiceConfiguration $ServiceConfig
PS C:\> $VMConfig = Get-SCVMConfiguration -ComputerTierConfiguration $TierConfig
PS C:\> Set-SCVMConfiguration -VMConfiguration $VMConfig[0] -Description "This is the updated virtual machine configuration"

Der erste Befehl ruft das Dienstkonfigurationsobjekt namens Service01 ab und speichert das Objekt in der variablen $ServiceConfig.

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 Computerebenenkonfiguration ab und speichert die Variable in der $VMConfig Variablen.

Der letzte Befehl legt die Beschreibungseigenschaft des ersten konfigurationsobjekts für virtuelle Computer fest, das in $VMConfig gespeichert ist, und zeigt die Eigenschaften der Konfiguration des virtuellen Computers für den Benutzer an.

Beispiel 2: Konfigurieren des Konfigurationsobjekts für virtuelle Computer für eine Computerebene zum Anheften des Hosts für einen virtuellen Computer

PS C:\> $ServiceConfig = Get-SCServiceConfiguration -Name "Service01" 
PS C:\> $TierConfig = Get-SCComputerTierConfiguration -ServiceConfiguration $ServiceConfig 
PS C:\> $VMConfig = Get-SCVMConfiguration -ComputerTierConfiguration $TierConfig
PS C:\> Set-SCVMConfiguration -VMConfiguration $VMConfig[0] -PinVMHost $True

Der erste Befehl ruft das Dienstkonfigurationsobjekt namens Service01 ab und speichert das Objekt in der variablen $ServiceConfig.

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

Der dritte Befehl ruft die Konfigurationsobjekte des virtuellen Computers für die in $TierConfig gespeicherte Computerebenenkonfiguration ab und speichert die Objekte in der variablen $VMConfig.

Mit dem letzten Befehl wird die PinVMHost-$True für das erste konfigurationsobjekt des virtuellen Computers festgelegt, das in $VMConfig gespeichert ist. Daher wird der Host für den virtuellen Computer, der mit dieser Konfiguration erstellt wurde, nicht geändert, wenn der Dienst bereitgestellt wird.

Beispiel 3: Konfigurieren des Konfigurationsobjekts des virtuellen Computers für einen Dienst in einer privaten Cloud

PS C:\> $ServiceConfig = Get-SCServiceConfiguration -Name "Service01"
PS C:\> $TierConfig = Get-SCComputerTierConfiguration -ServiceConfiguration $ServiceConfig 
PS C:\> $VMConfig = Get-SCVMConfiguration -ComputerTierConfiguration $TierConfig
PS C:\> $Cloud = Get-SCCloud -Name "Production"
PS C:\> Set-SCVMConfiguration -VMConfiguration $VMConfig[1] -Cloud $Cloud -Description "This is the new virtual machine configuration"

Der erste Befehl ruft das Dienstkonfigurationsobjekt namens Service01 ab und speichert das Objekt in der variablen $ServiceConfig.

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 Konfigurationsobjekte des virtuellen Computers für die in $TierConfig gespeicherte Computerebenenkonfiguration ab und speichert die Objekte in der variablen $VMConfig.

Der vierte Befehl ruft das private Cloudobjekt "Production" ab und speichert das Objekt in der $Cloud Variablen.

Der letzte Befehl aktualisiert die Beschreibung für das zweite Konfigurationsobjekt des virtuellen Computers, das in $VMConfig für die private Cloud gespeichert in $Cloud gespeichert ist.

Parameter

-AvailabilitySetNames

Gibt eine Liste der Verfügbarkeitssatznamen an.

Typ:System.Collections.Generic.List`1[System.String]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-CapabilityProfile

Gibt ein Funktionsprofilobjekt an.

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

-Cloud

Gibt ein privates Cloudobjekt an.

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

-ComputerName

Gibt den Namen eines Computers an, den der Virtual Machine Manager (VMM) in Ihrem Netzwerk eindeutig identifizieren kann. Gültige Formate sind:

  • FQDN
  • IPv4- oder IPv6-Adresse
  • NetBIOS-Name
Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-CostCenter

Gibt das Kostencenter für einen virtuellen Computer an, sodass Sie Daten über die Zuordnung virtueller Computer (oder Ressourcen, die virtuellen Computern zugeordnet sind) sammeln können, um sie in Ihrem Abrechnungssystem zu nutzen.

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

-Description

Gibt eine Beschreibung für die Konfiguration 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

-Name

Gibt den Namen eines VMM-Objekts an.

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

-NoConnectedHost

Entfernt den Host aus einer Konfiguration eines virtuellen Computers.

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

-OnBehalfOfUser

Gibt den Namen eines Benutzers an. Dieses Cmdlet legt den Benutzer im Auftrag des Benutzers als Benutzer fest, den dieser Parameter angibt.

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

-OnBehalfOfUserRole

Gibt eine Benutzerrolle an. Mit diesem Cmdlet wird die Im Auftrag der Benutzerrolle als Benutzerrolle festgelegt, die dieser Parameter angibt. Verwenden Sie zum Abrufen eines Benutzerrollenobjekts das cmdlet Get-SCUserRole.

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

-PinVMHost

Gibt an, ob der vom Benutzer ausgewählte virtuelle Computerhost während der Dienstbereitstellungskonfiguration beibehalten wird.

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

-PinVMLocation

Gibt an, ob der vom Benutzer ausgewählte Speicherort des virtuellen Computers während der Dienstbereitstellungskonfiguration beibehalten wird.

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

-Tag

Gibt ein Wort oder einen Ausdruck an, das einem Objekt zugeordnet werden soll, damit Sie nach allen Objekten mit der angegebenen Gruppe von Tags suchen können. Sie können nach einer Teilmenge von Tags suchen oder nach dem vollständigen Satz von Tags suchen.

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

-VMConfiguration

Gibt ein Konfigurationsobjekt für virtuelle Computer an.

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

-VMHost

Gibt ein Hostobjekt eines virtuellen Computers an. VMM unterstützt Hyper-V Hosts, VMware ESX-Hosts und Citrix XenServer-Hosts.

Weitere Informationen zu jedem Hosttyp finden Sie im cmdlet Add-SCVMHost.

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

-VMHostGroup

Gibt ein Hostgruppenobjekt eines virtuellen Computers oder ein Array von Hostgruppenobjekten an.

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

-VMLocation

Gibt den Pfad zu einem virtuellen Computer an.

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

Ausgaben

VMConfiguration

Dieses Cmdlet gibt ein VMConfiguration--Objekt zurück.