Skip to content

Commit b7db6b3

Browse files
authored
Update hyper-v-start-state-access-failures-clustered-standalone.md
Edit review per CI 8335
1 parent f0ad4fe commit b7db6b3

1 file changed

Lines changed: 28 additions & 28 deletions

File tree

support/windows-server/virtualization/hyper-v-start-state-access-failures-clustered-standalone.md

Lines changed: 28 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Inaccessible or Unresponsive Hyper-V Virtual Machines in Clustered or Standalone Environments Troubleshooting Guidance
3-
description: Helps you troubleshoot and fix Hyper-V virtual machines (VMs) that fail to start, become stuck in transitional states (such as starting, stopping, saved, or paused), or become inaccessible in both clustered and standalone environments.
3+
description: Troubleshoot Hyper-V virtual machines (VMs) that don't start, become stuck in transitional states, or become inaccessible in both clustered and standalone environments.
44
ms.date: 12/27/2025
55
manager: dcscontentpm
66
audience: itpro
@@ -13,17 +13,17 @@ ai-usage: ai-assisted
1313
appliesto:
1414
- <a href=https://learn.microsoft.com/windows/release-health/windows-server-release-info target=_blank>Supported versions of Windows Server</a>
1515
---
16-
# Inaccessible or unresponsive Hyper-V virtual machines in clustered or standalone environments troubleshooting guidance
16+
# Inaccessible or unresponsive Hyper-V VMs in clustered or standalone environments troubleshooting guidance
1717

18-
This article provides a detailed troubleshooting guide to help you troubleshoot and fix Hyper-V virtual machines (VMs) that fail to start, become stuck in transitional states (such as starting, stopping, saved, or paused), or become inaccessible in both clustered and standalone environments. Many of these issues produce similar symptoms even if they have different causes. For example, the same issue that causes a running VM to get "stuck" might prevent an offline VM from starting. Further, the symptoms might appear at different levels of your infrastructure, such as Hyper-V Manager or Failover Cluster Manager.
18+
This article provides a detailed guide to help you troubleshoot and fix Hyper-V virtual machines (VMs) that don't start, become "stuck" (stop responding) in transitional states (such as starting, stopping, saved, or paused), or become inaccessible in both clustered and standalone environments. Many of these issues produce similar symptoms even if they have different causes. For example, the same issue that causes a running VM to stop responding might prevent an offline VM from starting. Additionally, the symptoms might appear at different levels of your infrastructure, such as Hyper-V Manager or Failover Cluster Manager.
1919

2020
## Troubleshooting checklist
2121

2222
### Step 1: Identify the scope of the issue
2323

