Proposed Pull Request Change

📄 Document Links

View on GitHub View on Microsoft Learn

--- title: Quickstart for Azure Arc-enabled System Center Virtual Machine Manager (SCVMM) description: In this Quickstart, you learn how to use the helper script to connect your System Center Virtual Machine Manager management server to Azure Arc. ms.author: v-gajeronika ms.reviewer: v-gajeronika author: Jeronika-MS ms.topic: quickstart ms.services: azure-arc ms.subservice: azure-arc-scvmm ms.date: 02/09/2026 ms.custom: - references_regions - build-2025 # Customer intent: As a VI admin, I want to connect my VMM management server to Azure Arc. --- # Quickstart: Connect your System Center Virtual Machine Manager management server to Azure Arc Before you can start using the Azure Arc-enabled SCVMM features, you need to connect your VMM management server to Azure Arc. This quickstart shows you how to connect your SCVMM management server to Azure Arc using a helper script. The script deploys a lightweight Azure Arc appliance (called Azure Arc resource bridge) as a virtual machine running in your VMM environment and installs an SCVMM cluster extension on it to provide a continuous connection between your VMM management server and Azure Arc. ## Prerequisites >[!Note] > - If your VMM server runs on a Windows Server 2016 machine, ensure that the [Open SSH package](https://github.com/PowerShell/Win32-OpenSSH/releases) and tar are installed. To install tar, you can copy `tar.exe` and `archiveint.dll` from any Windows 11 or Windows Server 2019/2022 machine to the *C:\Windows\System32* path on your VMM server machine. > - Azure Arc resource bridge deployment by using private link (private endpoint) isn't currently supported. | **Requirement** | **Details** | | --- | --- | | **Azure** | An Azure subscription <br/><br/> A resource group in the above subscription where you have the *Owner/Contributor* role. | | **SCVMM** | You need an SCVMM management server running version 2019 or later.<br/><br/> A private cloud or a host group with a minimum free capacity of 32 GB of RAM, 4 vCPUs with 100 GB of free disk space. The supported storage configurations are hybrid storage (flash and HDD) and all-flash storage (SSDs or NVMe). <br/><br/> A VM network with internet access, directly or through proxy. You deploy the appliance VM by using this VM network.<br/><br/> Only static IP allocation is supported; dynamic IP allocation by using DHCP isn't supported. You can perform static IP allocation by using one of the following approaches:<br><br> 1. **VMM IP Pool**: Follow [these steps](/system-center/vmm/network-pool?view=sc-vmm-2022&preserve-view=true) to create a VMM Static IP Pool and ensure that the Static IP Pool has at least three IP addresses. If your SCVMM server is behind a firewall, all the IPs in this IP Pool and the Control Plane IP need to communicate through WinRM ports. The default WinRM ports are 5985 and 5986. The onboarding experience directs you to this approach by default if the VMM Cloud or Host Group chosen as the Azure Arc resource bridge target has IP Pools configured. <br> <br> 2. **Custom IP range**: Ensure that your VM network has three continuous free IP addresses. If your SCVMM server is behind a firewall, all the IPs in this IP range and the Control Plane IP need to communicate through WinRM ports. The default WinRM ports are 5985 and 5986. If the VM network is configured with a VLAN, the VLAN ID is required as an input. In the Logical network associated with the VM Network, ensure that *Logical Network Definition (LND)* or *Network Site* is configured with the corresponding VLAN ID. Azure Arc Resource Bridge requires internal and external DNS resolution to the required sites and the on-premises management machine for the static gateway IP and the IP addresses of your DNS servers. The onboarding experience directs you to this approach by default if the VMM Cloud or Host Group chosen as the Azure Arc resource bridge target has no IP Pools configured.<br><br>The inbound and outbound connectivity URL listed [here](/azure/azure-arc/system-center-virtual-machine-manager/support-matrix-for-system-center-virtual-machine-manager#resource-bridge-networking-requirements) need to be allowlisted.<br><br> A library share with write permission for the SCVMM admin account through which Resource Bridge deployment is going to be performed.| | **SCVMM accounts** | An SCVMM admin account that can perform all administrative actions on all objects that VMM manages. <br/><br/> The user should be part of local administrator account in the SCVMM server. If the SCVMM server is installed in a High Availability configuration, the user should be a part of the local administrator accounts in all the SCVMM cluster nodes. <br/><br/>Use this account for the ongoing operation of Azure Arc-enabled SCVMM and the deployment of the Arc Resource bridge VM. | | **Workstation** | Use the workstation to run the helper script. Ensure you have [64-bit Azure CLI installed](/cli/azure/install-azure-cli) on the workstation.<br/><br/> A Windows/Linux machine that can access both your SCVMM management server and internet, directly or through proxy.<br/><br/> You can run the helper script directly from the VMM server machine as well.<br/><br/> To avoid network latency issues, we recommend executing the helper script directly in the VMM server machine.<br/><br/> When you execute the script from a Linux machine, the deployment takes a bit longer and you might experience performance issues. | ## Prepare SCVMM management server - Ensure you have a host group or a SCVMM private cloud with a reservation of at least 32 GB of RAM, 4 vCPUs, and at least 100 GB of disk space. - Ensure that the SCVMM administrator account has the appropriate permissions. ## Download the onboarding script 1. Go to [Azure portal](https://aka.ms/SCVMM/MgmtServers). 1. Search for **Azure Arc** and select it. 1. In the **Overview** page, select **Add resources** under **Manage resources across environments**. :::image type="content" source="media/quick-start-connect-scvmm-to-azure/overview-add-infrastructure.png" alt-text="Screenshot of how to select Add your infrastructure for free." lightbox="media/quick-start-connect-scvmm-to-azure/overview-add-infrastructure.png"::: 1. In the **Host environments** section, in **System Center VMM** select **Add**. :::image type="content" source="media/quick-start-connect-scvmm-to-azure/platform-add-system-center-vmm.png" alt-text="Screenshot of how to select System Center V M M platform." lightbox="media/quick-start-connect-scvmm-to-azure/platform-add-system-center-vmm.png"::: 1. Select **Create a new resource bridge** and select **Next : Basics >**. 1. Enter a name for **Azure Arc resource bridge**. For example: *contoso-nyc-resourcebridge*. 1. Select a subscription and resource group where you want to create the resource bridge. 1. Under **Region**, select an Azure location where you want to store the resource metadata. The currently supported regions are **East US** and **West Europe**. 1. Enter a name for **Custom location**. This is the name that you see when you deploy virtual machines. Name it for the datacenter or the physical location of your datacenter. For example: *contoso-nyc-dc.* 1. Leave the option **Use the same subscription and resource group as your resource bridge** selected. 1. Enter a name for your **SCVMM management server instance** in Azure. For example: *contoso-nyc-scvmm.* 1. Select **Next: Tags >**. 1. Assign Azure tags to your resources in **Value** under **Physical location tags**. You can add extra tags to help you organize your resources and make administrative tasks easier by using custom tags. 1. Select **Next: Download and run script >**. 1. If your subscription isn't registered with all the required resource providers, select **Register** to proceed to next step. 1. Based on the operating system of your workstation, download the PowerShell or Bash script and copy it to the workstation. 1. To see the status of your onboarding after you run the script on your workstation, select **Next:Verification**. The onboarding isn't affected when you close this page. # [Windows](#tab/window) Follow these instructions to run the script on a Windows machine. 1. Open a new PowerShell window as an administrator. Verify if Azure CLI is installed on the workstation by using the following command: ```azurepowershell-interactive az ``` 1. Go to the folder where you downloaded the PowerShell script: *cd C:\Users\ContosoUser\Downloads* 1. Run the following command to allow the script to run since it's an unsigned script. If you close the session before you complete all the steps, run this command again in the new PowerShell administrator session: ```azurepowershell-interactive Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass ``` 1. Run the script: ```azurepowershell-interactive ./resource-bridge-onboarding-script.ps1 ``` # [Linux](#tab/linux) Follow these instructions to run the script on a Linux machine: 1. Open the terminal and go to the folder where you downloaded the Bash script. 1. Run the script by using the following command: ```sh bash resource-bridge-onboarding-script.sh ``` --- ## Script runtime The script execution can take up to 30 minutes. You're prompted for various details. See the following table for related information: | **Parameter** | **Details** | | --- | --- | | **Azure login** | You're asked to sign in to Azure by visiting [this site](https://www.microsoft.com/devicelogin) and pasting the prompted code. | | **SCVMM management server FQDN/Address** | FQDN for the VMM server (or an IP address). </br> Provide role name if it’s a Highly Available VMM deployment. </br> For example: nyc-scvmm.contoso.com or 10.160.0.1 | | **SCVMM Username**</br> (domain\username) | Username for the SCVMM administrator account. The required permissions for the account are listed in the prerequisites above.</br> Example: contoso\contosouser | | **SCVMM password** | Password for the SCVMM admin account. | | **Deployment location selection** | Select if you want to deploy the Arc resource bridge VM in an SCVMM Cloud or an SCVMM Host Group. | | **Private cloud/Host group selection** | Select the name of the private cloud or the host group where the Arc resource bridge VM should be deployed. | | **Virtual Network selection** | Select the name of the virtual network to which *Arc resource bridge VM* needs to be connected. This network should allow the appliance to talk to the VMM management server and the Azure endpoints (or internet). | | **Resource Bridge IP Inputs** | If you have a VMM IP Pool configured, select the VMM static IP pool that you use to allot the IP address. </br></br> To enter a custom IP range, enter the static IP address prefix, start range IP, end range IP, VM network VLAN ID, static gateway IP, and the IP addresses of DNS servers, in that order. **Note**: If you don't have a VLAN ID configured with the VM network, enter 0 as the VLAN ID. | | **Control Plane IP** | Provide a reserved IP address in the same subnet as the static IP pool used for resource bridge deployment. This IP address is outside of the range of static IP pool used for resource bridge deployment and isn't assigned to any other machine on the network. | | **Appliance proxy settings** | Enter *Y* if there's a proxy in your appliance network, else enter *N*.| | **http** | Address of the HTTP proxy server. | | **https** | Address of the HTTPS proxy server.| | **NoProxy** | Addresses to be excluded from proxy.| |**CertificateFilePath** | For SSL based proxies, provide the path to the certificate. | When the command execution finishes, your setup is complete. You can try out the capabilities of Azure Arc-enabled SCVMM. >[!IMPORTANT] >The resource bridge must stay in *online* status for Azure Arc-enabled SCVMM to perform virtual machine CRUD and power cycle operations. To keep your resource bridge in a *healthy* state, follow the best practices listed [here](https://aka.ms/scvmmarbbestpractices). ## Recover from failed deployments If the Azure Arc resource bridge deployment fails, see the Troubleshooting section for debugging steps. To clean up the installation and retry the deployment, use the following commands. # [Retry command - Windows](#tab/win) Run the command with `-Force` to clean up and onboard again. ```powershell-interactive ./resource-bridge-onboarding-script.ps1 -Force -Subscription <Subscription> -ResourceGroup <ResourceGroup> -AzLocation <AzLocation> -ApplianceName <ApplianceName> -CustomLocationName <CustomLocationName> -VMMservername <VMMservername> ``` >[!Note] >You can find the values for *Subscription*, *ResourceGroup*, *Azlocation*, *ApplianceName*, *CustomLocationName*, and *VMMservername* parameters in the onboarding script. # [Retry command - Linux](#tab/lin) Run the command with `--force` to clean up and onboard again. ```sh bash resource-bridge-onboarding-script.sh --force ``` --- ## Next steps - [Browse and enable SCVMM resources through Azure RBAC](enable-scvmm-inventory-resources.md). - [Create a VM using Azure Arc-enabled SCVMM](create-virtual-machine.md).