Skip to content
This repository has been archived by the owner on Apr 26, 2023. It is now read-only.

Latest commit

 

History

History
46 lines (37 loc) · 2.74 KB

Readme.md

File metadata and controls

46 lines (37 loc) · 2.74 KB

Note ! This pipeline task will go into an archived status and will no longer be maintained ! Nico Orschel will maintain a forked version that will also be published in the Azure DevOps Marketplace The fork can be found here.

Hyper-V Server task

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)
  • Documentation: Remotely manage Hyper-V -> Availability and compatibility and Hyper-V Module
  • 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)

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.