Created on

Azure Local – MOC update prechecks failed


Error in portal and Powershell doing pre-check health of solution update (after pre-check doing prepare had already executed without further errors):

Title       : MOC Update Precheck Test
Status      : FAILURE
Severity    : CRITICAL
Description : MOC update prechecks failed, failed test count: 1
Remediation : Please check MOC update precheck failure details, fix those errors, and re-run Update Readiness.

How to troubleshoot

Run this command on a node in the stack (must be on the nodes, remote PowerShell will fail):

Import-Module ArcHCI
Test-MOCUpdateReadiness

Errors liks this will most likely display:

Name Value
—- —–
Remediation Contact support
Timestamp 2025-10-09 16:39:12Z
TargetResourceID Cluster/CLUSTERNAME
Title Check for different numbers of MOC nodes and cluster nodes
Tags {Member, Group}
Name MOCNodeCount
TargetResourceName CLUSTERNAME
Description Get-MocNode unexpectedly failed with exception: C:\Program Files\AksHci\mocctl.exe –…
Status FAILURE
Severity CRITICAL

AdditionalData {}
TargetResourceType Cluster
HealthCheckSource Test-EnvironmentReadiness
DisplayName MOC Node Count and Name Check

How to fix

Run this PowerShell command to fix the MOC:

Import-Module ArcHCI
Repair-MOC