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 PowerShell cmdlets (New-AzDataFactoryV2LinkedServiceEncryptedCredential, Set-AzDataFactoryV2LinkedService), which are primarily Windows-centric and require PowerShell 7.0 or higher. There are no examples or instructions for performing the same tasks on Linux or macOS, nor are cross-platform alternatives (such as Azure CLI, REST API, or Bash scripts) mentioned. The use of DPAPI for encryption is also a Windows-specific technology.
Recommendations:
- Provide equivalent examples using Azure CLI or REST API, which are cross-platform and can be run on Linux and macOS.
- Clarify whether the encryption process and cmdlets are supported on non-Windows platforms, especially since PowerShell 7 is cross-platform but DPAPI is not.
- If the process is inherently Windows-only (due to DPAPI or integration runtime limitations), explicitly state this limitation early in the documentation.
- Offer guidance or workarounds for Linux users, such as running the commands in a Windows container or VM, or alternative credential management approaches.
- Reorder or supplement examples so that Linux/macOS approaches are presented alongside or before Windows-specific instructions where possible.
Create pull request