Partager via

Stop-SCVirtualMachine

  • Référence
Module:
VirtualMachineManager

Arrête les machines virtuelles gérées par VMM.

Syntaxe

Stop-SCVirtualMachine
    [-VM] <VM>
    [-Shutdown]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]
Stop-SCVirtualMachine
    [-VM] <VM>
    [-SaveState]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]
Stop-SCVirtualMachine
    [-VM] <VM>
    [-DiscardSavedState]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]
Stop-SCVirtualMachine
    [-VM] <VM>
    [-Force]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

Description

L’applet de commande Stop-SCVirtualMachine arrête une ou plusieurs machines virtuelles en cours d’exécution sur des hôtes gérés par Virtual Machine Manager (VMM) et retourne l’objet de machine virtuelle dans un état arrêté.

Cette applet de commande arrête une machine virtuelle comme arrêter le système d’exploitation sur un ordinateur. Si vous spécifiez le paramètre Forcer, cette applet de commande arrête une machine virtuelle comme la désactivation d’un ordinateur.

Pour reprendre une machine virtuelle arrêtée, utilisez l’applet de commande Start-SCVirtualMachine.

Exemples

Exemple 1 : Arrêter une machine virtuelle spécifiée

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> Stop-SCVirtualMachine -VM $VM

La première commande obtient l’objet de machine virtuelle nommé VM01, puis stocke cet objet dans la variable $VM.

La deuxième commande arrête la machine virtuelle stockée dans $VM et affiche des informations sur l’objet arrêté.

Exemple 2 : Arrêter plusieurs machines virtuelles

PS C:\> $VMs = Get-SCVirtualMachine | where { $_.Name -match "VM" -and $_.Status -eq "Running" }
PS C:\> $VMs | Stop-SCVirtualMachine

La première commande obtient tous les objets de machine virtuelle dont le nom contient la chaîne VMM et dont l’état actuel est en cours d’exécution. La commande stocke ensuite ces objets dans le tableau $VMs.

La deuxième commande transmet chaque objet de machine virtuelle stocké dans $VMs à l’applet de commande actuelle, ce qui arrête chaque machine virtuelle. La commande affiche des informations sur les machines virtuelles arrêtées.

Paramètres

-DiscardSavedState

Indique que cette applet de commande supprime l’état enregistré associé à une machine virtuelle.

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

-Force

Indique que cette applet de commande arrête une machine virtuelle comme la désactivation d’un ordinateur.

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

-JobVariable

Spécifie une variable dans laquelle la progression du travail est suivie et stockée.

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 un nom d’utilisateur. Cette applet de commande fonctionne pour le compte de l’utilisateur que ce paramètre spécifie.

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. Pour obtenir un rôle d’utilisateur, utilisez la cmdlet Get-SCUserRole. Cette applet de commande fonctionne pour le compte du rôle d’utilisateur spécifié par ce paramètre.

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

-SaveState

Indique que cette applet de commande enregistre l’état d’une machine virtuelle.

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

-Shutdown

Indique que cette applet de commande arrête une machine virtuelle. Cette applet de commande utilise le système d’exploitation pour arrêter la machine virtuelle correctement.

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

-VM

Spécifie un objet de machine virtuelle.

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

Sorties

VirtualMachine

Cette applet de commande retourne un objet VirtualMachine.

Notes

  • Cette applet de commande nécessite un objet de machine virtuelle, qui peut être récupéré à l’aide de l’applet de commande get-SCVirtualMachine .