Compartir a través de

Stop-SCVirtualMachine

  • Referencia
Módulo:
VirtualMachineManager

Detiene las máquinas virtuales administradas por VMM.

Sintaxis

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

El cmdlet Stop-SCVirtualMachine detiene una o varias máquinas virtuales en ejecución en hosts administrados por Virtual Machine Manager (VMM) y devuelve el objeto de máquina virtual en un estado detenido.

Este cmdlet detiene una máquina virtual igual que apagar el sistema operativo en un equipo. Si especifica el parámetro Force, este cmdlet detiene una máquina virtual igual que desactivar un equipo.

Para reanudar una máquina virtual detenida, use el cmdlet Start-SCVirtualMachine.

Ejemplos

Ejemplo 1: Detener una máquina virtual especificada

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

El primer comando obtiene el objeto de máquina virtual denominado VM01 y, a continuación, almacena ese objeto en la variable $VM.

El segundo comando detiene la máquina virtual almacenada en $VM y muestra información sobre el objeto detenido.

Ejemplo 2: Detener varias máquinas virtuales

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

El primer comando obtiene todos los objetos de máquina virtual cuyo nombre contiene la cadena VMM y cuyo estado actual es En ejecución. A continuación, el comando almacena esos objetos en la matriz $VMs.

El segundo comando pasa cada objeto de máquina virtual almacenado en $VMs al cmdlet actual, que detiene cada máquina virtual. El comando muestra información sobre las máquinas virtuales detenidas.

Parámetros

-DiscardSavedState

Indica que este cmdlet elimina el estado guardado asociado a una máquina virtual.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Force

Indica que este cmdlet detiene una máquina virtual igual que desactivar un equipo.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-JobVariable

Especifica una variable en la que se realiza un seguimiento del progreso del trabajo y se almacena.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-OnBehalfOfUser

Especifica un nombre de usuario. Este cmdlet funciona en nombre del usuario que especifica este parámetro.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-OnBehalfOfUserRole

Especifica un rol de usuario. Para obtener un rol de usuario, use el cmdlet Get-SCUserRole. Este cmdlet funciona en nombre del rol de usuario que especifica este parámetro.

Tipo:UserRole
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PROTipID

Especifica el identificador de la sugerencia Sobre rendimiento y optimización de recursos (sugerencia PRO) que desencadenó esta acción. Este parámetro le permite auditar sugerencias PRO.

Tipo:Guid
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RunAsynchronously

Indica que el trabajo se ejecuta de forma asincrónica para que el control vuelva al shell de comandos inmediatamente.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SaveState

Indica que este cmdlet guarda el estado de una máquina virtual.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Shutdown

Indica que este cmdlet cierra una máquina virtual. Este cmdlet usa el sistema operativo para apagar la máquina virtual correctamente.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-VM

Especifica un objeto de máquina virtual.

Tipo:VM
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

Salidas

VirtualMachine

Este cmdlet devuelve un objeto VirtualMachine.

Notas

  • Este cmdlet requiere un objeto de máquina virtual, que se puede recuperar mediante el cmdlet Get-SCVirtualMachine.