Comprehensive Guide On How To Accept A Device Windows Compatibility Agent For Enterprise Upgrades

Comprehensive Guide On How To Accept A Device Windows Compatibility Agent For Enterprise Upgrades

Desktop Agent Arm64 windows compatibilty - Help Hub - Postman Community

Accepting a device via the Windows Compatibility Agent requires the successful synchronization of local telemetry data with Microsoft Endpoint Manager or Azure Desktop Analytics to validate hardware readiness for OS transitions. To achieve a successful "Ready" status, system administrators must ensure the Microsoft Compatibility Appraiser task is executed, diagnostic data levels are set to at least Required, and any identified hardware or driver blocks are manually remediated or acknowledged within the management console.


Strategic Pre-Operation Planning and Infrastructure Requirements

Before attempting to accept or enroll a device through the Windows Compatibility Agent, it is vital to establish the underlying infrastructure that allows for telemetry communication. The agent is not a standalone software package in modern Windows environments; rather, it is a set of integrated components, primarily the Microsoft Compatibility Appraiser, which inventories the system and evaluates it against Microsoft’s known-issue database. Without the proper configuration of the Windows Management Instrumentation (WMI) repository and the Corrective Action Framework (CAF), the agent will fail to report status, leaving the device in an "Unknown" or "Pending" state in your reporting dashboard.

The following checklist identifies the essential components and standards required for a successful agent handshake:



  • Administrative Access: You must possess Local Administrator rights on the target endpoint and Global Administrator or Intune Administrator roles within the Microsoft Endpoint Manager (MEM) tenant.
  • Operating System Standards: The target devices should be running Windows 10 (Pro, Enterprise, or Education) or Windows 11. Older versions like Windows 7 or 8.1 require specific "Update for User Experience and Telemetry" patches (e.g., KB3080149).
  • Network Visibility: Firewall and Proxy configurations must permit outbound traffic to the Microsoft Data Management service endpoints, specifically settings-win.data.microsoft.com and vocal.res.microsoft.com on port 443.
  • Telemetry Configuration: Devices must be configured to send at least the "Required" (formerly Basic) level of diagnostic data. In enterprise environments, "Optional" (Full) is often preferred for more granular driver compatibility insights.
  • Timeframe Benchmarks: Data latency is a critical factor. Once the agent is triggered, it typically takes 24 to 72 hours for the data to process through the Microsoft cloud backend and reflect in the compliance dashboards.

Step-by-Step Execution for Device Acceptance and Agent Synchronization

Successfully accepting a device involves a multi-stage workflow: configuring the environment, triggering the local appraiser, and then confirming the "Acceptance" or "Ready" status in the cloud console. Follow these steps precisely to ensure the device is recognized and cleared for deployment.



Step 1: Configure Diagnostic Data Levels via Group Policy

The Windows Compatibility Agent remains dormant or ineffective if the device’s privacy settings restrict data transmission. To "accept" the agent's role, you must first authorize its communication via Group Policy (GPO) or Configuration Service Provider (CSP) policies.

Open the Group Policy Management Editor and navigate to Computer Configuration, then Administrative Templates, followed by Windows Components, and finally Data Collection and Preview Builds. Locate the policy titled Allow Diagnostic Data. Set this to Enabled and choose the level of Required or Optional. For organizations using Microsoft Intune, this is handled through a Device Configuration profile using the System/AllowTelemetry setting. Without this policy being set to a value of 1 or higher, the compatibility agent will not upload the hardware inventory necessary for the acceptance process.



Step 2: Initialize the Microsoft Compatibility Appraiser Task

The "agent" functionality is primarily driven by a scheduled task named the Microsoft Compatibility Appraiser. While this runs automatically on a periodic basis, you can force an immediate check to accelerate device acceptance.

To do this manually, open the Task Scheduler on the Windows device. Navigate to the Task Scheduler Library, expand Microsoft, then Windows, and click on Application Experience. Locate the task labeled Microsoft Compatibility Appraiser. Right-click this task and select Run. This process triggers the Compattelrunner.exe executable, which scans the system for hardware limitations, driver conflicts, and application incompatibilities. Monitor the process in Task Manager; once Compattelrunner.exe completes its cycle, the local assessment data is stored in the local registry and prepared for upload.



Step 3: Verify the Commercial ID or Azure AD Registration

For the management console to "accept" the device data, it must know which tenant the device belongs to. In older Windows Analytics setups, this required a Commercial ID. In modern Microsoft Endpoint Manager environments, this is achieved through Azure Active Directory (now Microsoft Entra ID) registration.

Check the device registration status by opening a command prompt and typing dsregcmd /status. Ensure that the AzureAdJoined field is set to YES. If the device is not joined to the tenant, the Compatibility Agent data will be discarded by Microsoft’s ingestion engine because it lacks a destination tenant. For hybrid-joined environments, ensure that the device has successfully synced via Azure AD Connect.



Step 4: Monitor the Compatibility Status in the Management Console

Once the local agent has finished its scan and the data has been uploaded, you must pivot to the cloud console to finalize the "acceptance." Navigate to the Microsoft Endpoint Manager admin center, go to Reports, and select Endpoint Analytics or Managed Updates.

Look for the hardware readiness reports. A device is considered "accepted" by the system when it appears with a status of "Ready" or "Ready with Safeguards." If the device shows as "Not Ready," click on the device record to see the specific compatibility blocks. These blocks represent the agent's findings, such as an incompatible driver version or a disabled TPM 2.0 module.



