❌
This page contains Windows bias

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_first
⚠️ missing_linux_example
⚠️ windows_tools
Summary:
The documentation is heavily biased toward Windows environments. All instructions, examples, and screenshots assume the use of Windows clients, Windows PowerShell (specifically version 5.1), and Windows-specific tools (e.g., Notepad, hosts file at C:\Windows\System32\Drivers\etc). There are no examples or guidance for Linux or macOS users, despite PowerShell Core being cross-platform. Steps for certificate management, environment setup, and connectivity verification are all Windows-centric, and there is no mention of equivalent Linux commands, file paths, or tools.
Recommendations:
  • Add parallel instructions and examples for Linux (and optionally macOS) clients, including PowerShell Core usage.
  • Provide Linux-specific commands for editing the hosts file (e.g., using nano or vi to edit /etc/hosts) and verifying DNS resolution (e.g., using ping, dig, or host).
  • Include guidance on importing certificates into Linux certificate stores (e.g., update-ca-certificates, certutil, or relevant distro-specific tools).
  • Clarify which steps are Windows-only and which are cross-platform, and provide clear alternatives where possible.
  • Update screenshots and file paths to include Linux equivalents.
  • Explicitly state PowerShell Core support and provide installation/usage instructions for non-Windows platforms.
GitHub Create pull request

Scan History

Date Scan ID Status Bias Status
2025-08-17 00:01 #83 in_progress âś… Clean
2025-07-13 21:37 #48 completed âś… Clean
2025-07-09 13:09 #3 cancelled âś… Clean
2025-07-08 04:23 #2 cancelled ❌ Biased

Flagged Code Snippets

