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: Ansible Windows Server 2025 Automation: WinRM, PSRP, Active Directory, IIS, Hyper-V Complete Guide

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/

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:

Resources

• Ansible Automation Hub
• Ansible Forum

Related Articles

• discovering content via Ansible Galaxy
• Ansible for Windows guide
• Ansible Windows Server 2025 Automation: WinRM, PSRP, Active Directory, IIS, Hyper-V Complete Guide

See also: Ansible on Hyper-V on Windows Server 2025 Automation Complete 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"

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

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.