Microsoft Hyper-V VMs

The VMs tab shows virtual machines from the latest Microsoft Hyper-V inventory collected on a Windows host endpoint. The tab appears when the latest inventory contains at least one virtual machine.

Validation scope

Hyper-V inventory, management, media, and console access have been validated on a standalone Hyper-V host. Failover clusters, Cluster Shared Volumes (CSV), System Center Virtual Machine Manager (SCVMM), and live-migration workflows have not been validated.

Permissions

Assign both of these fixed roles for the same tenant or folder scope:

• Endpoint Viewer grants access to the Hyper-V host endpoint and its stored inventory.
• Hyper-V Operator grants Hyper-V inventory collection, power and snapshot actions, VM and DVD modification, ISO media operations, and console access.

All permissions are evaluated against the Hyper-V host endpoint. Access to a mapped guest endpoint alone does not grant access to host inventory, host file paths, or the VM console.

Platform Admin also contains the required product permissions.

Collect inventory

Run Collect Microsoft Hyper-V VM inventory on the Windows Hyper-V host, or use the recollect action on the VMs tab.

VM list and details

The VM table shows:

• VM name and ID
• mapped guest endpoint
• current state
• virtual processor count
• assigned memory
• uptime
• generation

Select the VM name, or select View details as the first item in its action menu, to open the read-only details panel.

Power actions

Available VM power actions depend on the capabilities advertised by the connected host Agent:

• Start
• Shut down
• Reboot
• Stop

Shut down requests a graceful guest shutdown. It depends on the guest operating system and Hyper-V integration services.

Stop turns the VM off without a guest shutdown. Treat it as a force-off action and prefer Shut down when the guest should close cleanly.

Snapshots and checkpoints

Select Manage snapshots to create and manage Hyper-V snapshots, also called checkpoints.

Applying a snapshot can discard current VM state. For a healthy running VM, Ordyn turns the VM off without a guest shutdown, applies the selected snapshot, and starts the VM again. If applying the snapshot fails after power-off, the VM remains off so an operator can inspect it before starting it manually. If the snapshot is applied but the VM cannot be restarted, the action reports that partial failure and the VM remains off.

A VM that is off, saved, or suspended can be restored directly and is not started automatically by Ordyn. A paused VM must be started or stopped before applying a snapshot. Ordyn rejects the operation when the VM is unhealthy, in a transitional state, or reports an unknown state.

Deleting a snapshot removes only the selected snapshot. Hyper-V keeps dependent snapshots and merges the selected snapshot's checkpoint data. Snapshot failures include additional host diagnostics when Hyper-V provides them.

Snapshot names are not guaranteed to be unique. Interactive actions target the selected snapshot ID. Snapshot job steps that use a name follow the matching rules described under Microsoft Hyper-V job tasks.

The snapshot list refreshes after a successful instruction result. Recollect inventory if the snapshot was changed outside Ordyn.

Rename and DVD media

Select Modify virtual machine to rename the VM and manage its virtual DVD drives.

Adding or removing a DVD drive requires the VM to be off. ISO media can be inserted or ejected while the VM is running when Hyper-V permits it.

For an empty DVD drive, select Insert ISO and choose either:

• an approved, clean ISO file stored in Ordyn
• operating-system install media configured in Ordyn

Ordyn prepares the selected media for the host before issuing the insert instruction.

An inserted ISO can be ejected from the same panel. Remove a virtual DVD drive only after its media has been ejected.

Console access

Select Open console to open the VM display in a separate browser window. Allow popups for the Ordyn site.

The console uses the Hyper-V VMConnect Basic Session display. It mirrors the VM's console and does not use Enhanced Session mode. A local VMConnect window configured for Enhanced Session can therefore show a resolution prompt or a different Windows sign-in session from the Basic Session console.

Hyper-V can interrupt or replace an existing Basic Session display when another Basic VMConnect client opens the same VM. Close competing local VMConnect windows if the Ordyn display is disconnected.

The console has three cursor modes:

Auto selects the pointer mode advertised by the VM display. Use Absolute when the pointer should track the visible desktop position. Use Relative for captured mouse movement; click the console to capture the pointer and press Escape to release it.

A console session has a four-hour maximum duration and a 15-minute idle timeout. At most four active Hyper-V console sessions can run on one host endpoint. Sessions also close when the host Agent disconnects, the VM disappears from current inventory, the operator loses console permission, or the operator selects Disconnect.

The guest does not need an Ordyn Agent for console access.

The Hyper-V host endpoint requires a Relay assignment. It uses the nearest configured folder Relay route, then its tenant Relay route. If neither scope has assignments, Open console is unavailable. A configured route with no connected, compatible Relay service client that has capacity causes Open console to fail without using another scope. Configure and inspect these assignments from Service routing on the tenant or endpoint folder. An active console session remains on the Relay selected when it started.

Actions on mapped guest endpoints

Ordyn tries to map each inventoried VM to an endpoint. When a match exists, the guest endpoint page exposes the host-backed controls without requiring the operator to navigate to the host first.

The guest endpoint power menu includes supported Hyper-V power actions with an (HV) suffix. The Hyper-V menu appears after the normal Endpoint menu and can contain:

• View details
• Open console
• Manage snapshots
• Modify virtual machine

View details is shown only when the current user can read the mapped Hyper-V host. Each operational action also requires its corresponding host-scoped Hyper-V permission and a capable connected host Agent.

Guest endpoint identification

Ordyn identifies a VM only when its SMBIOS/DMI UUID matches exactly one endpoint's current system UUID. The guest endpoint's current system UUID comes from its hardware inventory. Run Collect hardware inventory on each guest endpoint at least once before relying on matching. The inventory must report a valid system UUID; a completed collection without one cannot identify the guest.

Hardware inventory and Hyper-V inventory can be collected in either order. If guest hardware inventory is collected after the host's VM inventory, Ordyn evaluates the stored VM again automatically.

Identification states are:

• identified: exactly one endpoint matched
• ambiguous: multiple endpoints matched the same evidence
• unidentified: no endpoint matched

Ordyn does not link ambiguous matches. Correct duplicate or stale endpoint identity data, then recollect the Hyper-V inventory.

When a VM is identified, the VM table links to the guest endpoint. The guest overview also identifies the Hyper-V host and VM.

Endpoint jobs on the Hyper-V host can use {{ endpoint.hyperv_guest_endpoint_ids }} to obtain the endpoint IDs of all identified guests from the latest inventory.

Job tasks

Hyper-V inventory, power, and snapshot operations are also available as job tasks:

• Collect Microsoft Hyper-V VM inventory
• Start Microsoft Hyper-V VM
• Shut down Microsoft Hyper-V VM
• Reboot Microsoft Hyper-V VM
• Stop Microsoft Hyper-V VM
• Create Microsoft Hyper-V VM snapshot
• Delete Microsoft Hyper-V VM snapshot
• Apply Microsoft Hyper-V VM snapshot

The editor selects a VM from current inventory and stores its Hyper-V VM ID. Snapshot-name fields support templating.

See Available Tasks for the job-task reference.

Ordyn infrastructure hosts

If the Hyper-V host runs or hosts Ordyn infrastructure, enable Ordyn hypervisor host in Edit endpoint and select the Ordyn infrastructure endpoints hosted by it.

This setting provides topology and recovery context for infrastructure maintenance.