❌
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 and PowerShell usage. All examples, instructions, and screenshots are specific to Windows clients, with explicit requirements for Windows PowerShell 5.1. There are no Linux or macOS instructions, nor are there any examples using cross-platform PowerShell Core or CLI tools. Windows-specific tools (Notepad, hosts file at C:\Windows\System32\Drivers\etc, ping.exe) are referenced exclusively, and Linux equivalents are not mentioned.
Recommendations:
  • Add instructions and examples for connecting from Linux and macOS clients, including certificate management, hosts file editing, and endpoint verification.
  • Include PowerShell Core (pwsh) examples, which are cross-platform, and clarify any limitations or differences compared to Windows PowerShell 5.1.
  • Provide equivalent commands for Linux/macOS, such as using nano/vim for editing /etc/hosts, and using ping or dig for endpoint resolution.
  • Document certificate import/export steps for Linux/macOS (e.g., using openssl, update-ca-certificates, or Keychain Access on macOS).
  • Clarify whether Azure CLI (az) can be used for any of the steps, and provide CLI examples if possible.
  • Explicitly state any platform limitations (e.g., if only Windows is supported, explain why and if Linux support is planned).
GitHub Create pull request

Scan History

Date Scan ID Status Bias Status
2025-07-12 23:44 #41 in_progress ❌ Biased
2025-07-12 00:58 #8 cancelled âś… Clean
2025-07-10 05:06 #7 processing âś… Clean

Flagged Code Snippets

$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"
Add-AzEnvironment -Name <Environment Name> -ARMEndpoint "https://management.<appliance name>.<DNSDomain>/"
$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> 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 : {}
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...
$PSVersionTable.PSVersion
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> 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>
Set-AzureRMEnvironment -Name <Environment Name>
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> 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> 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.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
#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>
# 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> $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> 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:\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> 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> 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> 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> 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