Partager via


Set-SCVMCheckpoint

Modifie les propriétés d’un objet de point de contrôle de machine virtuelle dans VMM.

Syntax

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

Description

L’applet de commande Set-SCVMCheckpoint modifie les propriétés d’un objet de point de contrôle de machine virtuelle dans Virtual Machine Manager (VMM).

Pour plus d’informations sur la création de points de contrôle VMM, tapez Get-Help New-SCVMCheckpoint -Detailed.

Exemples

Exemple 1 : Définir la description de tous les points de contrôle sur une chaîne spécifiée

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

Cette commande obtient tous les objets de point de contrôle existants de la base de données VMM et met à jour la description de ces points de contrôle.

Exemple 2 : Modifier le nom et la description de tous les points de contrôle

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

Cette commande obtient tous les objets de point de contrôle existants et modifie le nom et la description de chaque objet.

Exemple 3 : Modifier un point de contrôle spécifique dans un tableau de points de contrôle

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

La première commande obtient l’objet de machine virtuelle nommé VM03 et stocke l’objet dans la variable $VM.

La dernière commande modifie la description du premier objet de point de contrôle dans le tableau VMCheckpoints pour VM03.

Paramètres

-Description

Spécifie une description d’un point de contrôle.

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

-JobVariable

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

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

-Name

Spécifie le nom d’un objet VMM.

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

-OnBehalfOfUser

Spécifie le nom d'un utilisateur. Cette applet de commande définit le nom de l’utilisateur comme utilisateur spécifié par ce paramètre.

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

-OnBehalfOfUserRole

Spécifie un rôle d’utilisateur. Cette applet de commande définit le rôle d’utilisateur au nom 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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

Spécifie l’ID du conseil d’optimisation des performances et des ressources qui a déclenché cette action. Ce paramètre vous permet d’auditer les conseils PRO.

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

-RunAsynchronously

Indique que le travail s’exécute de manière asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.

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

-VMCheckpoint

Spécifie un objet point de contrôle d’un ordinateur virtuel VMM.

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

Sorties

VMCheckpoint

Cette applet de commande retourne un objet VMCheckpoint .

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 .