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:
⚠️
windows_first
⚠️
powershell_heavy
⚠️
windows_tools
Summary:
The documentation provides parallel instructions for both Windows and Linux, but consistently presents Windows instructions before Linux in every section. Windows examples use PowerShell scripts and commands extensively, including Windows-specific tools like vcpkg and PowerShell cmdlets (e.g., Set-ExecutionPolicy, Write-Host, Get-Pfxcertificate), while Linux instructions use bash scripts. Some Windows-specific installation guidance (such as vcpkg for OpenSSL) is more detailed than the Linux equivalent. There are no major missing Linux examples, but the ordering and tool emphasis reflect a Windows-first and PowerShell-heavy bias.
Recommendations:
- Alternate the order of Windows and Linux sections in each major heading, or present Linux first in some sections to balance perceived priority.
- Where possible, provide equal detail for Linux installation steps (e.g., recommend package managers like apt, yum, or dnf for OpenSSL installation).
- Avoid using Windows-specific tools (like vcpkg) as the 'recommended' method without offering a Linux equivalent or a cross-platform alternative.
- Where PowerShell cmdlets are used for certificate inspection (e.g., Get-Pfxcertificate), provide equivalent Linux commands (e.g., openssl) and highlight them equally.
- Consider a unified table or tabbed interface that does not always default to Windows as the first or primary example.
Create pull request
Flagged Code Snippets
mkdir wrkdir
cd .\wrkdir\
cp ..\iotedge\tools\CACertificates\*.cnf .
cp ..\iotedge\tools\CACertificates\ca-certs.ps1 .
.\vcpkg install openssl:x64-windows
Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Scope CurrentUser
Test-CACertsPrerequisites
New-CACertsEdgeDeviceIdentity "<device-id>"
New-CACertsEdgeDevice "<CA cert name>"
New-CACertsDevice "<device ID>-primary"
New-CACertsDevice "<device ID>-secondary"
Write-Host (Get-Pfxcertificate -FilePath certs\iot-device-<device name>-primary.cert.pem).Thumbprint
New-CACertsVerificationCert "<verification code>"
New-CACertsDevice "<device id>"