microsoft.hyperv 1.0.0 — First Certified Ansible Collection for Hyper-V

microsoft.hyperv 1.0.0 — First Certified Collection

microsoft.hyperv 1.0.0 has been certified and published on Ansible Automation Hub, marking the first official Ansible collection for Microsoft Hyper-V management.

See also: Run Windows 11 Client ARM64 Insider Preview in Apple Silicon (M1, M2, M3) with VMware Fusion

What This Means

This certified collection provides officially supported modules for managing Hyper-V virtual infrastructure through Ansible, including: • Virtual machine lifecycle management • Virtual network configuration • Virtual disk management • Hyper-V host configuration

How to Install

From Ansible Automation Hub (with a Red Hat subscription):

ansible-galaxy collection install microsoft.hyperv --server https://console.redhat.com/api/automation-hub/

See also: Ansible Windows Server 2025 Automation: WinRM, PSRP, Active Directory, IIS, Hyper-V Complete Guide

Why It Matters

Hyper-V is widely used in enterprise Windows environments. Having an officially certified collection means: • Tested and validated against Ansible Automation Platform • Supported by Microsoft as the collection maintainer • Consistent lifecycle aligned with Ansible certification requirements • Enterprise-ready for production use cases

Certified Collections This Week

Other collections also updated on Automation Hub this week:

| Collection | Version | |------------|---------| | chocolatey.chocolatey | 1.6.0 | | cisco.intersight | 2.16.0 | | cisco.meraki | 2.23.1 | | cyberark.isp | 1.0.7 | | cyberark.pas | 1.0.39 | | ibm.power_hmc | 1.15.0 | | microsoft.hyperv | 1.0.0 | | netscaler.adc | 2.16.0 | | redhat.amq_streams | 1.0.1 | | redhat.artifact_signer | 1.3.3 | | redhat.jbcs | 1.1.4 | | redhat.jws | 2.1.2 | | redhat.openshift_virtualization | 2.2.4 | | redhat.runtimes_common | 1.2.3 | | redhat.satellite_operations | 4.0.0 | | redhat.sso | 2.0.1 |

See also: Ansible on Hyper-V on Windows Server 2025 Automation Complete Guide

Resources

• Ansible Automation Hub • Ansible Forum

Related Articles

• discovering content via Ansible Galaxy • Ansible for Windows guide

Installing the Collection

ansible-galaxy collection install microsoft.hyperv

Managing Hyper-V VMs with Ansible

- name: Manage Hyper-V virtual machines
  hosts: hyperv_hosts
  tasks:
    - name: Create a new VM
      microsoft.hyperv.win_hyperv_guest:
        name: test-vm
        generation: 2
        memory: 4GB
        cpu_count: 2
        state: present
- name: Attach virtual disk
      microsoft.hyperv.win_hyperv_guest:
        name: test-vm
        hard_drives:
          - path: 'C:\VMs\test-vm\disk.vhdx'
            size: 50GB
- name: Start VM
      microsoft.hyperv.win_hyperv_guest:
        name: test-vm
        state: running
- name: Configure VM network adapter
      microsoft.hyperv.win_hyperv_guest:
        name: test-vm
        network_adapters:
          - name: "Default Switch"
            switch_name: "Default Switch"

Hyper-V Host Configuration

- name: Configure Hyper-V host
  hosts: hyperv_hosts
  tasks:
    - name: Ensure Hyper-V feature is enabled
      ansible.windows.win_feature:
        name: Hyper-V
        include_management_tools: true
        state: present
      register: hyperv_install
- name: Reboot if needed
      ansible.windows.win_reboot:
      when: hyperv_install.reboot_required
- name: Create virtual switch
      ansible.windows.win_shell: |
        New-VMSwitch -Name "Production" -NetAdapterName "Ethernet" -AllowManagementOS $true
      register: result
      changed_when: "'already exists' not in result.stderr"
      failed_when: false

FAQ

What is the microsoft.hyperv collection?

It is the first certified Ansible collection for managing Microsoft Hyper-V infrastructure. It provides modules for creating, configuring, and managing VMs, virtual switches, and virtual hard disks.

Do I need WinRM configured on the Hyper-V host?

Yes. Ansible manages Windows hosts via WinRM. Enable WinRM on the Hyper-V host and configure ansible_connection=winrm in your inventory.

Can I manage Hyper-V on Windows Server and Windows 10/11?

Yes. The collection works with Hyper-V on both Windows Server (2016, 2019, 2022) and Windows 10/11 Pro/Enterprise with the Hyper-V feature enabled.