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
⚠️ windows_tools
⚠️ missing_linux_example
⚠️ windows_first
Summary:
The documentation exclusively uses Windows PowerShell and Windows-specific cmdlets for configuring MetalLB via BGP on Azure Stack Edge. All examples, instructions, and sample outputs are based on the Windows environment, with no mention of Linux equivalents or cross-platform alternatives. There is no guidance for users who may want to perform similar tasks from a Linux or non-Windows environment.
Recommendations:
  • Provide equivalent Linux-based instructions, such as using SSH and standard Linux networking tools (e.g., ip, nmcli, or BGP daemons like FRR or Bird) for configuring BGP sessions if supported.
  • Include examples using cross-platform PowerShell Core (pwsh) and clarify any differences in command usage or prerequisites.
  • Explicitly state if configuration is only possible via Windows PowerShell, and if so, explain why and suggest workarounds for Linux users (e.g., using a Windows jump host or container).
  • Add a section comparing Windows and Linux approaches, or at least acknowledge the lack of Linux support and provide links to relevant Linux-native MetalLB/BGP configuration guides.
  • Where possible, use platform-neutral language and tools, or provide parallel instructions for both Windows and Linux environments.
GitHub Create pull request

Scan History

Date Scan ID Status Bias Status
2025-08-17 00:01 #83 in_progress ✅ Clean
2025-07-13 21:37 #48 completed ❌ Biased
2025-07-09 13:09 #3 cancelled ✅ Clean
2025-07-08 04:23 #2 cancelled ❌ Biased

Flagged Code Snippets

Get-HcsExternalVirtualSwitch
Set-HcsBGPPeer -PeerAddress <IP address of the port that you enabled for compute> -PeerAsn <ASN for the peer> -SelfAsn <Your ASN> -SwitchName <Name of virtual switch on the port enabled for compute> -HoldTimeInSeconds <Optional hold time in seconds>
Get-HcsBGPPeers -SwitchName <Name of virtual switch that you enabled for compute>
Windows PowerShell Copyright (C) Microsoft Corporation. All rights reserved. Try the new cross-platform PowerShell https://aka.ms/pscore6 PS C:\WINDOWS\system32> $Name = "dbe-1csphq2.microsoftdatabox.com" PS C:\WINDOWS\system32> Set-Item WSMan:\localhost\Client\TrustedHosts $Name -Concatenate -Force PS C:\WINDOWS\system32> $sessOptions = New-PSSessionOption -SkipCACheck -SkipCNCheck -SkipRevocationCheck PS C:\WINDOWS\system32> Enter-PSSession -ComputerName $Name -Credential ~\EdgeUser -ConfigurationName Minishell -UseSSL -SessionOption $sessOptions WARNING: The Windows PowerShell interface of your device is intended to be used only for the initial network configuration. Please engage Microsoft Support if you need to access this interface to troubleshoot any potential issues you may be experiencing. Changes made through this interface without involving Microsoft Support could result in an unsupported configuration. [dbe-1csphq2.microsoftdatabox.com]: PS>Get-HcsExternalVirtualSwitch Name : vSwitch1 InterfaceAlias : {Port2} EnableIov : False MacAddressPools : IPAddressPools : {} BGPPeers : ConfigurationSource : Dsc EnabledForCompute : False EnabledForStorage : False EnabledForMgmt : True SupportsAcceleratedNetworking : False DbeDhcpHostVnicName : 3cb2d0ae-6a7b-44cc-8a5d-8eac2d1c0436 VirtualNetworks : {} EnableEmbeddedTeaming : True Vnics : {} Type : External Name : vSwitch2 InterfaceAlias : {Port3, Port4} EnableIov : False MacAddressPools : IPAddressPools : {} BGPPeers : ConfigurationSource : Dsc EnabledForCompute : False EnabledForStorage : True EnabledForMgmt : False SupportsAcceleratedNetworking : False DbeDhcpHostVnicName : 8dd480c0-8f22-42b1-8621-d2a43f70690d VirtualNetworks : {} EnableEmbeddedTeaming : True Vnics : {} Type : External [dbe-1csphq2.microsoftdatabox.com]: PS>Set-HcsBGPPeer -PeerAddress 10.126.77.125 -PeerAsn 64512 -SelfAsn 64513 -SwitchName vSwitch1 -HoldTimeInSeconds 15 [dbe-1csphq2.microsoftdatabox.com]: PS>Get-HcsBGPPeers -SwitchName vSwitch1 PeerAddress PeerAsn SelfAsn HoldTime ----------- ------- ------- -------- 10.126.77.125 64512 64513 15 [dbe-1csphq2.microsoftdatabox.com]: PS>Remove-HcsBGPPeer -PeerAddress 10.126.77.125 -SwitchName vSwitch1 [dbe-1csphq2.microsoftdatabox.com]: PS>Get-HcsBGPPeers -SwitchName vSwitch1 [dbe-1csphq2.microsoftdatabox.com]: PS>