Stop-SCVirtualMachine

  • Referência
Módulo:
VirtualMachineManager

Para as máquinas virtuais geridas por 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

O cmdlet Stop-SCVirtualMachine para uma ou mais máquinas virtuais em funcionamento em anfitriões geridas pelo Virtual Machine Manager (VMM) e devolve o objeto da máquina virtual num estado parado.

Este cmdlet para uma máquina virtual tal como desligar o sistema operativo de um computador. Se especificar o parâmetro Force , este cmdlet para uma máquina virtual tal como desligar um computador.

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

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 recebe o objeto da máquina virtual chamado VM01, e depois armazena esse objeto na variável $VM.

O segundo comando para a máquina virtual armazenada em $VM e apresenta 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 virtuais cujo nome contém o VMM de cadeia e cujo estado atual está funcionando. 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 para cada máquina virtual. O comando apresenta informações sobre as máquinas virtuais paradas.

Parâmetros

-DiscardSavedState

Indica que este cmdlet elimina o estado guardado associado a uma máquina virtual.

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

-Force

Indica que este cmdlet para uma máquina virtual tal como desligar um computador.

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

-JobVariable

Especifica uma variável em que o progresso do trabalho é rastreado e armazenado.

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

-OnBehalfOfUser

Especifica um nome de utilizador. Este cmdlet funciona em nome do utilizador que este parâmetro especifica.

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

-OnBehalfOfUserRole

Especifica uma função de utilizador. Para obter uma função de utilizador, utilize o cmdlet Get-SCUserRole . Este cmdlet funciona em nome da função de utilizador que este parâmetro especifica.

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

-PROTipID

Especifica o ID da ponta de otimização de desempenho e recursos (ponta PRO) que desencadeou esta ação. Este parâmetro permite-lhe auditar dicas PRO.

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

-RunAsynchronously

Indica que o trabalho funciona assíncronamente para que o controlo volte imediatamente à concha de comando.

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

-SaveState

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

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

-Shutdown

Indica que este cmdlet desliga uma máquina virtual. Este cmdlet utiliza o sistema operativo para desligar graciosamente a máquina virtual.

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

-VM

Especifica um objeto de máquina virtual.

Type:VM
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Saídas

VirtualMachine

Este cmdlet devolve um objeto VirtualMachine .

Notas

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