Relocation Key Vault - Document Details

About This Page

This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.

View on GitHub 📚 View on Microsoft Learn

Bias Analysis

Detected Bias Types

powershell_heavy

missing_linux_example

windows_first

Summary

The documentation page demonstrates a Windows/PowerShell bias by providing detailed PowerShell instructions and examples, while omitting equivalent Azure CLI (cross-platform) or Bash examples. The PowerShell approach is presented as the only scripting alternative to the Azure Portal, and there are no explicit Linux or macOS command-line instructions. References to obtaining region codes and resource management are given only in PowerShell, not in Azure CLI. This may disadvantage users on Linux or macOS, or those who prefer cross-platform tools.

Recommendations

Add Azure CLI examples alongside PowerShell for all operations, including exporting and deploying templates, obtaining region codes, and managing resources.
Include Bash shell snippets where appropriate, especially for file operations or scripting steps.
When listing options for configuring resources (such as service endpoints), mention Azure CLI before or alongside PowerShell, to avoid 'windows_first' ordering.
Explicitly state that all steps can be performed on Linux/macOS using Azure CLI, and provide links to relevant CLI documentation.
Consider adding a tabbed interface for 'Azure CLI', 'PowerShell', and 'Portal' to ensure parity and clarity for all platforms.

Create Pull Request

Scan History

Date	Scan	Status	Result
2025-07-12 23:44	#41	cancelled	Biased
2025-07-12 00:58	#8	cancelled	Clean
2025-07-10 05:06	#7	processing	Clean

Flagged Code Snippets

### [PowerShell](#tab/azure-powershell)

To deploy the template by using PowerShell:

1. In the **template.json** file, name the target key vault by setting the default value of the key vault name. This example sets the default value of the key vault name to `key-vault-name`.

   You can obtain region codes by running the [Get-AzLocation](/powershell/module/az.resources/get-azlocation) command.

---

### Redeploy

Deploy the template to create a new key vault in the target region.

#### [Portal](#tab/azure-portal)

1. Save the **template.json** file.
1. Enter or select the property values:

   - **Subscription**: Select an Azure subscription.
   - **Resource group**: Select **Create new** and give the resource group a name.
   - **Location**: Select an Azure location.

1. Select **I agree to the terms and conditions stated above**, and then select **Select Purchase**.
1. Access Policies and Network configuration settings (private endpoints) need to be re-configured in the new Key Vault. Soft delete and purge protection need to be re-configured in the new key vault and the _Autorotation settings_.

#### [PowerShell](#tab/azure-powershell)

1. Obtain the subscription ID where you want to deploy the target public IP with [Get-AzSubscription](/powershell/module/az.accounts/get-azsubscription):