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
Summary:
The documentation page demonstrates a bias towards Windows and PowerShell in the sections related to customer-managed keys and disk encryption set configuration. Several steps use PowerShell scripting and Windows-specific tools (e.g., Microsoft Graph PowerShell SDK) without providing equivalent Bash or Linux-native alternatives, despite the overall focus on Azure CLI and the fact that confidential VMs are often Linux-based. Some commands mix Azure CLI and PowerShell, which may confuse Linux users or those working in Bash environments. The attestation section is Linux-focused, but earlier critical steps lack Linux parity.
Recommendations:
- Provide Bash/Linux shell equivalents for all PowerShell-based steps, especially for Azure AD and Microsoft Graph operations.
- Avoid using PowerShell-specific constructs (e.g., Out-String, ConvertFrom-Json, $variable assignment) in CLI-focused documentation unless a Linux/Bash alternative is also shown.
- Clearly indicate when a step is Windows-only or provide both Windows (PowerShell) and Linux (Bash) instructions side-by-side.
- For steps requiring Microsoft Graph, link to or provide instructions for using the Microsoft Graph CLI or REST API from Bash.
- Ensure that all scripting examples are runnable in Azure Cloud Shell (Bash) or on a typical Linux system, or provide explicit guidance for Linux users.
Create pull request