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 tools for configuring MetalLB via BGP on Azure Stack Edge, with no mention or examples of Linux-based workflows or CLI equivalents. All configuration steps and example outputs are Windows/PowerShell-centric, and there is no guidance for users operating from a Linux environment.
Recommendations:
- Provide equivalent Linux command-line instructions (e.g., using SSH, kubectl, or Linux networking tools) for configuring MetalLB and BGP.
- Include examples of how to connect to the device and perform necessary configuration steps from a Linux or cross-platform shell.
- Mention any platform-specific limitations or requirements up front, and clarify if configuration is only possible via Windows tools.
- If PowerShell is required, note the availability of cross-platform PowerShell Core and provide examples for both Windows and Linux environments.
- Add troubleshooting and verification steps that can be performed from Linux systems.
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>