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_tools
⚠️ missing_linux_example
⚠️ windows_first
Summary:
The documentation is heavily biased toward Windows environments. All instructions, examples, and tool usage are based on PowerShell, with explicit references to Windows-only features (e.g., PowerShell 5.1, Windows Update/WSUS, Windows file paths). There are no examples or guidance for running the tool on Linux or macOS, nor any mention of cross-platform compatibility or alternatives. The documentation assumes the user is on Windows from the outset and does not address Linux users at all.
Recommendations:
  • Clarify whether the Azure Stack Network Readiness Checker can be run on Linux or macOS (e.g., via PowerShell Core/7.x). If not, state this limitation explicitly at the top of the documentation.
  • If the tool supports PowerShell Core (which is cross-platform), provide installation and usage instructions for Linux and macOS, including how to install PowerShell and the module on those platforms.
  • Include Linux/macOS-specific examples for installing PowerShell, installing the module, and running the tool, including sample command lines and expected output.
  • If the tool is Windows-only, suggest alternative network readiness checks for Linux users, or provide a roadmap for cross-platform support.
  • Avoid using Windows-specific file paths in examples and outputs, or provide equivalent paths for other operating systems where applicable.
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 ❌ Biased
2025-07-09 13:09 #3 cancelled ✅ Clean
2025-07-08 04:23 #2 cancelled ❌ Biased

Flagged Code Snippets

