Detect known incompatible Azure CLI extensions that should be removed.

Question

Detect known incompatible Azure CLI extensions that should be removed.

Joe Comeau 40

The error message is not very verbose on what extensions should be removed

We cannot go thru with the update process on this.

Update: 12.2601.1002.503

User's image

Bharath Y P 10,610 Reputation points Microsoft External Staff Moderator

2026-05-14T18:28:53.52+00:00

Hello Joe Comeau,

thank you for posting your query on Microsoft Q&A platform.

We are looking into your issue and will keep you posted updates.

Thanks.
Manish Deshpande 8,135 Reputation points Microsoft External Staff Moderator

2026-05-15T00:13:52.2366667+00:00
Azure Update Manager (ARBStack) runs before applying updates, and the error message unfortunately doesn't tell you which extension to remove. Let me walk you through how to fix it.

Azure Update Manager validates a set of readiness conditions before proceeding with an update. One of those checks flags Azure CLI extensions installed on the machine that are no longer compatible with the current platform version. Until those extensions are removed, the update process is blocked.

List your currently installed Azure CLI extensions
Run the following on the affected machine (AFNODE001 based on your screenshot):

az extension list --output table

This will show you everything currently installed. Look for any older or deprecated extensions — common culprits include older versions of azure-devops, connectedmachine, arcappliance, or any Arc-related extensions that may have since been folded into the core CLI.

Remove the incompatible extensions

Once you identify the problematic extension(s), remove them:

az extension remove --name <extension-name>

If you're unsure which specific one is flagged, you can try removing extensions one at a time and re-running the Update Manager prereq check after each removal, or remove all non-essential ones temporarily.

Update the Azure CLI itself

While you're at it, make sure the CLI is on the latest version. Outdated CLI installs are often the root cause of extension incompatibility:

az upgrade

This will also update all currently installed extensions to their latest compatible versions.

Retry the Update Manager operations

Once the incompatible extension(s) are cleared, go back to Azure Update Manager and re-trigger the update for the affected node. The prereq check should pass this time.

https://learn.microsoft.com/en-us/cli/azure/azure-cli-extensions-overview
https://learn.microsoft.com/en-us/cli/azure/update-azure-cli
https://learn.microsoft.com/en-us/azure/update-manager/troubleshoot
https://learn.microsoft.com/en-us/azure/update-manager/prerequisites

Thanks.
Manish Deshpande 8,135 Reputation points Microsoft External Staff Moderator

2026-05-22T18:58:26.2766667+00:00

Hello @Joe Comeau

I wanted to check if my last response made sense. I’d be glad to assist further or explain anything in more detail and please accept as Yes and upvote if the answer is helpful so that it can help others in the community.
Manish Deshpande 8,135 Reputation points Microsoft External Staff Moderator

2026-05-26T02:14:30.3933333+00:00

Hello @Joe Comeau

I wanted to check if my last response made sense. I’d be glad to assist further or explain anything in more detail and please accept as Yes and upvote if the answer is helpful so that it can help others in the community.
Joe Comeau 40 Reputation points

2026-05-27T16:23:00.16+00:00

Hi Manish,

Are you able to tell which one is the extension that is causing the problem?
Would it be okay to just remove all the extensions?

Apologies for the delayed response

Best,

Andy (Working on this on behalf for Joe)
Manish Deshpande 8,135 Reputation points Microsoft External Staff Moderator

2026-05-29T19:19:33.7133333+00:00
Hello @Joe Comeau

Thanks for sharing the output that makes it a lot easier to narrow down.

Looking at your list, the most likely offender is arcappliance (1.6.0). The ARBStack readiness check is specifically tied to Arc Resource Bridge operations, and an installed arcappliance CLI extension that doesn't align with the version the platform expects for the incoming update (12.2601.1002.503) is a very common trigger for this exact critical error. I'd also flag connectedmachine (1.0.0) as a secondary suspect version 1.0.0 is quite dated and is a known culprit in environments that have been around for a while.

Try removing arcappliance first

az extension remove --name connectedmachine

