Partager via

Remove-SCVMCheckpoint

  • Référence
Module:
VirtualMachineManager

Supprime un objet de point de contrôle de machine virtuelle de la base de données VMM.

Syntaxe

Remove-SCVMCheckpoint
      -VMCheckpoint <VMCheckpoint>
      [-JobGroup <Guid>]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]

Description

La cmdlet Remove-SCVMCheckpoint supprime un objet de point de contrôle de machine virtuelle de la base de données Virtual Machine Manager (VMM).

Exemples

Exemple 1 : Supprimer le point de contrôle le plus récent d’une machine virtuelle

PS C:\> $Checkpoint = Get-SCVMCheckpoint -VM "VM01" -MostRecent
PS C:\> Remove-SCVMCheckpoint -VMCheckpoint $Checkpoint -Confirm

La première commande obtient tous les objets de point de contrôle pour VM01 et stocke ces objets dans le tableau d’objets $Checkpoints. Cet exemple suppose que VM01 a plusieurs points de contrôle.

La deuxième commande supprime le premier point de contrôle dans le tableau ($Checkpoints[0]). Le paramètre Confirmer vous invite à confirmer si vous souhaitez supprimer le point de contrôle.

Exemple 2 : Supprimer un point de contrôle spécifié pour une machine virtuelle

PS C:\> $Checkpoints = Get-SCVMCheckpoint -VM "VM01" 
PS C:\> Remove-SCVMCheckpoint -VMCheckpoint $Checkpoints[0] -Confirm

La première commande obtient tous les objets de point de contrôle pour VM01 et stocke les objets dans le tableau d’objets $Checkpoints. Cet exemple suppose que VM01 a au moins deux points de contrôle.

La deuxième commande supprime le premier point de contrôle stocké dans le tableau $Checkpoints, qui est le premier point de contrôle créé pour VM01. La commande vous invite à confirmer avant de continuer.

Paramètres

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-JobGroup

Spécifie un identificateur pour une série de commandes qui s’exécute en tant que jeu juste avant la commande finale qui inclut le même identificateur de groupe de travaux.

Type:Guid
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-JobVariable

Spécifie que la progression du travail est suivie et stockée dans la variable nommée par ce paramètre.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-OnBehalfOfUser

Spécifie le nom d’un utilisateur. Cette applet de commande définit le compte de l’utilisateur en tant qu’utilisateur spécifié par ce paramètre.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-OnBehalfOfUserRole

Spécifie un rôle d’utilisateur. Cette applet de commande définit le rôle d’utilisateur pour le compte de l’utilisateur comme rôle d’utilisateur spécifié par ce paramètre. Pour obtenir un objet de rôle d’utilisateur, utilisez l’applet de commande Get-SCUserRole.

Type:UserRole
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PROTipID

Spécifie l’ID de l’info-bulle d’optimisation des performances et des ressources (CONSEIL PRO) qui a déclenché cette action. Ce paramètre vous permet d’auditer les conseils pro.

Type:Guid
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RunAsynchronously

Indique que le travail s’exécute de façon asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-VMCheckpoint

Spécifie un objet de point de contrôle de machine virtuelle VMM.

Type:VMCheckpoint
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Notes

  • Nécessite un objet de point de contrôle VMM, que vous pouvez récupérer à l’aide de l’applet de commande Get-SCVMCheckpoint Get-SCVMCheckpoint.