Untrusted repository You are installing the modules from an untrusted repository. If you trust this repository, change its InstallationPolicy value by running the Set-PSRepository cmdlet. Are you sure you want to install the modules from 'PSGallery'? [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "N"):
PS C:\Users\Administrator> Invoke-AzsNetworkValidation -DnsServer '10.50.10.50', '10.50.50.50' -DeviceFqdn 'aseclient.contoso.com' -TimeServer 'pool.ntp.org' -Proxy 'http://proxy.contoso.com:3128/' -SkipTests DuplicateIP -WindowsUpdateServer 'http://ase-prod.contoso.com' -OutputPath C:\ase-network-tests Invoke-AzsNetworkValidation v1.2100.1396.426 started. The following tests will be executed: LinkLayer, IPConfig, DnsServer, PathMtu, TimeServer, AzureEndpoint, WindowsUpdateServer, DnsRegistration, Proxy Validating input parameters Validating Azure Stack Edge Network Readiness Link Layer: OK IP Configuration: OK Using network adapter name 'vEthernet (corp-1g-Static)', description 'Hyper-V Virtual Ethernet Adapter' DNS Server 10.50.10.50: OK DNS Server 10.50.50.50: OK Network Path MTU: OK Time Server pool.ntp.org: OK Proxy Server 10.57.48.80: OK Azure ARM Endpoint: OK Azure Graph Endpoint: OK Azure Login Endpoint: OK Azure ManagementService Endpoint: OK Azure AseService Endpoint: OK Azure AseServiceBus Endpoint: OK Azure AseStorageAccount Endpoint: OK Windows Update Server ase-prod.contoso.com port 80: OK DNS Registration for aseclient.contoso.com: OK DNS Registration for login.aseclient.contoso.com: OK DNS Registration for management.aseclient.contoso.com: OK DNS Registration for *.blob.aseclient.contoso.com: OK DNS Registration for compute.aseclient.contoso.com: OK Log location (contains PII): C:\ase-network-tests\AzsReadinessChecker.log Report location (contains PII): C:\ase-network-tests\AzsReadinessCheckerReport.json Invoke-AzsNetworkValidation Completed
PS C:\Users\Administrator> Invoke-AzsNetworkValidation -DnsServer '10.50.10.50' -TimeServer 'time.windows.com' -DeviceFqdn aseclient.contoso.com -ComputeIPs 10.10.52.1-10.10.52.20 -CustomUrl 'http://www.nytimes.com','http://fakename.fakeurl.com' Invoke-AzsNetworkValidation v1.2100.1396.426 started. Validating input parameters The following tests will be executed: LinkLayer, IPConfig, DnsServer, PathMtu, TimeServer, AzureEndpoint, WindowsUpdateServer, DuplicateIP, DnsRegistration, CustomUrl Validating Azure Stack Edge Network Readiness Link Layer: OK IP Configuration: OK DNS Server 10.50.10.50: OK Network Path MTU: OK Time Server time.windows.com: OK Azure ARM Endpoint: OK Azure Graph Endpoint: OK Azure Login Endpoint: OK Azure ManagementService Endpoint: OK Azure AseService Endpoint: OK Azure AseServiceBus Endpoint: OK Azure AseStorageAccount Endpoint: OK URL http://www.nytimes.com/: OK URL http://fakename.fakeurl.com/: Fail Windows Update Server windowsupdate.microsoft.com port 80: OK Windows Update Server update.microsoft.com port 80: OK Windows Update Server update.microsoft.com port 443: OK Windows Update Server download.windowsupdate.com port 80: OK Windows Update Server download.microsoft.com port 443: OK Windows Update Server go.microsoft.com port 80: OK Duplicate IP: Warning DNS Registration for aseclient.contoso.com: OK DNS Registration for login.aseclient.contoso.com: Fail DNS Registration for management.aseclient.contoso.com: Fail DNS Registration for *.blob.aseclient.contoso.com: Fail DNS Registration for compute.aseclient.contoso.com: Fail Details: [-] URL http://fakename.fakeurl.com/: fakename.fakeurl.com : DNS name does not exist [-] Duplicate IP: Some IP addresses allocated to Azure Stack may be active on the network. Check the output log for the detailed list. [-] DNS Registration for login.aseclient.contoso.com: login.aseclient.contoso.com : DNS name does not exist [-] DNS Registration for management.aseclient.contoso.com: management.aseclient.contoso.com : DNS name does not exist [-] DNS Registration for *.blob.aseclient.contoso.com: testname.aseclient.contoso.com : DNS name does not exist [-] DNS Registration for compute.aseclient.contoso.com: compute.aseclient.contoso.com : DNS name does not exist Additional help URL http://aka.ms/azsnrc Log location (contains PII): C:\Users\[*redacted*]\AppData\Local\Temp\AzsReadinessChecker\AzsReadinessChecker.log Report location (contains PII): C:\Users\[*redacted*]\AppData\Local\Temp\AzsReadinessChecker\AzsReadinessCheckerReport.json Invoke-AzsNetworkValidation Completed
Invoke-AzsNetworkValidation -DnsServer <string[]> -DeviceFqdn <string> [-TimeServer <string[]>] ` [-Proxy <uri>] [-ProxyCredential <pscredential>] [-WindowsUpdateServer <uri[]>] [-CustomUrl <url[]>] ` [-AzureEnvironment {AzureCloud | AzureChinaCloud | AzureGermanCloud | AzureUSGovernment | CustomCloud}] ` [-SkipTests {LinkLayer | IPConfig | DnsServer | TimeServer | PathMtu | DuplicateIP | AzureEndpoint | WindowsUpdateServer | DnsRegistration}] ` [-OutputPath <string>]
Invoke-AzsNetworkValidation -DnsServer '10.50.10.50', '10.50.50.50' -DeviceFqdn 'aseclient.contoso.com' -TimeServer 'pool.ntp.org' -Proxy 'http://proxy.contoso.com:3128/' -SkipTests DuplicateIP -WindowsUpdateServer 'http://ase-prod.contoso.com' -OutputPath `C:\ase-network-tests`
Invoke-AzsNetworkValidation -DnsServer '10.50.10.50' -TimeServer 'time.windows.com' -DeviceFqdn aseclient.contoso.com -ComputeIPs 10.10.52.1-10.10.52.20 -CustomUrl 'http://www.nytimes.com','http://fakename.fakeurl.com'