Set-SCVMCheckpoint
Ä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
Das Cmdlet Set-SCVMCheckpoint ändert die Eigenschaften eines Prüfpunktobjekts für virtuelle Computer in Virtual Machine Manager (VMM).
Informationen zum Erstellen von VMM-Prüfpunkten geben Sie Get-Help New-SCVMCheckpoint -Detailedein.
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 virtuelle Computerobjekt mit dem Namen 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.
| Type: | String |
| 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 |
-Name
Gibt den Namen eines VMM-Objekts an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUser
Gibt den Namen eines Benutzers an. Dieses Cmdlet legt den Benutzer im Namen des Benutzers als Benutzer fest, den dieser Parameter angibt.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUserRole
Gibt eine Benutzerrolle an. Dieses Cmdlet legt die Benutzerrolle im Namen der Benutzerrolle als die Benutzerrolle fest, die dieser Parameter angibt. Verwenden Sie zum Abrufen eines Benutzerrollenobjekts das Cmdlet Get-SCUserRole .
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| 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, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMCheckpoint
Gibt ein Prüfpunktobjekt für virtuelle VMM-Maschinen an.
| Type: | VMCheckpoint |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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.