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