Step 5: Remediate and Acknowledge Compatibility Blocks

The final stage of "accepting" the device is resolving any blockers that the agent has flagged. If the agent identifies a "Soft Block," you can often proceed by acknowledging the risk. If it identifies a "Hard Block," such as insufficient disk space or an unsupported CPU, the device will remain in a "Rejected" state until the hardware is upgraded.

Pro-Tip: You can use the "Target Version" policy in Windows Update for Business to force the agent to evaluate the device against a specific build of Windows, such as 23H2. This narrows the scope of the compatibility check and provides more accurate "Acceptance" data.

Warning: Manually deleting the telemetry cache in an attempt to reset the agent can result in a 30-day "blackout" period where the device fails to report any compatibility status to the cloud console. Always use the Task Scheduler to trigger updates rather than deleting system folders.


Technical Specifications for Windows Compatibility and Telemetry

The performance and success of the Windows Compatibility Agent are governed by specific technical thresholds. The following table outlines the requirements for different levels of device evaluation and the resulting data fidelity.



Metric Component Required Level (Basic) Optional Level (Full) Impact on Device Acceptance
Data Volume Low (approx. 2MB/day) Moderate (approx. 10MB/day) Optional level provides 40% more driver insights.
Hardware Inventory Basic CPU/RAM/Disk Comprehensive WMI details Detailed inventory is required for UEFI/TPM checks.
App Compatibility High-level OS usage Individual app crash data Required for identifying software "Soft Blocks."
Update Connectivity Mandatory Mandatory Necessary for receiving the latest appraiser DLLs.
Processing Latency 48-72 Hours 24-48 Hours Higher data levels often process faster in MEM.
Registry Path HKLM\SOFTWARE\Policies\Microsoft\Windows\DataCollection HKLM\SOFTWARE\Policies\Microsoft\Windows\DataCollection Path for manual GPO verification.

Resolving Enterprise Compatibility Failures and Agent Synchronization Issues

Even with correct configurations, the Windows Compatibility Agent may fail to report or the device may remain unaccepted. Understanding the root cause of these failures is essential for maintaining a healthy deployment pipeline.



  • Scenario: Device stuck in "Pending" status for more than 72 hours.



    • Root Cause: The device is unable to reach the Microsoft telemetry endpoints due to SSL inspection on the corporate proxy. The telemetry agent uses certificate pinning, and SSL interception breaks the handshake.
    • Actionable Fix: Whitelist the *.data.microsoft.com and *.vocal.res.microsoft.com domains in your proxy and firewall settings to allow "transparent" passage without SSL inspection.
  • Scenario: The Microsoft Compatibility Appraiser task fails with error code 0x80070005.



    • Root Cause: This is an "Access Denied" error, often caused by third-party security software or EDR (Endpoint Detection and Response) tools blocking the Compattelrunner.exe from scanning the WMI repository.
    • Actionable Fix: Configure an exclusion rule in your antivirus or EDR solution for the C:\Windows\System32\Compattelrunner.exe process and the C:\Windows\AppCompat\Programs folder.
  • Scenario: Hardware shows "Not Capable" despite meeting all Windows 11 requirements.



    • Root Cause: The local WMI (Windows Management Instrumentation) information is corrupted, or the BIOS/UEFI is reporting outdated information to the OS.
    • Actionable Fix: Reset the WMI repository by running the command "winmgmt /resetrepository" in an elevated command prompt and سپس restart the Microsoft Compatibility Appraiser task to re-inventory the hardware.

Frequently Asked Questions



How do I verify if the Windows Compatibility Agent is actually running?

You can verify the agent's activity by checking the "Application Experience" logs in the Event Viewer. Navigate to Applications and Services Logs, then Microsoft, Windows, and Application Experience. Look for Event ID 19, which indicates the start of a scan, and Event ID 20, which confirms the scan has completed and data has been uploaded to the cloud.



Can I accept a device if it doesn't have TPM 2.0?

The Compatibility Agent will mark a device without TPM 2.0 as "Incompatible" for Windows 11. While there are registry bypasses to install the OS, the official "Acceptance" status in Microsoft Endpoint Manager will remain "Not Ready" unless the device meets the hardware security standards or you are targeting a Windows 10 deployment.



Does the Windows Compatibility Agent slow down the computer?

The agent is designed to run with low priority. The Compattelrunner.exe process utilizes idle CPU cycles to ensure it does not interfere with user productivity. However, on older systems with mechanical hard drives, you may notice increased disk I/O during the initial hardware inventory phase.



Why is my device showing as "Ready" on the machine but "Not Ready" in Intune?

This discrepancy is usually caused by the data processing delay. The local "PC Health Check" tool reflects real-time local data, whereas the Intune/Endpoint Analytics dashboard relies on telemetry data that must be uploaded, processed by Microsoft’s AI, and then pushed back to your tenant reporting. This sync usually takes 48 hours.

Optimize Your Fleet Readiness Today

Ensuring your devices are correctly recognized by the Windows Compatibility Agent is the first step toward a secure and modern workplace. By implementing these telemetry standards and monitoring your endpoint analytics, you can eliminate deployment bottlenecks and guarantee a seamless transition to the latest Windows ecosystem.


Read also: Free detroit press investigation uncovers corruption in city hall tonight