2424
1. Use Hyper-V Manager, Failover Cluster Manager, or Windows PowerShell to identify affected VMs, hosts, and cluster resources. Note any error messages.
2525
1. Make sure that VMs have unique GUIDs.
26-
1. If VMs are "stuck" in any of the following states, see [VM hangs or appears to be "stuck" in a transitional state (such as Starting, Stopping, or Restoring)](#vm-hangs-or-appears-to-be-stuck-in-a-transitional-state-such-as-starting-stopping-or-restoring).
26+
1. If VMs are stuck" in any of the following states, see [VM hangs or appears to be "stuck" in a transitional state (such as Starting, Stopping, or Restoring)](#vm-hangs-or-appears-to-be-stuck-in-a-transitional-state-such-as-starting-stopping-or-restoring).
2727
- Starting
2828
- Stopping
2929
- Saved-critical
@@ -38,31 +38,31 @@ This article provides a detailed troubleshooting guide to help you troubleshoot
3838
- [Event ID 1069](#event-id-1069-cluster-vm-failed-to-startcant-bring-a-resource-online)
3939
- [Event ID 1205](#event-id-1205-cant-bring-a-resource-online)
4040
- [Event ID 1135, Event ID 1795, Event ID 5257, and virtual machines are paused](#event-id-1135-event-id-1795-event-id-5257-and-virtual-machines-are-paused)
41-
- Event ID 1135. At a general level, Event ID 1135 indicates that one or more cluster nodes were removed from the active failover cluster membership. For more information about troubleshooting this issue, see [Troubleshoot cluster issue with Event ID 1135](../high-availability/troubleshoot-cluster-event-id-1135.md).
42-
- Event ID 5120. At a general level, Event ID 5120 indicates an issue that involves the cluster shared volume (CSV). For more information about troubleshooting this issue, see [Event ID 5120 Cluster Shared Volume troubleshooting guidance](../high-availability/event-id-5120-cluster-shared-volume-troubleshooting-guidance.md).
41+
- Event ID 1135. At a general level, Event ID 1135 indicates that one or more cluster nodes were removed from the active failover cluster membership. For more information about how to troubleshoot this issue, see [Troubleshoot cluster issue with Event ID 1135](../high-availability/troubleshoot-cluster-event-id-1135.md).
42+
- Event ID 5120. At a general level, Event ID 5120 indicates an issue that involves the cluster shared volume (CSV). For more information about how to troubleshoot this issue, see [Event ID 5120 Cluster Shared Volume troubleshooting guidance](../high-availability/event-id-5120-cluster-shared-volume-troubleshooting-guidance.md).
4343

44-
1. Note any recent changes or incidents that affected your infrastructure. Such changes include system or driver updates, or interruptions in power or network connectivity.
44+
1. Note any recent changes or incidents that affected your infrastructure. Such changes include system or driver updates, and interruptions in power or network connectivity.
4545
1. Note any unusual system activity, such as the following behavior:
4646

4747
- VMs repeatedly restart.
4848
- VMs don't live migrate successfully.
49-
- Clusters fail over, or don't fail over correctly.
49+
- Clusters fail over or don't fail over correctly.
5050
- Cluster resources are offline.
51-
1. Review the [Windows Server release information](/windows/release-health/windows-server-release-info) pages for the latest known issue and notification information.
52-
1. Contact your hardware vendors and other third-party vendors for information about updates and known issues.
51+
1. For the latest known issue and notification information, review the [Windows Server release information](/windows/release-health/windows-server-release-info) pages.
52+
1. For information about updates and known issues, contact your hardware vendors and other third-party vendors.
5353

5454
### Step 2: Make sure that the operating system and drivers are up to date
5555

5656
1. Make sure that your disk and network hardware drivers are up to date.
5757
1. Make sure that all servers have the latest Windows Update releases installed.
58-
1. In a clustered environment, for each cluster, make sure that all of the nodes in the cluster run the same Windows Server release.
58+
1. In a clustered environment, make sure that all the nodes in each cluster run the same Windows Server release.
5959

6060
### Step 3: Review the permission and security settings
6161

6262
Make sure that your security infrastructure accommodates Hyper-V. The following technologies can cause issues:
6363

6464
- Antivirus or third-party filter drivers interfere with Hyper-V by blocking file access or causing merge failures.
65-
- BitLocker-locked disks might prevent VMs from starting after updates or restarts. BitLocker also might block access to virtual machine files, preventing VMs from starting or responding.
65+
- BitLocker-locked disks might prevent VMs from starting after updates or restarts. BitLocker also might block access to virtual machine files. This behavior might prevent VMs from starting or responding.
6666

6767
1. Review the permissions of the Hyper-V service account. This account must have full control over VM files and folders.
6868
1. Review [Recommended antivirus exclusions for Hyper-V hosts](antivirus-exclusions-for-hyper-v-hosts.md), and make sure that the correct exclusions are in place.
@@ -81,10 +81,10 @@ Make sure that your security infrastructure accommodates Hyper-V. The following
8181
### Step 4: Review the storage subsystem and the file system
8282
8383
> [!IMPORTANT]
84-
> This section instructs you to run the `chkdsk /f /r` command. This command requires exclusive access to the target disk, and takes some time to complete.
84+
> This section instructs you to run the `chkdsk /f /r` command. This command requires exclusive access to the target disk, and takes some time to finish.
8585
8686
1. Use Disk Management or the [`diskpart`](/windows-server/administration/windows-commands/diskpart) tool to verify that all disk volumes are online and correctly assigned.
87-
1. If a disk volume is RAW or missing, reassign its drive letter and then use [`chkdsk`](/windows-server/administration/windows-commands/chkdsk) to repair the volume. Open an administrative Windows Command Prompt window, and then run the following command:
87+
1. If a disk volume is RAW or missing, reassign its drive letter, and then use [`chkdsk`](/windows-server/administration/windows-commands/chkdsk) to repair the volume. Open an administrative Windows Command Prompt window, and then run the following command:
8888
8989
```console
9090
chkdsk <DriveLetter>: /f /r
@@ -97,18 +97,18 @@ Make sure that your security infrastructure accommodates Hyper-V. The following
9797

9898
1. In the volume that hosts your VM files, review the contents of the VM folder. Make sure that the appropriate VM files (.vmcx (configuration), .vmrs (run-time state), .vhdx (disk), and .avhdx (differencing disk)) exist.
9999

100-
- If a VM's .vmcx file is missing or corrupt, use the .vhdx file to build a new VM (you can also restore the affected VM from a backup).
100+
- If a VM's .vmcx file is missing or corrupted, use the .vhdx file to build a new VM. You can also restore the affected VM from a backup.
101101
> [!NOTE]
102-
> When a configuration file is missing or corrupt, Hyper-V can't recognize or start the VM. Configuration files might be damaged after a migration fails, or after a storage issue or an abrupt shutdown occurs.
103-
- If a VM's .avhdx file is missing or corrupt, run the following cmdlet at a PowerShell command prompt:
102+
> If a configuration file is missing or corrupted, Hyper-V can't recognize or start the VM. Configuration files might be damaged after a migration fails, or after a storage issue or an abrupt shutdown occurs.
103+
- If a VM's .avhdx file is missing or corrupted, run the following cmdlet at a PowerShell command prompt:
104104

105105
```powershell
106106
Set-VHD -Path <VhdxPath> -ParentPath <ParentVhdxPath> -IgnoreIDMismatch
107107
```
108108
109109
### Step 5: Review cluster health
110110
111-
If you're using Hyper-V in a failover cluster, the cluster must be healthy for the VMs to function correctly. Issues in the cluster configuration can cause many different issues, including failures in live migration, unexpected VM restarts, or unexpected failover events.
111+
If you're using Hyper-V in a failover cluster, the cluster must be healthy for the VMs to function correctly. Issues in the cluster configuration can cause many different issues, including failures in live migration, unexpected VM restarts, and unexpected failover events.
112112
113113
Validate cluster health and configuration either by using the Cluster Validation wizard or by running the following cmdlet at a PowerShell command prompt:
114114
@@ -120,12 +120,12 @@ If the cluster isn't functioning correctly, see [High Availability troubleshooti
120120

121121
### Step 6: Remove VM saved states or checkpoints
122122

123-
Checkpoint issues, such as orphaned checkpoints, chain corruption, or incomplete merges might prevent a VM from functioning or prevent an offline VM from starting.
123+
Issues that affect checkpoints (also known as *snapshots*), such as orphaned checkpoints, chain corruption, or incomplete merges, might prevent a VM from functioning or prevent an offline VM from starting.
124124

125125
> [!IMPORTANT]
126126
> If you remove a VM's checkpoints, the VM might lose any unsaved or transient data.
127127
128-
To remove checkpoints (also known as *snapshots*), run the following cmdlets at a PowerShell command prompt:
128+
To remove checkpoints, run the following cmdlets at a PowerShell command prompt:
129129

130130
```powershell
131131
Get-VMSnapshot -VMName "<VMName>" | Remove-VMSavedState
@@ -137,17 +137,17 @@ To remove checkpoints (also known as *snapshots*), run the following cmdlets at
137137

138138
This combination of events means that the specified VM can't connect to a network.
139139

140-
To fix this issue, in Hyper-V Manager, go to the settings for that virtual machine. Select the correct virtual network.
140+
To fix this issue, open Hyper-V Manager, and go to the settings for that VM. Select the correct virtual network.
141141

142142
### Event ID 1069 (Cluster VM failed to start/can't bring a resource online)
143143

144-
This event indicates that a VM tried to start or fail over, but it couldn't register its configuration with the Virtual Machine Management Server service. Typically, this issue means that the VM's .vmcx file is corrupt.
144+
This event indicates that a VM tried to start or fail over, but it couldn't register its configuration with the Virtual Machine Management Server service. Typically, this issue means that the VM's .vmcx file is corrupted.
145145

146-
To fix this issue, use the .vhdx file to build a new VM (you can also restore the affected VM from a backup).
146+
To fix this issue, use the .vhdx file to build a new VM. You can also restore the affected VM from a backup.
147147

148148
### Event ID 1205 (Can't bring a resource online)
149149

150-
This event indicates that one or more resources might be in a failed state. For more information about troubleshooting this issue, see the following articles:
150+
This event indicates that one or more resources might be in a failed state. For more information about how to troubleshoot this issue, see the following articles:
151151

152152
- [Can't bring a clustered resource online troubleshooting guidance](../high-availability/troubleshoot-cannot-bring-resource-online-guidance.md)
153153
- [Considerations for Backing Up Virtual Machines on CSV with the System VSS Provider](/previous-versions/system-center/data-protection-manager-2010/ff634192(v=technet.10))
@@ -158,12 +158,12 @@ Follow these steps to resolve the issue by restarting the affected VMs:
158158

159159
1. Open the Hyper-V Manager or the Failover Cluster Manager.
160160
1. Identify the VMs that are in a "paused" state.
161-
1. Right-click each affected VM, and then select **Restart**.
162-
1. To make sure the VMs return to an operational state, monitor their progress.
161+
1. Right-click each affected VM, and then select **Restart**.
162+
1. To make sure that the VMs return to an operational state, monitor their progress.
163163

164164
For more information, see [Unresponsive VMs after cluster failover failure](unresponsive-vms-after-cluster-failover-failure.md).
165165

166-
### VM hangs or appears to be "stuck" in a transitional state (such as Starting, Stopping, or Restoring)
166+
### VM "hangs" or appears to be "stuck" in a transitional state (such as Starting, Stopping, or Restoring)
167167

168168
> [!IMPORTANT]
169169
> This procedure instructs you to stop VM processes. When you stop a VM in this manner, the VM might lose any unsaved or transient data.
@@ -199,7 +199,7 @@ To assist with troubleshooting, gather the following logs and diagnostics:
199199
Get-ClusterLog -UseLocalTime -Destination <Folder>
200200
```
201201

202-
- Process dumps for stuck services or processes:
202+
- Process dumps files for stuck services or processes:
203203

204204
```console
205205
procdump -ma <PID> <OutputPath>

0 commit comments

Comments
 (0)