hyper-v-ops

Diagnose, configure, and operate Hyper-V VMs, switches, storage, and clusters via PowerShell.

5|15|Updated Jul 8, 2026
One-click install
npx skills add https://github.com/clfigueiredo/hermes-infra-skills --skill hyper-v-ops-clfigueiredo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hyper-v-ops
Source: https://github.com/clfigueiredo/hermes-infra-skills/tree/main/.hermes/skills/forumtelecom/hyper-v-ops
Command: npx skills add https://github.com/clfigueiredo/hermes-infra-skills --skill hyper-v-ops-clfigueiredo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Microsoft Hyper-V hosts remotely is error-prone: a wrong checkpoint deletion, forced power-off, or switch change can take down production VMs. This Skill provides a structured, safety-first operational playbook for Hyper-V administration with mandatory snapshot-before-change and confirmation workflows. ## Core Features & Use Cases - Full VM lifecycle management: create Gen 2 VMs, manage checkpoints (production vs standard), graceful start/stop/restart, export/import, and live migration between hosts. - Networking and storage operations: configure virtual switches, VLANs, NAT networks, SET teaming, and VHD/VHDX creation, resizing, and conversion. - Cluster, Replica, and monitoring support: manage Failover Cluster CSVs, Hyper-V Replica health, resource metering, and event-log-based troubleshooting. - Use Case: A provider technician is asked to restart a production VM and add VLAN 200 to it. The Skill guides them to inventory the host, take a production checkpoint, apply the VLAN change with Set-VMNetworkAdapterVlan, validate the VM state, and produce a structured report with rollback commands. ## Quick Start Ask the agent to list all VMs and their state on your Hyper-V host, then request a specific operation such as creating a checkpoint before restarting a named VM.

Frequently Asked Questions about hyper-v-ops

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I safely restart a Hyper-V VM in production?▼

First inventory the VM with Get-VM, then create a production checkpoint with Checkpoint-VM, and use Restart-VM for a graceful restart via integration services. Validate afterward with Get-VM and Get-VMIntegrationService, and only use Stop-VM -Force after explicit confirmation.

How to create a Generation 2 VM with PowerShell?▼

Use New-VM with -Generation 2, -MemoryStartupBytes, -NewVHDPath, and -SwitchName, then adjust with Set-VMProcessor, Set-VMMemory, and Add-VMDvdDrive for the ISO. Generation 2 supports UEFI, Secure Boot, and vTPM for modern Windows and Linux guests.

What is the difference between production and standard checkpoints?▼

Production checkpoints use VSS or fsfreeze to create application-consistent snapshots and are preferred for production workloads. Standard checkpoints capture full memory state and are better suited for labs and testing rollback scenarios.

Can I manage Hyper-V remotely over SSH or PowerShell Remoting?▼

Yes, the Skill supports WinRM/PowerShell Remoting via Invoke-Command and OpenSSH on Windows hosts running powershell -NoProfile commands. PowerShell Direct also works from the host into supported Windows guests using Enter-PSSession -VMName.

Why won't my Hyper-V VM start and how do I troubleshoot it?▼

Inspect the VM with Get-VM and Get-VMHardDiskDrive, then review the Hyper-V-Worker-Admin and Hyper-V-VMMS-Admin event logs. Common causes include missing VHDX files, invalid virtual switches, insufficient memory, corrupted saved state, or checkpoint merges in progress.

When should I not use this Hyper-V skill?▼

Do not use it for Proxmox, VMware ESXi/vCenter, KVM/libvirt, or Docker operations, which have dedicated skills. It also does not cover physical Windows Server tasks unrelated to virtualization or password recovery and AD security bypass.