Would it be okay to just remove all the extensions?
Regarding your question about removing all extensions is yes, that is safe in this context.

All four of your extensions live under C:\CloudContent\AzCliExtensions\, which is the platform-managed directory. The update process itself will reinstall the correct compatible versions during the update run.

Removing them won't affect your running VMs or workloads it only temporarily removes CLI management capability for things like Arc VM operations and Arc appliance commands until they're restored post-update.

If you want to take the fastest path, you can remove all four in one go:

az extension remove --name arcappliance az extension remove --name connectedmachine az extension remove --name customlocation az extension remove --name stack-hci-vm

Then retry the update. The platform will bring back the right versions as part of the update.

One more thing worth doing while you're at it — make sure the CLI itself is on the latest version:

az upgrade

Outdated CLI installs are a frequent root cause of extension incompatibility, so this helps prevent the same issue from coming back on the next update cycle.

Links for reference :

ARBStack update troubleshooting:
https://learn.microsoft.com/en-us/azure/azure-local/update/update-troubleshooting-23h2

Azure CLI extension management:
https://learn.microsoft.com/en-us/cli/azure/azure-cli-extensions-overview

Arc resource bridge troubleshooting:
https://learn.microsoft.com/en-us/azure/azure-arc/resource-bridge/troubleshoot-resource-bridge

Azure Update Manager prerequisites:
https://learn.microsoft.com/en-us/azure/update-manager/prerequisites

Thanks,
Manish.
Joe Comeau 40 Reputation points

2026-05-29T21:41:15.76+00:00

Hi Manish,

After removing the extensions the update has still failed.

Any information would be great

Best.

Andy (Working on behalf of Joe)
Manish Deshpande 8,135 Reputation points Microsoft External Staff Moderator

2026-06-01T09:29:23.13+00:00

Hello @Joe Comeau / Andy

I have requested for few details over the private message pls respond at your earliest.
Manish Deshpande 8,135 Reputation points Microsoft External Staff Moderator

2026-06-26T12:11:52.85+00:00

Hello @Joe Comeau

Update from the backend team

Remove all extensions

az extension remove --name arcappliance

az extension remove --name connectedmachine

az extension remove --name customlocation

az extension remove --name stack-hci-vm

Reinstall clean versions

az extension add --name arcappliance

az extension add --name connectedmachine

az extension add --name customlocation

az extension add --name stack-hci-vm And
Then Provide output by runnning htis commands after Re-Install: az extension list -o table

Let me know the output if it worked?

Thanks,
Manish.
Joe Comeau 40 Reputation points

2026-06-29T23:17:17.27+00:00

Hi Manish,

Getting these errors for arcappliance and stack-hci-vm

Andy
Manish Deshpande 8,135 Reputation points Microsoft External Staff Moderator

2026-06-30T12:51:33.0466667+00:00
Hello Andy

az extension remove --name arcappliance az extension remove --name customlocation

Then manually delete leftovers:

Remove-Item -Recurse -Force "C:\CloudContent\AzCliExtensions\*"

Step 2: Clear Azure CLI cache

az cache purge

Step 3: Update Azure CLI (very important)

az upgrade

Step 4: Reinstall extensions (clean)

az extension add --name arcappliance --upgrade az extension add --name customlocation --upgrade

If still Failing

Option A: Enable debug to see root cause.

az extension add --name arcappliance --debug

Option B: Fix proxy / network

If you're in corporate network (very likely):

pip download may fail silently

Ensure:

HTTPS outbound is allowed

No SSL inspection breaking Python downloads

Option C: Set extension install path

az config set extension.use_dynamic_install=yes_without_prompt

Please follow this and let me know the result.

Thanks,
Manish.
Joe Comeau 40 Reputation points

2026-07-02T23:31:22.6366667+00:00

Hi Manish,

Andy
Joe Comeau 40 Reputation points

2026-07-20T19:10:32.4133333+00:00

Hi there,

Is there an update to this?

Andy
Joe Comeau 40 Reputation points

2026-07-21T16:40:32.4+00:00

Hi There,

Pinging again for an update

more than a week we have not gotten a response

Joe