Add-AzEnvironment -Name <Environment Name> -ARMEndpoint "https://management.<appliance name>.<DNSDomain>/"
$PSVersionTable.PSVersion
# Install the Az.BootStrapper module. Select Yes when prompted to install NuGet. Install-Module -Name Az.BootStrapper # Install and import the API Version Profile into the current PowerShell session. Use-AzProfile -Profile 2020-09-01-hybrid -Force # Confirm the installation of PowerShell Get-Module -Name "Az*" -ListAvailable
Add-AzureRmEnvironment -Name <Environment Name> -ARMEndpoint "https://management.<appliance name>.<DNSDomain>/"
PS C:\WINDOWS\system32> Get-AzEnvironment​ Name Resource Manager Url ActiveDirectory Authority​ ---- -------------------- -------------------------​ AzureChinaCloud https://management.chinacloudapi.cn/ https://login.chinacloudapi.cn/​ AzureCloud https://management.azure.com/ https://login.microsoftonline.com/​ AzureGermanCloud https://management.microsoftazure.de/ https://login.microsoftonline.de/​ AzDBE1 https://management.HVTG1T2-Test.microsoftdatabox.com https://login.hvtg1t2-test.microsoftdatabox.com/adfs/​ AzureUSGovernment https://management.usgovcloudapi.net/ https://login.microsoftonline.us/​ AzDBE2 https://management.CVV4PX2-Test.microsoftdatabox.com https://login.cvv4px2-test.microsoftdatabox.com/adfs/​
PS C:\WINDOWS\system32> Disconnect-AzAccount​ ​​ Id : EdgeArmUser@localhost​ Type : User​ Tenants : {aaaabbbb-0000-cccc-1111-dddd2222eeee}​ AccessToken :​ Credential :​ TenantMap : {}​ CertificateThumbprint :​ ExtendedProperties : {[Subscriptions, ...], [Tenants, aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e]}
PS C:\WINDOWS\system32> Get-AzureRmContext |fl *​ ​​ Name : Default Provider Subscription (A4257FDE-B946-4E01-ADE7-674760B8D1A3) - EdgeArmUser@localhost​ Account : EdgeArmUser@localhost​ Environment : AzDBE2​ Subscription : ...​ Tenant : aaaabbbb-0000-cccc-1111-dddd2222eeee​ TokenCache : Microsoft.Azure.Commands.Common.Authentication.ProtectedFileTokenCache​ VersionProfile :​ ExtendedProperties : {}​
PS C:\WINDOWS\system32> Login-AzureRmAccount -Environment "AzDBE1" -TenantId $ArmTenantId​ ​ Account SubscriptionName TenantId Environment​ ------- ---------------- -------- -----------​ EdgeArmUser@localhost Default Provider Subscription aaaabbbb-0000-cccc-1111-dddd2222eeee AzDBE1
$PSVersionTable.PSVersion
Windows PowerShell Copyright (C) Microsoft Corporation. All rights reserved. Try the new cross-platform PowerShell https://aka.ms/pscore6 PS C:\windows\system32> $PSVersionTable.PSVersion Major Minor Build Revision ----- ----- ----- -------- 5 1 19041 906
Install-Module PowerShellGet -MinimumVersion 2.2.3 Import-Module -Name PackageManagement -ErrorAction Stop Get-PSRepository -Name "PSGallery"
PS C:\windows\system32> Install-Module PowerShellGet -MinimumVersion 2.2.3 PS C:\windows\system32> Import-Module -Name PackageManagement -ErrorAction Stop PS C:\windows\system32> Get-PSRepository -Name "PSGallery" Name InstallationPolicy SourceLocation ---- ------------------ -------------- PSGallery Trusted https://www.powershellgallery.com/api/v2
Windows PowerShell Copyright (C) Microsoft Corporation. All rights reserved. Try the new cross-platform PowerShell https://aka.ms/pscore6 PS C:\windows\system32> $PSVersionTable.PSVersion Major Minor Build Revision ----- ----- ----- -------- 5 1 18362 145
Import-Module -Name PowerShellGet -ErrorAction Stop Import-Module -Name PackageManagement -ErrorAction Stop Get-PSRepository -Name "PSGallery"
PS C:\windows\system32> Import-Module -Name PowerShellGet -ErrorAction Stop PS C:\windows\system32> Import-Module -Name PackageManagement -ErrorAction Stop PS C:\windows\system32> Get-PSRepository -Name "PSGallery" Name InstallationPolicy SourceLocation ---- ------------------ -------------- PSGallery Trusted https://www.powershellgallery.com/api/v2
# Check existing versions of AzureRM modules Get-InstalledModule -Name AzureRM -AllVersions # Check existing versions of Az modules Get-InstalledModule -Name Az -AllVersions
#Install the Az module version 1.10.0 Install-Module -Name Az -RequiredVersion 1.10.0
PS C:\windows\system32> Install-Module -Name Az.BootStrapper PS C:\windows\system32> Use-AzProfile -Profile 2020-09-01-hybrid -Force Loading Profile 2020-09-01-hybrid PS C:\windows\system32> Get-Module -Name "Az*" -ListAvailable
PS C:\WINDOWS\system32> Get-InstalledModule -Name Az -AllVersions Version Name Repository Description ------- ---- ---------- ----------- 1.10.0 Az PSGallery Mic... PS C:\WINDOWS\system32>
Set-AzureRMEnvironment -Name <Environment Name>
# Install the AzureRM.BootStrapper module. Select Yes when prompted to install NuGet. Install-Module -Name AzureRM.BootStrapper # Install and import the API Version Profile into the current PowerShell session. Use-AzureRmProfile -Profile 2019-03-01-hybrid -Force # Confirm the installation of PowerShell Get-Module -Name "Azure*" -ListAvailable
PS C:\windows\system32> Install-Module -Name AzureRM.BootStrapper PS C:\windows\system32> Use-AzureRmProfile -Profile 2019-03-01-hybrid -Force Loading Profile 2019-03-01-hybrid PS C:\windows\system32> Get-Module -Name "Azure*" -ListAvailable Directory: C:\Program Files\WindowsPowerShell\Modules ModuleType Version Name ExportedCommands ---------- ------- ---- ---------------- Script 4.5.0 Azure.Storage {Get-AzureStorageTable, New-AzureStorageTableSASToken, New... Script 2.5.0 AzureRM Script 0.5.0 AzureRM.BootStrapper {Update-AzureRmProfile, Uninstall-AzureRmProfile, Install-... Script 4.6.1 AzureRM.Compute {Remove-AzureRmAvailabilitySet, Get-AzureRmAvailabilitySet... Script 3.5.1 AzureRM.Dns {Get-AzureRmDnsRecordSet, New-AzureRmDnsRecordConfig, Remo... Script 5.1.5 AzureRM.Insights {Get-AzureRmMetricDefinition, Get-AzureRmMetric, Remove-Az... Script 4.2.0 AzureRM.KeyVault {Add-AzureKeyVaultCertificate, Set-AzureKeyVaultCertificat... Script 5.0.1 AzureRM.Network {Add-AzureRmApplicationGatewayAuthenticationCertificate, G... Script 5.8.3 AzureRM.profile {Disable-AzureRmDataCollection, Disable-AzureRmContextAuto... Script 6.4.3 AzureRM.Resources {Get-AzureRmProviderOperation, Remove-AzureRmRoleAssignmen... Script 5.0.4 AzureRM.Storage {Get-AzureRmStorageAccount, Get-AzureRmStorageAccountKey, ... Script 4.0.2 AzureRM.Tags {Remove-AzureRmTag, Get-AzureRmTag, New-AzureRmTag} Script 4.0.3 AzureRM.UsageAggregates Get-UsageAggregates Script 5.0.1 AzureRM.Websites {Get-AzureRmAppServicePlan, Set-AzureRmAppServicePlan, New... Directory: C:\Program Files (x86)\Microsoft Azure Information Protection\Powershell ModuleType Version Name ExportedCommands ---------- ------- ---- ---------------- Binary 1.48.204.0 AzureInformationProtection {Clear-RMSAuthentication, Get-RMSFileStatus, Get-RMSServer...
PS C:\WINDOWS\system32> Add-AzEnvironment -Name AzASE -ARMEndpoint "https://management.myasegpu.wdshcsso.com/" Name Resource Manager Url ActiveDirectory Authority ---- -------------------- ------------------------- AzASE https://management.myasegpu.wdshcsso.com/ https://login.myasegpu.wdshcsso.c...
Set-AzEnvironment -Name <Environment Name>
PS C:\WINDOWS\system32> Set-AzEnvironment -Name AzASE Name Resource Manager Url ActiveDirectory Authority ---- -------------------- ------------------------- AzASE https://management.myasegpu.wdshcsso.com/ https://login.myasegpu.wdshcsso.c...
$pass = ConvertTo-SecureString "<Your password>" -AsPlainText -Force; $cred = New-Object System.Management.Automation.PSCredential("EdgeArmUser", $pass) Connect-AzAccount -EnvironmentName AzASE -TenantId aaaabbbb-0000-cccc-1111-dddd2222eeee -credential $cred
PS C:\windows\system32> $pass = ConvertTo-SecureString "<Your password>" -AsPlainText -Force; PS C:\windows\system32> $cred = New-Object System.Management.Automation.PSCredential("EdgeArmUser", $pass) PS C:\windows\system32> Connect-AzAccount -EnvironmentName AzASE -TenantId aaaabbbb-0000-cccc-1111-dddd2222eeee -credential $cred Account SubscriptionName TenantId Environment ------- ---------------- -------- ----------- EdgeArmUser@localhost Default Provider Subscription aaaabbbb-0000-cccc-1111-dddd2222eeee AzASE PS C:\windows\system32>
PS C:\WINDOWS\system32> login-AzAccount -EnvironmentName AzASE -TenantId aaaabbbb-0000-cccc-1111-dddd2222eeee Account SubscriptionName TenantId ------- ---------------- -------- EdgeArmUser@localhost Default Provider Subscription c0257de7-538f-415c-993a-1b87a... PS C:\WINDOWS\system32>
PS C:\WINDOWS\system32> Get-AzResource Name : aseimagestorageaccount ResourceGroupName : ase-image-resourcegroup ResourceType : Microsoft.Storage/storageaccounts Location : dbelocal ResourceId : /subscriptions/.../resourceGroups/ase-image-resourcegroup/providers/Microsoft.Storage/storageac counts/aseimagestorageaccount Tags : Name : myaselinuxvmimage1 ResourceGroupName : ASERG ResourceType : Microsoft.Compute/images Location : dbelocal ResourceId : /subscriptions/.../resourceGroups/ASERG/providers/Microsoft.Compute/images/myaselinuxvmimage1 Tags : Name : ASEVNET ResourceGroupName : ASERG ResourceType : Microsoft.Network/virtualNetworks Location : dbelocal ResourceId : /subscriptions/.../resourceGroups/ASERG/providers/Microsoft.Network/virtualNetworks/ASEVNET Tags : PS C:\WINDOWS\system32>
PS C:\windows\system32> Add-AzureRmEnvironment -Name AzDBE -ARMEndpoint https://management.dbe-n6hugc2ra.microsoftdatabox.com/ Name Resource Manager Url ActiveDirectory Authority ---- -------------------- ------------------------- AzDBE https://management.dbe-n6hugc2ra.microsoftdatabox.com https://login.dbe-n6hugc2ra.microsoftdatabox.com/adfs/
PS C:\windows\system32> $pass = ConvertTo-SecureString "<Your password>" -AsPlainText -Force; PS C:\windows\system32> $cred = New-Object System.Management.Automation.PSCredential("EdgeArmUser", $pass) PS C:\windows\system32> Connect-AzureRmAccount -EnvironmentName AzDBE -TenantId aaaabbbb-0000-cccc-1111-dddd2222eeee -credential $cred Account SubscriptionName TenantId Environment ------- ---------------- -------- ----------- EdgeArmUser@localhost Default Provider Subscription aaaabbbb-0000-cccc-1111-dddd2222eeee AzDBE PS C:\windows\system32>
PS C:\Users\Administrator> login-AzureRMAccount -EnvironmentName AzDBE -TenantId aaaabbbb-0000-cccc-1111-dddd2222eeee Account SubscriptionName TenantId Environment ------- ---------------- -------- ------- EdgeArmUser@localhost Default Provider Subscription aaaabbbb-0000-cccc-1111-dddd2222eeee AzDBE PS C:\Users\Administrator>
PS C:\WINDOWS\system32> Get-AzContext |fl *​ ​​ Name : Default Provider Subscription (...) - EdgeArmUser@localhost​ Account : EdgeArmUser@localhost​ Environment : AzDBE2​ Subscription : ...​ Tenant : aaaabbbb-0000-cccc-1111-dddd2222eeee​ TokenCache : Microsoft.Azure.Commands.Common.Authentication.ProtectedFileTokenCache​ VersionProfile :​ ExtendedProperties : {}​
PS C:\WINDOWS\system32> Login-AzAccount -Environment "AzDBE1" -TenantId $ArmTenantId​ ​ Account SubscriptionName TenantId Environment​ ------- ---------------- -------- -----------​ EdgeArmUser@localhost Default Provider Subscription aaaabbbb-0000-cccc-1111-dddd2222eeee AzDBE1
PS C:\WINDOWS\system32> Get-AzContext |fl *​ ​​ Name : Default Provider Subscription (...) - EdgeArmUser@localhost​ Account : EdgeArmUser@localhost​ Environment : AzDBE1​ Subscription : ... Tenant : aaaabbbb-0000-cccc-1111-dddd2222eeee​ TokenCache : Microsoft.Azure.Commands.Common.Authentication.ProtectedFileTokenCache​ VersionProfile :​ ExtendedProperties : {}
PS C:\WINDOWS\system32> Get-AzureRmEnvironment​ Name Resource Manager Url ActiveDirectory Authority​ ---- -------------------- -------------------------​ AzureChinaCloud https://management.chinacloudapi.cn/ https://login.chinacloudapi.cn/​ AzureCloud https://management.azure.com/ https://login.microsoftonline.com/​ AzureGermanCloud https://management.microsoftazure.de/ https://login.microsoftonline.de/​ AzDBE1 https://management.HVTG1T2-Test.microsoftdatabox.com https://login.hvtg1t2-test.microsoftdatabox.com/adfs/​ AzureUSGovernment https://management.usgovcloudapi.net/ https://login.microsoftonline.us/​ AzDBE2 https://management.CVV4PX2-Test.microsoftdatabox.com https://login.cvv4px2-test.microsoftdatabox.com/adfs/​
PS C:\WINDOWS\system32> Disconnect-AzureRmAccount​ ​​ Id : EdgeArmUser@localhost​ Type : User​ Tenants : {aaaabbbb-0000-cccc-1111-dddd2222eeee}​ AccessToken :​ Credential :​ TenantMap : {}​ CertificateThumbprint :​ ExtendedProperties : {[Subscriptions, ...], [Tenants, aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e]}
PS C:\WINDOWS\system32> Get-AzureRmContext |fl *​ ​​ Name : Default Provider Subscription (...) - EdgeArmUser@localhost​ Account : EdgeArmUser@localhost​ Environment : AzDBE1​ Subscription : ...​ Tenant : aaaabbbb-0000-cccc-1111-dddd2222eeee​ TokenCache : Microsoft.Azure.Commands.Common.Authentication.ProtectedFileTokenCache​ VersionProfile :​ ExtendedProperties : {}