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 cmdlets and Windows-specific tooling for configuring MetalLB via BGP on Azure Stack Edge. All examples, commands, and instructions are provided for the Windows environment, with no mention of Linux equivalents or cross-platform alternatives. This creates a strong Windows bias and may hinder users operating from Linux or other non-Windows systems.
Recommendations:
- Provide equivalent Linux-based instructions for configuring MetalLB via BGP, such as using SSH, kubectl, or native Linux networking tools.
- Include examples using cross-platform PowerShell Core (pwsh) where possible, and clarify any Windows-only limitations.
- Document how to perform the same configuration steps from a Linux or macOS workstation, including any required tools or prerequisites.
- Explicitly state if certain operations are only possible from Windows, and suggest workarounds or alternatives for non-Windows users.
- Where device access is required, describe both Windows and Linux connection methods (e.g., SSH, remote PowerShell, etc.).
Create pull request
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>
Remove-HcsBGPPeer -PeerAddress <IP address of the port that you enabled for compute> -SwitchName <Name of virtual switch on the port 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>