Virtual Machines
1073
Total Pages
1027
Linux-Friendly Pages
46
Pages with Bias
4.3%
Bias Rate
Bias Trend Over Time
Pages with Bias Issues
284 issues found
Showing 251-275 of 284 flagged pages
Virtual Machines
Enable Trusted launch on existing Gen2 VMs
...rticles/virtual-machines/trusted-launch-existing-vm.md
Low Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation provides parity for both Linux and Windows VMs, explicitly stating applicability to both. However, there is a mild Windows bias in the ordering and tooling: PowerShell examples are included and shown before Linux-native alternatives, and some steps (such as VM deallocation in the ARM template section) use PowerShell syntax exclusively, even though Linux users would use Bash or Azure CLI. The verification step mentions RDP (Windows) before SSH (Linux) throughout. All CLI examples use Azure CLI, which is cross-platform, but PowerShell is given equal prominence, which may be less relevant for Linux/macOS users.
Recommendations
- Where PowerShell is used for generic Azure operations (e.g., deallocating VMs), provide equivalent Azure CLI or Bash examples, especially in sections like ARM template deployment.
- When listing verification steps, alternate or parallelize RDP/SSH references, or mention SSH first in Linux-focused contexts.
- Consider clarifying that PowerShell examples are primarily for Windows users, and recommend Azure CLI/Bash for Linux/macOS users.
- Ensure screenshots and UI references are not Windows-centric if possible.
Create Pull Request
Low Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Minor Windows Tools
Summary
The documentation provides both Azure CLI and PowerShell examples for configuring VM vCore customization, but PowerShell (a Windows-centric tool) is given its own section and detailed example. The CLI example uses Ubuntu as the image, showing Linux applicability, but the PowerShell section appears before ARM template automation and is presented as a primary method. There is a slight Windows-first ordering in the examples and tool references, but Linux users can fully complete the tasks using CLI, ARM templates, and the portal.
Recommendations
- Add explicit Bash or shell scripting examples for Linux users, especially for automation scenarios.
- Clarify that Azure CLI commands work cross-platform (Windows, Linux, macOS) and highlight this in the CLI section.
- Consider reordering sections so that cross-platform tools (CLI, ARM templates) appear before Windows-specific tools (PowerShell).
- Add a note in the PowerShell section indicating its Windows-centric nature and suggest CLI for Linux/macOS users.
Virtual Machines
Time sync for Linux VMs in Azure
...blob/main/articles/virtual-machines/linux/time-sync.md
Low Priority
View Details →
Detected Bias Types
Windows First
Summary
The documentation is focused on Linux VM time synchronization in Azure and provides detailed, Linux-specific guidance and examples. However, the introductory section and overview spend several paragraphs describing Windows Server 2016 time sync improvements and Windows infrastructure before discussing Linux-specific mechanisms. All technical instructions, examples, and configuration steps are Linux-centric, with no PowerShell or Windows tool bias in the practical guidance.
Recommendations
- Move the Windows Server 2016 time sync discussion to a background or reference section, or summarize it more briefly before focusing on Linux-specific details.
- Begin the page with Linux VM time sync concepts and Azure-specific mechanisms, referencing Windows infrastructure only as necessary for context.
- Ensure that Linux instructions and examples are always presented first and most prominently on Linux-focused documentation pages.
Virtual Machines
Azure Key Vault VM Extension for Linux
...rticles/virtual-machines/extensions/key-vault-linux.md
Low Priority
View Details →
Detected Bias Types
Windows Tools
Powershell Heavy
Windows First
Summary
The documentation is generally Linux-focused, as expected for the Key Vault VM Extension for Linux. However, there are several instances where Windows-centric tools and patterns (notably Azure PowerShell) are presented prominently or before Linux-native alternatives. PowerShell deployment instructions are detailed and appear before Azure CLI examples, and troubleshooting guidance references Azure PowerShell before Azure CLI. There is also a reference to a Windows VM access policy guide in the template deployment section, which may confuse Linux users.
Recommendations
- Present Azure CLI examples before Azure PowerShell, as CLI is cross-platform and native to Linux/macOS.
- Clarify that Azure PowerShell is optional and primarily for Windows users; highlight CLI as the recommended approach for Linux.
- In troubleshooting sections, show Azure CLI commands first, and add Bash scripting examples where appropriate.
- Remove or clarify references to Windows-specific documentation (e.g., access policy guides for Windows VMs) and link to Linux-relevant guides.
- Add explicit notes about tool compatibility (e.g., Azure PowerShell on Linux) if PowerShell instructions are retained.
Low Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation provides both Azure CLI and PowerShell examples for checking vCPU quotas, but the PowerShell example is given equal prominence despite PowerShell being primarily a Windows tool. The CLI example (cross-platform) is shown first, which is positive, but the inclusion of PowerShell may create a slight Windows-centric impression. No Linux-specific tools or shell examples are provided, but the CLI is sufficient for Linux/macOS users.
Recommendations
- Clarify that Azure CLI works on Windows, Linux, and macOS.
- Consider adding a brief Bash shell example for parsing CLI output, if relevant.
- Explicitly state that PowerShell is primarily for Windows users, and CLI is recommended for cross-platform usage.
- Ensure that future documentation does not assume PowerShell as the default for automation unless the audience is Windows-focused.
Virtual Machines
Enable Trusted launch on existing Gen2 VMs
...rticles/virtual-machines/trusted-launch-existing-vm.md
Low Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation provides parity for both Linux and Windows VMs, explicitly stating applicability to both. However, there is a mild Windows bias in the ordering and example tooling: PowerShell examples are given alongside CLI and ARM template, but PowerShell is a Windows-centric tool and is presented before Linux-native alternatives. Additionally, in the portal instructions, RDP (Windows) is mentioned before SSH (Linux) when verifying VM access. There are no missing Linux examples, and Linux-specific validation (SBInfo tool) is called out in best practices.
Recommendations
- Present SSH (Linux) and RDP (Windows) access instructions in parallel or with equal prominence.
- Clarify that PowerShell can be used cross-platform, or provide Bash scripting examples for Linux users where appropriate.
- Consider listing CLI and template methods before PowerShell, as these are more platform-neutral.
- Continue to highlight Linux-specific validation steps, as done with SBInfo.
Low Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation provides both Azure CLI and PowerShell examples for checking vCPU quotas, but the PowerShell example is given equal prominence and detail, despite PowerShell being primarily a Windows tool. The CLI example is shown first, which is positive, but the presence of a dedicated PowerShell tab and example may signal a slight Windows bias, especially since Linux users are less likely to use PowerShell.
Recommendations
- Clarify that PowerShell is primarily for Windows users, and recommend Azure CLI for cross-platform usage.
- Add a note that Azure CLI works natively on Linux/macOS, while PowerShell requires installation and configuration on those platforms.
- Consider including Bash or shell scripting examples for Linux users, if relevant.
- Explicitly state platform compatibility for each tool in the documentation.
Virtual Machines
Azure Key Vault VM Extension for Linux
...rticles/virtual-machines/extensions/key-vault-linux.md
Low Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows First
Summary
While the documentation is focused on a Linux-specific Azure VM extension, it provides both Azure PowerShell and Azure CLI deployment instructions. However, PowerShell examples and troubleshooting commands are presented before CLI equivalents, and PowerShell-specific warnings are included. This ordering and emphasis may create friction for Linux users, who are more likely to use Azure CLI or native Linux tools.
Recommendations
- Present Azure CLI examples before PowerShell examples in all sections, as CLI is more commonly used on Linux.
- Add explicit notes clarifying that PowerShell is optional and primarily for users on Windows or those who prefer it.
- Where troubleshooting commands are shown, list Azure CLI commands first and ensure parity in troubleshooting guidance.
- Consider removing PowerShell-specific warnings from the main flow, or move them to a dedicated section for Windows users.
- Highlight Linux-native workflows and tools (e.g., bash scripting, systemd integration) where relevant.
Virtual Machines
Time sync for Linux VMs in Azure
...blob/main/articles/virtual-machines/linux/time-sync.md
Low Priority
View Details →
Detected Bias Types
Windows First
Summary
The documentation page is focused on time synchronization for Linux VMs in Azure and provides comprehensive Linux-specific guidance and examples. However, the introduction and overview sections discuss Windows Server 2016 time sync improvements and link to Windows documentation before fully addressing Linux-specific mechanisms. All configuration, troubleshooting, and example commands are Linux-centric, with only a single PowerShell snippet shown for base64 encoding cloud-init data (which is relevant for Azure ARM template usage, not time sync itself). No Linux examples are missing, and no Windows tools are recommended for Linux VM management.
Recommendations
- Move or minimize Windows Server 2016 time sync discussion to a background or context section, making it clear that the rest of the page is Linux-focused.
- Add a brief note explaining why Windows time sync improvements are relevant to Linux VM users (e.g., because Azure hosts run Windows Server and this affects host time accuracy).
- Consider providing a Linux shell command alternative for base64 encoding cloud-init data, since the PowerShell example may not be directly usable by Linux/macOS users.
- Ensure that all actionable steps and examples remain Linux-centric and that any Windows references are clearly contextual/background.
Low Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Missing Linux Example
Summary
The documentation provides both Azure CLI and PowerShell examples for configuring VM vCore customization, but the PowerShell example is given equal prominence to the CLI example, and there is no explicit Linux shell (bash) example. The CLI example uses an Ubuntu image, but does not show Linux-specific shell usage or mention Linux tooling. The PowerShell section is detailed and uses Windows-centric SDK objects, while Linux users are expected to use the CLI or ARM templates without further guidance. The order of presentation (CLI, then PowerShell) is neutral, but the lack of explicit Linux shell examples and the presence of detailed PowerShell instructions indicate a mild Windows bias.
Recommendations
- Add explicit bash shell examples for Linux/macOS users, showing how to use az vm create and az vm list-skus in a Linux terminal.
- Clarify that Azure CLI commands work on all platforms and provide notes or examples for Linux/macOS environments.
- Reduce reliance on PowerShell SDK object manipulation, or provide equivalent scripting examples for Linux (e.g., using Azure CLI with jq or other Linux tools).
- Consider presenting CLI and ARM template examples before PowerShell, or grouping them by platform.
Virtual Machines
Enable Trusted launch on existing Gen2 VMs
...rticles/virtual-machines/trusted-launch-existing-vm.md
Low Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Windows Tools
Summary
The documentation provides parity for both Linux and Windows VMs in terms of feature applicability and CLI/PowerShell/Portal/ARM template instructions. However, there is a mild Windows bias: PowerShell examples are given equal prominence to Azure CLI, and PowerShell is a Windows-centric tool. In some sections, RDP (Windows) is mentioned before SSH (Linux) when verifying VM access. Additionally, the template deployment steps use PowerShell for ARM template deployment, without mentioning Bash or cross-platform alternatives. The documentation does mention Linux-specific validation (SBInfo tool), but overall, Windows tools and patterns are slightly prioritized.
Recommendations
- In ARM template deployment sections, provide Bash/az CLI examples for deploying templates, not just PowerShell.
- When listing access methods, alternate or list SSH (Linux) before RDP (Windows) in some places.
- Explicitly mention that all CLI and template steps work on Linux/macOS, and provide sample commands for Bash where PowerShell is shown.
- Clarify that Azure CLI is cross-platform and recommend it as the default for Linux/macOS users.
Virtual Machines
Time sync for Linux VMs in Azure
...blob/main/articles/virtual-machines/linux/time-sync.md
Low Priority
View Details →
Detected Bias Types
Windows First
Summary
The documentation page is focused on Linux VM time sync in Azure and provides comprehensive Linux-specific guidance. However, the introductory section discusses Windows Server 2016 time sync improvements and links to Windows documentation before delving into Linux-specific mechanisms. No Windows-only tools or examples are given, and all configuration and troubleshooting steps are Linux-centric.
Recommendations
- Move the Windows Server 2016 time sync discussion to a background or infrastructure section, making it clear it's context for Azure hosts, not actionable for Linux VM admins.
- Begin the page with Linux-specific time sync concepts and configuration options.
- Ensure that 'Next steps' and reference links prioritize Linux resources over Windows ones, unless specifically relevant to Azure host infrastructure.
Virtual Machines
Enable Trusted launch on existing Gen2 VMs
...rticles/virtual-machines/trusted-launch-existing-vm.md
Low Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation provides parity for both Linux and Windows VMs, explicitly stating applicability to both. However, there is a mild Windows bias in the ordering and tooling: PowerShell examples are given equal prominence as CLI, and in some sections (e.g., ARM template deployment and VM deallocation), PowerShell is used as the default scripting language, which is more native to Windows. Additionally, in step-by-step instructions, RDP (Windows) is mentioned before SSH (Linux), and screenshots are Windows-centric. There are no missing Linux examples, and Linux-specific considerations (such as Secure Boot validation with SBInfo) are included.
Recommendations
- Where scripting is required (e.g., deallocation, template deployment), provide both PowerShell and Bash/Azure CLI examples, or clarify that PowerShell can be used cross-platform.
- Alternate the order of RDP/SSH mentions, or mention SSH first when discussing Linux VMs.
- Include screenshots from both Windows and Linux VM contexts, or use more generic images.
- Explicitly state that PowerShell can be used on Linux/macOS, or recommend Bash/CLI alternatives for Linux users.
- Where possible, clarify that all steps apply equally to Linux and Windows VMs, and highlight any OS-specific caveats.
Virtual Machines
Enable Trusted launch on existing Gen2 VMs
...rticles/virtual-machines/trusted-launch-existing-vm.md
Low Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation provides parity for both Linux and Windows VMs when enabling Trusted launch, with clear notes and instructions applicable to both platforms. However, there is a mild Windows bias in the ordering and example tooling: PowerShell examples are shown alongside CLI and template methods, and PowerShell is referenced for ARM template deployment and VM deallocation, which is more common on Windows. Additionally, in several places, RDP (Windows) is mentioned before SSH (Linux) when verifying VM access.
Recommendations
- Where PowerShell is used for generic Azure VM operations (deallocation, deployment), provide equivalent Bash or Azure CLI examples for Linux/macOS users.
- When listing access methods (RDP/SSH), alternate or list SSH first in Linux-specific contexts.
- Clarify that PowerShell commands can be run cross-platform (Windows, Linux, macOS) if true, or provide Bash/CLI alternatives.
- Consider including Bash scripts for ARM template deployment and VM deallocation to improve Linux parity.
Virtual Machines
Create a Gallery for Sharing Resources
.../blob/main/articles/virtual-machines/create-gallery.md
Low Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation provides examples for creating an Azure Compute Gallery using the Portal, Azure CLI, PowerShell, and REST API. While the CLI and REST examples are cross-platform, PowerShell is Windows-centric and is presented as a primary method alongside CLI and Portal. The PowerShell example is given equal prominence to CLI, but there is no mention of Linux/macOS equivalents for scripting (e.g., Bash), and PowerShell is not explicitly marked as Windows-only. Additionally, the ordering of examples sometimes places PowerShell before REST, which may subtly reinforce Windows-centric workflows.
Recommendations
- Clearly indicate that PowerShell examples are intended for Windows users, and suggest CLI or REST for Linux/macOS users.
- Consider providing Bash script examples for Linux/macOS users where appropriate, or clarify that Azure CLI is the recommended cross-platform tool.
- Reorder example tabs so that CLI (cross-platform) appears before PowerShell, or group Windows-specific tooling separately.
- Add a note at the start of the examples section explaining which tools are cross-platform and which are Windows-specific.
Virtual Machines
Time sync for Linux VMs in Azure
...blob/main/articles/virtual-machines/linux/time-sync.md
Low Priority
View Details →
Detected Bias Types
Windows First
Summary
The documentation page is focused on time synchronization for Linux VMs in Azure and provides comprehensive Linux-specific guidance and examples. However, the introduction and overview sections discuss Windows Server 2016 time sync improvements and Windows Time Service before explaining Linux mechanisms. All technical instructions, configuration steps, and examples are Linux-centric, with only one minor PowerShell snippet shown for base64 encoding a cloud-init file (which is an Azure ARM template pattern, not a time sync operation). No Windows tools or PowerShell-heavy bias is present in the core guidance.
Recommendations
- Move or condense the Windows Server 2016 time sync discussion to a background or context section, making it clear that the focus is on Linux VM configuration.
- Consider providing a Linux-native command for base64 encoding the cloud-init file (e.g., `base64 cloud-config.txt`) alongside the PowerShell example for ARM template users on Linux/macOS.
- Ensure that links and references in the 'Next steps' section prioritize Linux resources over Windows ones, or clearly separate them.
Virtual Machines
Azure Key Vault VM Extension for Linux
...rticles/virtual-machines/extensions/key-vault-linux.md
Low Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation is generally Linux-focused, as expected for the Azure Key Vault VM Extension for Linux. However, there are several instances where Windows-oriented tools (PowerShell) are presented before or alongside Linux-native alternatives, and PowerShell deployment examples are given equal or greater prominence than Azure CLI (which is more common on Linux). The troubleshooting section also lists PowerShell before CLI. There are no missing Linux examples, and all technical details are Linux-specific.
Recommendations
- Present Azure CLI examples before PowerShell examples in all deployment and troubleshooting sections, as CLI is more native to Linux environments.
- Explicitly note that PowerShell examples are optional for Linux users and primarily for those who prefer PowerShell cross-platform.
- Add brief instructions for running Azure CLI commands on Linux (e.g., bash syntax, file path conventions) to reinforce Linux parity.
- In troubleshooting, list CLI commands first and clarify that PowerShell is available for users who have it installed on Linux.
Low Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation provides both Azure CLI and PowerShell examples for checking vCPU quotas, but the PowerShell example is given equal prominence and detail as the CLI example, despite PowerShell being primarily a Windows tool. The CLI example is suitable for Linux/macOS, but PowerShell is listed as a main tab, which may imply parity or preference for Windows users. There is no explicit Linux/macOS bias, but the presence and prominence of PowerShell may create minor friction for non-Windows users.
Recommendations
- Clarify that PowerShell is primarily for Windows users, and recommend Azure CLI for Linux/macOS.
- Consider listing the CLI example first, as it is cross-platform.
- Add a note explaining platform compatibility for each tool.
- If possible, provide Bash or shell script examples for Linux users, or clarify that Azure CLI is the recommended approach for Linux/macOS.
Virtual Machines
Time sync for Linux VMs in Azure
...blob/main/articles/virtual-machines/linux/time-sync.md
Low Priority
View Details →
Detected Bias Types
Windows First
Summary
The documentation page is focused on time synchronization for Linux VMs in Azure and provides comprehensive Linux-specific guidance, examples, and tooling. However, the introductory section discusses Windows Server 2016 time sync improvements and links to Windows documentation before delving into Linux-specific content. No PowerShell or Windows-only tools are used in the main configuration or troubleshooting sections, except for a single PowerShell example for base64 encoding cloud-init (which is relevant for Azure ARM templates, but could be supplemented with Linux alternatives). All configuration and troubleshooting steps are Linux-centric.
Recommendations
- Move or minimize the Windows Server 2016 time sync discussion in the introduction, or clarify its relevance to Linux VMs (e.g., as the underlying Azure host).
- Provide a Linux shell alternative for the PowerShell base64 encoding example (e.g., `base64 ./cloud-config.txt`).
- Ensure that Linux documentation links are presented before or alongside Windows links in the 'Next steps' section.
- Add a brief note explaining why Windows time sync is mentioned (i.e., Azure hosts run Windows Server 2016, which impacts Linux VM time sync).
Low Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation provides both Azure CLI and PowerShell examples for checking vCPU quotas, but the PowerShell example is given equal prominence and detail as the CLI example. The CLI example is cross-platform (Linux, macOS, Windows), while PowerShell is primarily Windows-focused (though PowerShell Core is available on Linux/macOS, most Azure users associate it with Windows). The tabs present CLI first, but the PowerShell section is not clearly marked as Windows-specific, which may create confusion or friction for Linux/macOS users.
Recommendations
- Explicitly note that PowerShell examples are primarily for Windows users, and clarify PowerShell Core compatibility for Linux/macOS.
- Highlight Azure CLI as the recommended cross-platform method for quota checks.
- Consider providing bash or shell script examples for Linux users, if relevant.
- Add a note at the top of the examples section indicating which commands are cross-platform and which are Windows-specific.
Low Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation provides both Azure CLI and PowerShell examples for checking vCPU quotas, but PowerShell (a Windows-centric tool) is given equal prominence and a dedicated tab. The CLI example is shown first, which is positive for Linux parity, but the presence of PowerShell examples may suggest a slight Windows bias, especially since no Linux-specific shell (e.g., Bash) or macOS-specific notes are included.
Recommendations
- Clarify that Azure CLI commands work on Linux, macOS, and Windows equally.
- Add a note for Linux/macOS users confirming that Azure CLI is the recommended cross-platform tool.
- Consider mentioning Bash scripting or providing example output from a Linux terminal to reinforce parity.
- If possible, include a brief section on installing Azure CLI on Linux/macOS.
Virtual Machines
Enable Trusted launch on existing Gen2 VMs
...rticles/virtual-machines/trusted-launch-existing-vm.md
Low Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation provides parity for both Linux and Windows VMs when enabling Trusted launch, with clear statements that the feature applies to both. However, there is mild Windows bias in the ordering and tooling: PowerShell examples are provided and referenced before Linux alternatives, and PowerShell is used for ARM template deployment and VM deallocation, even though Linux users would likely prefer Bash or Azure CLI. The verification step mentions RDP (Windows) before SSH (Linux) throughout. There are no missing Linux examples, and the CLI instructions are cross-platform.
Recommendations
- Provide Bash shell examples for ARM template deployment and VM deallocation alongside PowerShell, or clarify that PowerShell commands can be run on Linux/macOS using PowerShell Core.
- Alternate the order of RDP/SSH mentions, or mention SSH first in Linux-specific contexts.
- Explicitly state that all CLI and template steps are cross-platform and can be performed from Linux/macOS.
- For template deployment, offer Azure CLI examples in addition to PowerShell.
Virtual Machines
Create a Gallery for Sharing Resources
.../blob/main/articles/virtual-machines/create-gallery.md
Low Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation provides examples for creating an Azure Compute Gallery using the Portal, Azure CLI, PowerShell, and REST API. While the CLI and REST examples are cross-platform, PowerShell examples are included and shown in parity with CLI, but there is a subtle Windows bias: PowerShell is a Windows-centric tool and is presented alongside CLI, and in the first major section ('Create a private gallery'), the PowerShell example is shown before REST. Additionally, the ordering of examples is Portal > CLI > PowerShell > REST, which places Windows tools before REST, and PowerShell is not available natively on Linux/macOS (though PowerShell Core exists, it's less common for Azure tasks). No Linux-specific tools (e.g., Bash scripts) or explicit Linux/macOS guidance is provided.
Recommendations
- Clarify that Azure CLI commands work on Windows, Linux, and macOS.
- Consider mentioning PowerShell Core compatibility for non-Windows users if PowerShell is shown.
- Ensure example ordering does not imply preference for Windows tools (e.g., CLI before PowerShell).
- Optionally, add a note that Bash or shell scripting can be used with Azure CLI on Linux/macOS.
- Explicitly state platform compatibility for each method.
Low Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation provides both Azure CLI and PowerShell examples for checking vCPU quotas, but the PowerShell example is given equal prominence, and the CLI example is not explicitly labeled as Linux/macOS-friendly. The tab order presents CLI first, but the PowerShell section is detailed and assumes familiarity with Windows tooling. There is no explicit mention of Linux-specific tools or shell environments, nor are there notes clarifying cross-platform compatibility for the CLI commands.
Recommendations
- Explicitly state that Azure CLI commands work on Linux, macOS, and Windows, and are the recommended cross-platform approach.
- Add a note clarifying that PowerShell examples are primarily for Windows users, while Azure CLI is suitable for Linux/macOS.
- Consider providing bash or shell script examples for Linux users, or at least mention that the CLI commands can be run in bash/zsh.
- If possible, reorder tabs or add a 'Recommended for Linux/macOS' label to the CLI section.
Virtual Machines
Enable Trusted launch on existing Gen2 VMs
...rticles/virtual-machines/trusted-launch-existing-vm.md
Low Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation provides parity for both Linux and Windows VMs, explicitly stating applicability to both. However, there is a mild Windows bias in the ordering of connection instructions (RDP for Windows is mentioned before SSH for Linux), and PowerShell is used for ARM template deployment and VM deallocation/start examples, which may be less familiar or accessible to Linux/macOS users. The CLI examples are cross-platform, but PowerShell is referenced in several places without alternative Bash or shell scripting examples.
Recommendations
- When showing connection instructions, alternate the order or explicitly show Linux-first examples in some sections (e.g., 'Verify that you can sign in to the VM by using SSH (for Linux VMs) or RDP (for Windows VMs)').
- For ARM template deployment and VM management, provide equivalent Bash/Azure CLI scripts for Linux/macOS users alongside PowerShell examples.
- Where PowerShell is used for deallocation/start, add Bash/Azure CLI alternatives, especially in the 'Template' tab.
- Clarify that PowerShell examples are for users on Windows, and link to cross-platform CLI alternatives where possible.