Resume-SCVirtualMachine

Resume-SCVirtualMachine

Resumes paused virtual machines managed by VMM.

Syntax

Parameter Set: Default
Resume-SCVirtualMachine [-VM] <VM> [-JobVariable <String> ] [-OnBehalfOfUser <System.String> ] [-OnBehalfOfUserRole <Microsoft.SystemCenter.VirtualMachineManager.UserRole> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [ <CommonParameters>]

Detailed Description

The Resume-SCVirtualMachine cmdlet resumes one or more paused virtual machines managed by Virtual Machine Manager (VMM). A paused virtual machine is one that has been suspended by using the Suspend-SCVirtualMachine cmdlet. Using the Resume-SCVirtualMachine cmdlet to resume a virtual machine returns its object in a Running state. When the virtual machine is running again, the user can resume activity on that virtual machine.

If you run Resume-SCVirtualMachine on a virtual machine that is already running, the cmdlet returns an error message indicating that the virtual machine is not in a state that Resume-SCVirtualMachine can act on.

Parameters

-JobVariable<String>

Specifies that job progress is tracked and stored in the variable named by this parameter.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-OnBehalfOfUser<System.String>

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-OnBehalfOfUserRole<Microsoft.SystemCenter.VirtualMachineManager.UserRole>

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-PROTipID<Guid]>

Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-RunAsynchronously

Indicates that the job runs asynchronously so that control returns to the command shell immediately.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-VM<VM>

Specifies a virtual machine object.

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

  • VirtualMachine

Notes

  • This cmdlet requires a virtual machine object, which can be retrieved by using the Get-SCVirtualMachine cmdlet.

Examples

Example 1: Resume a paused virtual machine

The first command gets the virtual machine object named VM01, and then stores the object in the $VM variable. This example assumes that the virtual machine is in a paused state.

The second command resumes the virtual machine stored in $VM to a running state, and displays information about the object to the user.

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

Example 2: Resume all paused virtual machines

The first command gets all virtual machine objects from VMMServer01 that are paused, and then stores the objects in the $VMs object array.

The second command passes each object stored in $VMs to Resume-SCVirtualMachine by using the pipeline operator. The command resumes each virtual machine to a running state.

PS C:\> $VMs = Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" | where {$_.Status -eq "Paused"}
PS C:\> $VMs | Resume-SCVirtualMachine

Get-SCVirtualMachine

Move-SCVirtualMachine

New-SCVirtualMachine

Read-SCVirtualMachine

Register-SCVirtualMachine

Remove-SCVirtualMachine

Repair-SCVirtualMachine

Reset-SCVirtualMachine

Set-SCVirtualMachine

Start-SCVirtualMachine

Stop-SCVirtualMachine

Suspend-SCVirtualMachine