Public/Invoke-Power.ps1
|
function Invoke-Power { <# .DESCRIPTION Use to alter VM Power states and reboot VM's. .PARAMETER PowerCycleVM Specifies the VM should be Power Cycled .PARAMETER RestartGuest Specifies the VM guest should be restarted .PARAMETER PowerOffGuest Specifies the VM guest should be Powered off .PARAMETER PowerOffVM Specifies the VM should be Powered off .PARAMETER PowerOnVM Specifies the VM should be Powered on .PARAMETER VM Specifies the VM Name .EXAMPLE Gracefully Restart the Guest Invoke-Power -restartguest -VM vmname .EXAMPLE Gracefully shutdown the Guest Invoke-Power -poweroffguest -VM vmname .EXAMPLE Hard Power Cycle VM Invoke-Power -powercycle -VM vmname .EXAMPLE Hard Power Off Vm Invoke-Power -poweroff -VM vmname .EXAMPLE Hard power on VM Invoke-Power -poweron -VM vmname .NOTES Requires the VMware.PowerCLI Module .Link https://github.com/TheTaylorLee/AdminToolbox #> [CmdletBinding()] Param ( [Parameter(Mandatory = $true, ParameterSetName = 'Power Cycle VM')][switch]$powercyclevm, [Parameter(Mandatory = $true, ParameterSetName = 'Restart Guest')][switch]$restartguest, [Parameter(Mandatory = $true, ParameterSetName = 'Power Off Guest')][switch]$poweroffguest, [Parameter(Mandatory = $true, ParameterSetName = 'Power Off VM')][switch]$poweroffvm, [Parameter(Mandatory = $true, ParameterSetName = 'Power On VM')][switch]$poweronvm, [Parameter(Mandatory = $true, ValueFromPipeline = $true, ParameterSetName = 'Power Cycle VM')] [Parameter(Mandatory = $true, ValueFromPipeline = $true, ParameterSetName = 'Restart Guest')] [Parameter(Mandatory = $true, ValueFromPipeline = $true, ParameterSetName = 'Power Off Guest')] [Parameter(Mandatory = $true, ValueFromPipeline = $true, ParameterSetName = 'Power Off VM')] [Parameter(Mandatory = $true, ValueFromPipeline = $true, ParameterSetName = 'Power On VM')] $VM ) if ($powercyclevm) { Restart-VM -VM $VM -RunAsync -Confirm:$true } if ($restartguest) { Restart-VMGuest -VM $VM -Confirm:$false } if ($poweroffguest) { Shutdown-VMGuest -VM $VM -Confirm:$false } if ($poweroffvm) { Stop-VM -VM $vm -RunAsync -Confirm:$true } if ($poweronvm) { Start-VM -VM $VM -RunAsync -Confirm:$false } } |