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.
Create pull request
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 : {}