Set-SCVMCheckpoint
Modifie les propriétés d’un objet de point de contrôle de machine virtuelle dans VMM.
Syntaxe
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 |
| 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 |
-Name
Spécifie le nom d’un objet VMM.
| 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 |
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
Get-SCVMCheckpoint.