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.
Create pull request
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'