Compartilhar via

Stop-SCVirtualMachine

  • Referência
Módulo:
VirtualMachineManager

Interrompe máquinas virtuais gerenciadas pelo VMM.

Sintaxe

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

O cmdlet Stop-SCVirtualMachine interrompe uma ou mais máquinas virtuais em execução em hosts gerenciados pelo VMM (Virtual Machine Manager) e retorna o objeto da máquina virtual em um estado parado.

Esse cmdlet interrompe uma máquina virtual, assim como desligar o sistema operacional em um computador. Se você especificar o parâmetro Force, esse cmdlet interromperá uma máquina virtual, assim como desativar um computador.

Para retomar uma máquina virtual parada, use o cmdlet Start-SCVirtualMachine.

Exemplos

Exemplo 1: Parar uma máquina virtual especificada

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

O primeiro comando obtém o objeto de máquina virtual chamado VM01 e armazena esse objeto na variável $VM.

O segundo comando interrompe a máquina virtual armazenada em $VM e exibe informações sobre o objeto parado.

Exemplo 2: parar várias máquinas virtuais

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

O primeiro comando obtém todos os objetos de máquina virtual cujo nome contém o VMM de cadeia de caracteres e cujo status atual está em execução. Em seguida, o comando armazena esses objetos na matriz $VMs.

O segundo comando passa cada objeto de máquina virtual armazenado em $VMs para o cmdlet atual, que interrompe cada máquina virtual. O comando exibe informações sobre as máquinas virtuais paradas.

Parâmetros

-DiscardSavedState

Indica que esse cmdlet exclui o estado salvo associado a uma máquina virtual.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Force

Indica que esse cmdlet interrompe uma máquina virtual, assim como desativar um computador.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-JobVariable

Especifica uma variável na qual o progresso do trabalho é acompanhado e armazenado.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OnBehalfOfUser

Especifica um nome de usuário. Esse cmdlet opera em nome do usuário especificado por esse parâmetro.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OnBehalfOfUserRole

Especifica uma função de usuário. Para obter uma função de usuário, use o cmdlet Get-SCUserRole. Esse cmdlet opera em nome da função de usuário especificada por esse parâmetro.

Tipo:UserRole
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PROTipID

Especifica a ID da dica de Otimização de Recursos e Desempenho (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RunAsynchronously

Indica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SaveState

Indica que esse cmdlet salva o estado de uma máquina virtual.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Shutdown

Indica que esse cmdlet desliga uma máquina virtual. Esse cmdlet usa o sistema operacional para desligar a máquina virtual normalmente.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VM

Especifica um objeto de máquina virtual.

Tipo:VM
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Saídas

VirtualMachine

Esse cmdlet retorna um objeto VirtualMachine.

Observações

  • Esse cmdlet requer um objeto de máquina virtual, que pode ser recuperado usando o cmdlet Get-SCVirtualMachine.