Skip to content

Commit fc822d6

Browse files
First update for CI 7961
1 parent ea90f57 commit fc822d6

2 files changed

Lines changed: 84 additions & 0 deletions

File tree

82 KB
Loading
Lines changed: 84 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,84 @@
1+
---
2+
title: Troubleshooting Tools for Windows Activation
3+
description: Windows activation problems on Azure Virtual Machines can occur due to configuration, certificate, or connectivity issues. Microsoft provides script-based tools to help diagnose and resolve most activation-related problems.
4+
author: JarrettRenshaw
5+
ms.author: jarrettr
6+
manager: dcscontentpm
7+
ms.date: 10/24/2025
8+
ms.reviewer: v-jsitser, scotro, v-ryanberg
9+
ms.service: azure-virtual-machines
10+
ms.custom: sap:Cannot activate my Windows VM, troubleshooting tools for Windows VM activation
11+
---
12+
# Troubleshooting tools for Windows activation issues on Azure Virtual Machines
13+
14+
Windows activation problems on Azure Virtual Machines (VMs) can occur due to configuration, certificate, or connectivity issues. Microsoft provides two script-based tools to help diagnose and resolve most activation-related problems.
15+
16+
## Tools overview
17+
18+
### 1. Windows activation validation
19+
20+
**Purpose**
21+
22+
Validates the activation status of your Windows VM and checks for common issues that prevent successful activation.
23+
24+
**Key features**
25+
26+
- Confirms Windows activation state.
27+
- Detects misconfigurations.
28+
- Provides actionable guidance.
29+
30+
For more information, see [Windows activation validation](https://github.com/Azure/azure-support-scripts/blob/master/RunCommand/Windows/WindowsActivationValidation/README.md).
31+
32+
### 2. Azure Instance Metadata Service certificate check
33+
34+
**Purpose**
35+
36+
Verifies the integrity and availability of certificates required for activation through Azure Instance Metadata Service (IMDS).
37+
38+
**Key features**
39+
40+
- Validates IMDS certificate presence and correctness.
41+
- Identifies certificate-related activation failures.
42+
- Suggests corrective steps.
43+
44+
For more information, see:
45+
46+
- [Cause: Azure Instance Metadata Service connection issue](activation-watermark-appears.md#cause-1-azure-instance-metadata-service-connection-issue).
47+
- [Azure VM Attested Metadata Verification Script](https://github.com/Azure/azure-support-scripts/blob/master/RunCommand/Windows/IMDSCertCheck/README.md).
48+
49+
## How to run these tools
50+
51+
You can run these tools in three ways:
52+
53+
### 1. Download from GitHub and run within the VM
54+
55+
Use the GitHub resources previously cited to download scripts and run them manually.
56+
57+
### 2. Run using Azure Run Command
58+
59+
- Navigate to your VM in the Azure portal: > **Operations** > **Run Command**.
60+
- Select the script from the list (see the following screenshot).
61+
62+
:::image type="content" source="media/windows-activation-troubleshoot-tools/azure-portal-view.png" alt-text="Azure Portal view Run Command example." lightbox="media/windows-activation-troubleshoot-tools/azure-portal-view.png":::
63+
64+
> [!NOTE]
65+
> Alternatively, one can run these commands using a command-line interface (CLI) tool, Windows PowerShell, or Windows on ARM.
66+
67+
### 3. Use prepackaged Run Command scripts
68+
69+
For more information, see [Run scripts in your Windows VM by using action Run Commands](/azure/virtual-machines/windows/run-command).
70+
71+
## Recommended workflow
72+
73+
1. Run **Windows Activation Validation** to confirm activation status and detect common issues.
74+
2. If certificate-related errors are suspected, run **IMDS Certificate Check**.
75+
3. Apply suggested fixes or refer to official documentation for advanced troubleshooting.
76+
77+
### **Additional resources**
78+
79+
- [Additional troubleshooting guidance](/azure/virtual-machines/windows/troubleshoot-activation-problems)
80+
- [Virtual Machines licensing FAQ](https://azure.microsoft.com/pricing/licensing-faq/?msockid=16f3be2d0f1066e62759a8150e8867c4).
81+
82+
[!INCLUDE [azure-help-support](~/includes/azure-help-support.md)]
83+
84+
[!INCLUDE [Third-party contact disclaimer](~/includes/third-party-contact-disclaimer.md)]

0 commit comments

Comments
 (0)