Start-SCVirtualMachine
Inicia uma máquina virtual gerenciada pelo VMM.
Sintaxe
Start-SCVirtualMachine
[-VM] <VM>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Description
O cmdlet Start-SCVirtualMachine inicia uma ou mais máquinas virtuais em hosts gerenciados pelo VMM (Virtual Machine Manager) quando as máquinas estão em um estado parado. Esse cmdlet restaura uma máquina virtual parada para um estado em execução e retorna um objeto que a representa em um estado em execução. Depois de iniciar a máquina virtual, você pode retomar a atividade nessa máquina virtual.
Se você executar esse cmdlet em uma máquina virtual que já está em execução, ele retornará o objeto, mas não alterará o estado da máquina virtual.
Para interromper uma máquina virtual em execução, use o cmdlet Stop-SCVirtualMachine.
Exemplos
Exemplo 1: iniciar uma máquina virtual que está desativada
PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> Start-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 inicia a máquina virtual armazenada em $VM e exibe informações sobre o objeto de máquina virtual em execução.
Exemplo 2: iniciar todas as máquinas virtuais que estão desativadas
PS C:\> $VMs = Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" | where { $_.Status -eq "PowerOff" }
PS C:\> $VMs | Start-SCVirtualMachine
O primeiro comando obtém todos os objetos de máquina virtual no VMMServer01 que estão em um estado parado e armazena esses objetos na matriz $VMs.
O segundo comando passa cada máquina virtual em $VMs para o cmdlet atual, que inicia cada máquina virtual.
Parâmetros
-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 |
-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
Observações
- Esse cmdlet requer um objeto de máquina virtual, que pode ser recuperado usando o Get-SCVirtualMachinecmdlet.