Document Details

Azure Stack Edge Deploy Check Network Readiness
Home / Scan 41 / Azure Stack Edge Deploy Check Network Readiness
❌
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.
GitHub View on GitHub 📚 View on Microsoft Learn

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 tooling are based on PowerShell, which is native to Windows. There is no mention of Linux or cross-platform support, and all file paths, prerequisites, and sample outputs are Windows-specific. No Linux installation or usage instructions are provided, nor are there any Bash or cross-platform command examples.
Recommendations:
  • Clarify whether the Azure Stack Network Readiness Checker can run on PowerShell Core (pwsh) on Linux/macOS. If so, provide explicit instructions for installing and running the tool on those platforms.
  • Add Linux/macOS installation steps, including prerequisites (such as installing PowerShell Core and any required dependencies).
  • Provide example commands and sample outputs for Linux/macOS environments, including file paths and environment-specific notes.
  • If the tool is Windows-only, state this clearly at the top of the documentation and suggest alternative approaches for Linux users, if available.
  • Avoid using only Windows file paths (e.g., C:\Users\...) in documentation; provide cross-platform equivalents or note the differences.
  • Mention and link to PowerShell installation guides for Linux/macOS, not just Windows.
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

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'
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"):
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`
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