Document Details

Cache How To Active Geo Replication
Home / Scan #41 / Cache How To Active Geo Replication
Sad Tux - Windows bias detected
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.
GitHub View on GitHub 📚 View on Microsoft Learn

Bias Analysis

Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for configuring active geo-replication, but it demonstrates a Windows bias by listing PowerShell (a Windows-centric tool) as a primary automation method alongside CLI, and does not provide any Linux shell (bash) or cross-platform scripting examples. There are no explicit Linux-specific instructions or screenshots, and the PowerShell section is as prominent as the CLI section, which may disadvantage Linux users. Additionally, there is no mention of using Azure Cloud Shell (which is cross-platform) or guidance for Linux/macOS environments.
Recommendations
  • Add explicit bash shell examples for all CLI commands, including any necessary export or environment variable steps for Linux/macOS users.
  • Clarify that Azure CLI commands work identically on Windows, Linux, and macOS, and recommend Azure Cloud Shell as a cross-platform option.
  • Reorder sections so that CLI (which is cross-platform) appears before PowerShell, or clearly indicate that PowerShell is primarily for Windows users.
  • Include notes or screenshots showing the experience on Linux/macOS where relevant, or mention any OS-specific considerations.
  • If there are differences in command syntax or prerequisites for Linux/macOS, document them explicitly.
GitHub Create Pull Request

Scan History

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

Flagged Code Snippets

As before, you need to list both _Cache1_ and _Cache2_ using the `--linked-databases` parameter.

### Azure PowerShell

Use Azure PowerShell to create a new cache and geo-replication group, or to add a new cache to an existing geo-replication group. For more information, see [New-AzRedisEnterpriseCache](/powershell/module/az.redisenterprisecache/new-azredisenterprisecache).

#### Create new Enterprise instance in a new geo-replication group using PowerShell

This example creates a new Azure Cache for Redis Enterprise E10 cache instance called _Cache1_ in the East US region. Then, the cache is added to a new active geo-replication group called _replicationGroup_:


To configure active geo-replication properly, the ID of the cache instance being created must be added with the `-LinkedDatabase` parameter. The ID is in the format:

`/subscriptions/<your-subscription-ID>/resourceGroups/<your-resource-group-name>/providers/Microsoft.Cache/redisEnterprise/<your-cache-name>/databases/default`

#### Create new Enterprise instance in an existing geo-replication group using PowerShell

This example creates a new Enterprise E10 cache instance called _Cache2_ in the West US region. Then, the script adds the cache to the _replicationGroup_ active geo-replication group created in the previous procedure. After the running the command, the two caches, _Cache1_ and _Cache2_, are linked in an active-active configuration.