|
| 1 | +--- |
| 2 | +title: Move resources associated with a maintenance configuration to another region |
| 3 | +description: Learn how to move resources associated with a VM maintenance configuration to another Azure region |
| 4 | +services: virtual-machines |
| 5 | +author: shants123 |
| 6 | + |
| 7 | +ms.service: virtual-machines |
| 8 | +ms.topic: article |
| 9 | +ms.tgt_pltfrm: vm |
| 10 | +ms.date: 03/04/2020 |
| 11 | +ms.author: shants |
| 12 | +#Customer intent: As an admin responsible for maintenance, I want move resources associated with a Maintenance Control configuration to another Azure region. |
| 13 | +--- |
| 14 | + |
| 15 | + |
| 16 | +# Move resources in a Maintenance Control configuration to another region |
| 17 | + |
| 18 | +Follow this article to move resources associated with a Maintenance Control configuration to a different Azure region. You might want to move a configuration for a number of reasons. For example, to take advantage of a new region, to deploy features or services available in a specific region, to meet internal policy and governance requirements, or in response to capacity planning. |
| 19 | + |
| 20 | +Maintenance control, with customized maintenance configurations, allows you to control how platform updates are applied to [Windows](https://docs.microsoft.com/azure/virtual-machines/maintenance-control-cli?toc=/azure/virtual-machines/windows/toc.json&bc=/azure/virtual-machines/windows/breadcrumb/toc.json) and [Linux](https://docs.microsoft.com/azure/virtual-machines/maintenance-control-cli?toc=%2Fazure%2Fvirtual-machines%2Flinux%2Ftoc.json&bc=%2Fazure%2Fvirtual-machines%2Flinux%2Fbreadcrumb%2Ftoc.json&view=azure-java-stable) VMs, and to Azure Dedicated Hosts. There are a couple of scenarios for moving maintenance control across regions: |
| 21 | + |
| 22 | +- To move the resources associated with a maintenance configuration, but not the configuration itself, follow this article. |
| 23 | +- To move your maintenance control configuration, but not the resources associated with the configuration, follow [these instructions](move-region-maintenance-configuration.md). |
| 24 | +- To move both the maintenance configuration and the resources associated with it, first follow [these instructions](move-region-maintenance-configuration.md). Then, follow the instructions in this article. |
| 25 | + |
| 26 | +## Prerequisites |
| 27 | + |
| 28 | +Before you begin moving the resources associated with a Maintenance Control configuration: |
| 29 | + |
| 30 | +- Make sure that the resources you're moving exist in the new region before you begin. |
| 31 | +- Verify the Maintenance Control configurations associated with the Azure VMs and Azure Dedicated Hosts that you want to move. Check each resource individually. There's currently no way to retrieve configurations for multiple resources. |
| 32 | +- When retrieving configurations for a resource: |
| 33 | + - Make sure you use the subscription ID for the account, not an Azure Dedicated Host ID. |
| 34 | + - CLI: The --output table parameter is used for readability only, and can be deleted or changed. |
| 35 | + - PowerShell: The Format-Table Name parameter is used for readability only, and can be deleted or changed. |
| 36 | + - If you use PowerShell, you get an error if you try to list configurations for a resource that doesn't have any associated configurations. The error will be similar to: "Operation failed with status: 'Not Found'. Details: 404 Client Error: Not Found for url". |
| 37 | + |
| 38 | + |
| 39 | +## Prepare to move |
| 40 | + |
| 41 | +1. Before you start, define these variables. We've provided an example for each. |
| 42 | + |
| 43 | + **Variable** | **Details** | **Example** |
| 44 | + --- | --- |
| 45 | + $subId | ID for subscription containing the maintenance configurations | "our-subscription-ID" |
| 46 | + $rsrcGroupName | Resource group name (Azure VM) | "VMResourceGroup" |
| 47 | + $vmName | VM resource name | "myVM" |
| 48 | + $adhRsrcGroupName | Resource group (Dedicated hosts) | "HostResourceGroup" |
| 49 | + $adh | Dedicated host name | "myHost" |
| 50 | + $adhParentName | Parent resource name | "HostGroup" |
| 51 | + |
| 52 | +2. To retrieve the maintenance configurations using the PowerShell [Get-AZConfigurationAssignment](https://docs.microsoft.com/powershell/module/az.maintenance/Get-AzConfigurationAssignment?view=azps-3.5.0) command: |
| 53 | + |
| 54 | + - For Azure Dedicated Hosts, run: |
| 55 | + ``` |
| 56 | + Get-AzConfigurationAssignment -ResourceGroupName $adhRsrcGroupName -ResourceName $adh -ResourceType hosts -ProviderName Microsoft.Compute -ResourceParentName $adhParentName -ResourceParentType hostGroups | Format-Table Name |
| 57 | + ``` |
| 58 | +
|
| 59 | + - For Azure VMs, run: |
| 60 | +
|
| 61 | + ``` |
| 62 | + Get-AzConfigurationAssignment -ResourceGroupName $rgName -ResourceName $vmName -ProviderName Microsoft.Compute -ResourceType virtualMachines | Format-Table Name |
| 63 | + ``` |
| 64 | +3. To retrieve the maintenance configurations using the CLI [az maintenance assignment](https://docs.microsoft.com/cli/azure/ext/maintenance/maintenance/assignment?view=azure-cli-latest) command: |
| 65 | +
|
| 66 | + - For Azure Dedicated Hosts: |
| 67 | +
|
| 68 | + ``` |
| 69 | + az maintenance assignment list --subscription $subId --resource-group $adhRsrcGroupName --resource-name $adh --resource-type hosts --provider-name Microsoft.Compute --resource-parent-name $adhParentName --resource-parent-type hostGroups --query "[].{HostResourceGroup:resourceGroup,ConfigName:name}" --output table |
| 70 | + ``` |
| 71 | +
|
| 72 | + - For Azure VMs: |
| 73 | +
|
| 74 | + ``` |
| 75 | + az maintenance assignment list --subscription $subId --provider-name Microsoft.Compute --resource-group $rsrcGroupName --resource-name $vmName --resource-type virtualMachines --query "[].{HostResourceGroup:resourceGroup, ConfigName:name}" --output table |
| 76 | + ``` |
| 77 | +
|
| 78 | +
|
| 79 | +## Move |
| 80 | +
|
| 81 | +1. [Follow these instructions](https://docs.microsoft.com/azure/site-recovery/azure-to-azure-tutorial-migrate?toc=/azure/virtual-machines/windows/toc.json&bc=/azure/virtual-machines/windows/breadcrumb/toc.json) to move the Azure VMs to the new region. |
| 82 | +2. After the resources are moved, reapply maintenance configurations to the resources in the new region as appropriate, depending on whether you moved the maintenance configurations. You can apply a maintenance configuration to a resource using [PowerShell](../virtual-machines/maintenance-control-powershell.md) or [CLI](../virtual-machines/maintenance-control-cli.md). |
| 83 | +
|
| 84 | +
|
| 85 | +## Verify the move |
| 86 | +
|
| 87 | +Verify resources in the new region, and verify associated configurations for the resources in the new region. |
| 88 | +
|
| 89 | +## Clean up source resources |
| 90 | +
|
| 91 | +After the move, consider deleting the moved resources in the source region. |
| 92 | +
|
| 93 | +
|
| 94 | +## Next steps |
| 95 | +
|
| 96 | +Follow [these instructions](move-region-maintenance-configuration.md) if you need to move maintenance configurations. |
0 commit comments