Remote control a virtual machine on a (remote) Hyper-V Server. The Azure Pipelines task supports start and stop a virtual machine plus create, restore and delete Hyper-V snapshots (without SCVMM).
Requirements
Build Agent must have Hyper-V PowerShell cmdlets installed (no SCVMM needed)
Hyper-V PowerShell cmdlets must be compatible with your Hyper-V server (please check Microsoft Hyper-V documention)
Build Agent service user must be member of "Hyper-V Administrators" group on (remote) Hyper-V server
Configuration
Add VM name(s) and the host name to start or stop a VM
Additionally a snapshot name required to create, restore or delete snapshots
Changelog
Changes since 5.1.65: Replaced DISM based HyperV PowerShell cmdlet check; refactored code, removed preview state
Changes since 5.1.70: Added author to task.json
Changes since 6.0.0: Added support for multiple VMs names in one build step, added support for deleting snapshots, code refactoring and cleanup
Changes since 6.0.8: Added information about data protection
Changes since 6.1.0: Adapted Azure DevOps rebranding in certain files/places, opensourced version on GitHub
Changes since 7.0.0: Moved from Powershell to Powershell3 execution handler, added direct turn off of VMs, renamed action StopVM to ShutdownVM, fixed bug in vmeventing (missing parameter), refactored code based on PSScriptAnalyzer
Changes since 7.0.36: Removed non-existent parameter for hyperv cmdlet version 1.0 (only affects old hyper-v versions -> pre Win 2016)
Changes since 7.0.62: Added additional support for older hyperv cmdlet version 1.1 (only affects old hyper-v versions -> pre Win 2016)
Changes since 7.0.66: Fixed loading of older cmdlet versions, added some additional debug outputs (could be enabled with system.debug = true)
Changes since 8.0.0: Removed old TFS legacy versions, in the future only support for AzD pipelines, taking over the maintenance from AIT
Known limitions
Additional Links
Privacy information
This extension operates completely locally and does not process any personal data on external computers.
For general information on data protection, please refer to our data protection declaration.
