Proposed Pull Request Change

📄 Document Links

View on GitHub View on Microsoft Learn

--- title: Upgrade the Azure Arc resource bridge description: This article describes how to upgrade the Azure Arc resource bridge associated with your SCVMM environment. ms.service: azure-arc ms.subservice: azure-arc-scvmm ms.author: v-gajeronika ms.reviewer: v-gajeronika author: Jeronika-MS ms.topic: how-to ms.date: 02/09/2026 keywords: "VMM, Arc, Azure" ms.custom: - build-2025 # Customer intent: "As an IT administrator managing the SCVMM environment, I want to upgrade the Azure Arc resource bridge, so that I can ensure it remains supported and secure with the latest updates and features." --- # Upgrade the Azure Arc resource bridge This article describes how to upgrade the Azure Arc resource bridge associated with your SCVMM environment. ## Overview Deploying a new resource bridge involves several steps: downloading the resource bridge VM VHDX from the cloud, using the VHDX to deploy a new VM, verifying that the new resource bridge VM is running, associating the existing resources to the new resource bridge VM, connecting it to Azure, and deleting the old resource bridge VM. All these steps execute sequentially after you trigger the upgrade. The upgrade generally takes 30-90 minutes, depending on the network speeds. A short intermittent downtime might happen during the handoff between the old resource bridge to the new resource bridge. Additional downtime can occur if prerequisites aren't met, or if a change in the network (DNS, firewall, proxy, and so on) impacts the resource bridge's network connectivity. You must manually upgrade the resource bridge associated with your SCVMM environment. ## Versions and upgrade availability Periodically, Microsoft releases new versions of the Azure Arc resource bridge to include security and feature updates. Generally, the latest released version and the previous three versions (up to n-3) of resource bridge are supported. You must upgrade or redeploy a resource bridge on an unsupported version to be in a production support window and ensure the certificates in the resource bridge are still valid. Maintain the resource bridge in the latest version and perform upgrades every six months. To stay informed on releases, visit the [Azure Arc resource bridge release notes](/azure/azure-arc/resource-bridge/release-notes). If your resource bridge is at version n-3, you might receive an email notification that your resource bridge goes out of support once the next version is released. If you receive this notification, upgrade the resource bridge as soon as possible to be in the latest version. If there are any issues with manual upgrade, submit a support ticket to receive assistance from Microsoft while you're still in a supported version. To check the current version of your resource bridge, run `az arcappliance show` from your workstation machine that has the configuration files stored locally or check the Azure resource of your resource bridge. To check if your resource bridge has an upgrade available, run the following command: ```azurecli az arcappliance get-upgrades --resource-group <ResourceGroup> --name <ARBName> ``` ## Prerequisites Before you upgrade a resource bridge, make sure the following prerequisites are met: - The Azure Arc resource bridge must be online and healthy with a status of *Running*. You can check the [Azure resource of your resource bridge](https://portal.azure.com/#view/Microsoft_Azure_ArcCenterUX/ArcCenterMenuBlade/~/resourceBridges) to verify. - The credentials in the resource bridge VM are valid. You can update the credentials by following the steps given in [this article](/azure/azure-arc/system-center-virtual-machine-manager/administer-arc-scvmm#update-the-scvmm-account-credentials-using-a-new-password-or-a-new-scvmm-account-after-onboarding). To test the credentials, perform an operation on an Azure-enabled VM from Azure. - The resource bridge is in the same location path where it was originally deployed. - The VMM server on which the resource bridge is deployed has 11 GB of free space. The library share used to store the downloaded VHDX has at least 7 GB of free space. - The Azure resource of the resource bridge doesn't have any resource locks placed on it. - The workstation machine from which you trigger the upgrade has the `kubeconfig` and the three `.yaml` appliance configuration files initially created during deployment stored locally. ## Upgrade the Azure Arc resource bridge You can manually upgrade the Azure Arc resource bridge. The upgrade command updates your Azure Arc resource bridge to the immediate next version, which might not be the latest available version. You might need multiple upgrades to reach a [supported version](/azure/azure-arc/resource-bridge/release-notes). To manually upgrade your resource bridge, follow these steps: 1. Ensure that you have installed the latest `az arcappliance` CLI extension by running the following extension upgrade command from the SCVMM server: ```azurecli az extension add --upgrade --name arcappliance ``` 1. To manually upgrade your resource bridge, run the following command from a workstation machine that has the `kubeconfig` and the three `.yaml` appliance configuration files stored locally: ```azurecli az arcappliance upgrade scvmm --config-file <file path to ARBname-appliance.yaml> ``` Once the upgrade is successful, you can navigate to the [Azure resource of your resource bridge](https://portal.azure.com/#view/Microsoft_Azure_ArcCenterUX/ArcCenterMenuBlade/~/resourceBridges) and verify if it is in a [supported version](/azure/azure-arc/resource-bridge/release-notes). >[!NOTE] >- You might not always be able to upgrade an unsupported resource bridge to a newer version, as component services used by the Azure Arc resource bridge might no longer be compatible. In addition, the unsupported resource bridge might not be able to provide reliable monitoring and health metrics. >- If you can't upgrade a resource bridge to a supported version, you must perform a fresh deployment of a resource bridge and reassociate the existing resources with the new resource bridge. For more information, see [how to perform recovery operations on your resource bridge](/azure/azure-arc/system-center-virtual-machine-manager/disaster-recovery). >- Trigger the upgrade as soon as you receive the email notification to allow debugging time if there are any issues. To receive assistance from Microsoft, submit a support ticket while you're still in a supported version. ## Next Step - [Troubleshoot SCVMM-specific upgrade errors](/azure/azure-arc/system-center-virtual-machine-manager/troubleshoot-scvmm). - Learn how to [administer Arc-enabled SCVMM](/azure/azure-arc/system-center-virtual-machine-manager/administer-arc-scvmm).