Document Details
Relocation Virtual Network
❌
This page contains Windows bias
About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Bias Types:
⚠️
powershell_heavy
⚠️
missing_linux_example
⚠️
windows_tools
Summary:
The documentation provides detailed instructions for the Azure Portal and Azure PowerShell, but does not include any examples or guidance for Linux users or cross-platform CLI tools such as Azure CLI. The PowerShell examples assume a Windows environment (e.g., use of 'notepad' for editing files), and there are no Bash or shell script equivalents. This creates a bias toward Windows and PowerShell users, leaving Linux and macOS users without parity in command-line instructions.
Recommendations:
- Add equivalent Azure CLI (az) examples for all PowerShell steps, including exporting, editing, and deploying ARM templates.
- Provide cross-platform file editing instructions (e.g., using 'vi', 'nano', or 'code' editors) instead of only 'notepad'.
- Explicitly mention that PowerShell Core is available on Linux/macOS, or clarify if the instructions are Windows-only.
- Ensure that all command-line steps are presented for both PowerShell and Azure CLI, with clear tabs or sections for each.
- Include notes or links for Linux/macOS users on how to perform each step, especially for file manipulation and command execution.
Create pull request
Scan History
| Date | Scan ID | Status | Bias Status |
|---|---|---|---|
| 2025-09-16 00:00 | #113 | completed | ✅ Clean |
| 2025-08-17 00:01 | #83 | in_progress | ✅ Clean |
| 2025-07-13 21:37 | #48 | completed | ❌ Biased |
Flagged Code Snippets
1. Obtain the resource ID of the virtual network that you want to move to the target region, and then place it in a variable by using [Get-AzVirtualNetwork](/powershell/module/az.network/get-azvirtualnetwork):
1. To obtain region location codes, you can use the Azure PowerShell cmdlet [Get-AzLocation](/powershell/module/az.resources/get-azlocation) by running the following command:
1. Save the *\<resource-group-name>.json* file.
---
## Redeploy
# [Portal](#tab/azure-portal)
1. To choose the subscription where the target virtual network is deployed, select **Basics** > **Subscription**.
1. To choose the resource group where the target virtual network is deployed, select **Basics** > **Resource group**.
If you need to create a new resource group for the target virtual network, select **Create new**. Make sure that the name isn't the same as the source resource group name in the existing virtual network.
1. Verify that **Basics** > **Location** is set to the target location where you want the virtual network to be deployed.
1. Under **Settings**, verify that the name matches the name that you entered previously in the parameters editor.
1. Select the **Terms and Conditions** check box.
1. To deploy the target virtual network, select **Purchase**.
1. [Reconfigure Virtual Network Peering](/azure/virtual-network/virtual-network-manage-peering).
1. Enable Connection Monitor by following the guidelines in ([Migrate to Connection monitor from Network performance monitor](/azure/network-watcher/migrate-to-connection-monitor-from-network-performance-monitor)).
1. Enable the DDoS Protection Plan. After the move, the autotuned policy thresholds for all the protected public IP addresses in the virtual network are reset.
- (Optional) Reconfigure the Network security Group (NSG), Application Security Group (ASG), and User Defined Route (UDR) to the target virtual network subnet which was previously associated to source virtual network subnet and now moved to target region.
- (Optional) Reconfigure the NAT-Gateway to the target virtual network subnet which was previously associated to source virtual network subnet and now moved to target region.
- (Optional) Diagnostic settings: Reconfigure the diagnostic setting for the target virtual network to send the logs to log analytic workspace/storage account/event hub which was relocated as mentioned in prepare.
# [PowerShell](#tab/azure-powershell)
1. Create a resource group in the target region for the target virtual network to be deployed by using [New-AzResourceGroup](/powershell/module/az.resources/new-azresourcegroup):
- Delete the source virtual network by using [Remove-AzVirtualNetwork](/powershell/module/az.network/remove-azvirtualnetwork):