Freigeben über

Set-SCVMCheckpoint

  • Referenz
Modul:
VirtualMachineManager

Ändert die Eigenschaften eines Prüfpunktobjekts für virtuelle Computer in VMM.

Syntax

Set-SCVMCheckpoint
   -VMCheckpoint <VMCheckpoint>
   [-Description <String>]
   [-Name <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Beschreibung

Mit dem Cmdlet Set-SCVMCheckpoint-Cmdlet werden die Eigenschaften eines Prüfpunktobjekts für virtuelle Computer im Virtual Machine Manager (VMM) geändert.

Geben Sie Get-Help New-SCVMCheckpoint -Detailedein, um Informationen zum Erstellen von VMM-Prüfpunkten zu erstellen.

Beispiele

Beispiel 1: Festlegen der Beschreibung für alle Prüfpunkte auf eine angegebene Zeichenfolge

PS C:\> Get-SCVMCheckpoint | Set-SCVMCheckpoint -Description "All checkpoints created prior to upgrade"

Dieser Befehl ruft alle vorhandenen Prüfpunktobjekte aus der VMM-Datenbank ab und aktualisiert die Beschreibung für diese Prüfpunkte.

Beispiel 2: Ändern des Namens und der Beschreibung für alle Prüfpunkte

PS C:\> Get-SCVMCheckpoint | Set-SCVMCheckpoint -Name "Checkpoint Before Upgrade" -Description "Checkpoint was created prior to upgrade"

Dieser Befehl ruft alle vorhandenen Prüfpunktobjekte ab und ändert den Namen und die Beschreibung für jedes Objekt.

Beispiel 3: Ändern eines bestimmten Prüfpunkts in einem Array von Prüfpunkten

PS C:\> $VM = Get-SCVirtualMachine -Name "VM03"
PS C:\> Set-SCVMCheckpoint -VMCheckpoint $VM.VMCheckpoints[0] -Description "First Checkpoint Before Upgrade"

Der erste Befehl ruft das Objekt des virtuellen Computers namens VM03 ab und speichert das Objekt in der $VM Variablen.

Der letzte Befehl ändert die Beschreibung für das erste Prüfpunktobjekt im VMCheckpoints-Array für VM03.

Parameter

-Description

Gibt eine Beschreibung für einen Prüfpunkt 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

-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

-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

-VMCheckpoint

Gibt ein VMM-Prüfpunktobjekt für virtuelle Computer an.

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

Ausgaben

VMCheckpoint

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

Hinweise

  • Erfordert ein VMM-Prüfpunktobjekt, das Sie mithilfe des cmdlets Get-SCVMCheckpoint abrufen können.