Partager via

Stop-SCVirtualMachine

  • Référence
Module:
VirtualMachineManager

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

Syntax

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 l’arrêt du système d’exploitation sur un ordinateur. Si vous spécifiez le paramètre Force , 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
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

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

-JobVariable

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUserRole

Spécifie un rôle d’utilisateur. Pour obtenir un rôle d’utilisateur, utilisez l’applet de commande 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
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

-SaveState

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

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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 avec grâce.

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

-VM

Spécifie un objet ordinateur virtuel.

Type:VM
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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 .