AzStackHci.DiagnosticSettings

0.6.4

Microsoft Azure Local - Diagnostics settings and connectivity tests support module

Minimum PowerShell version

5.1

Installation Options

Copy and Paste the following command to install this package using PowerShellGet More Info

Install-Module -Name AzStackHci.DiagnosticSettings -RequiredVersion 0.6.4

Copy and Paste the following command to install this package using Microsoft.PowerShell.PSResourceGet More Info

Install-PSResource -Name AzStackHci.DiagnosticSettings -Version 0.6.4

You can deploy this package directly to Azure Automation. Note that deploying packages with dependencies will deploy all the dependencies to Azure Automation. Learn More

Manually download the .nupkg file to your system's default download location. Note that the file won't be unpacked, and won't include any dependencies. Learn More

Owners

Copyright

(c) 2026 Microsoft Corporation. All rights reserved.

Package Details

Author(s)

  • Microsoft Corporation

Tags

Microsoft AzStackHci Diagnostic Settings Connectivity AzureLocal

Functions

Get-AzStackHciMemoryDumpSettings Set-AzStackHciMemoryDumpSettings Restore-AzStackHciMemoryDumpSettings Get-AzStackHciPageFileSettings Restore-AzStackHciPageFileSettings Set-AzStackHciPageFileSettings Set-AzStackHciPageFileSettingsMinimal Get-AzStackHciUserModeCrashDumpSettings Set-AzStackHciUserModeCrashDumpSettings Restore-AzStackHciUserModeCrashDumpSettings Test-AzStackHciSSLInspection Send-ClusterPerformanceHistory Test-AzureLocalConnectivity Test-Layer7Connectivity Test-TCPConnectivity Get-AzStackHciOsConfigSettings Test-ArcMachinePrivateLinkScopeEnabled

PSEditions

Desktop Core

Dependencies

This module has no dependencies.

Release Notes

## v0.6.4

### Bug Fixes
- Test-NTPConnectivity: fixed NullArray exception extracting NTP server IP from w32tm.exe output. `-match` on a string array filters elements but does NOT populate `$Matches`, so `$Matches[1]` threw at runtime. Fix joins the array into a single string before matching: `($ntpResult -join "`n") -match '\[([^\]]+)\]'`.
- Update-ModuleVersion: fixed false "Update may be incomplete" warning during auto-update. `Get-Module -Name <module>` can return multiple entries when nested modules are loaded, making `.Version` an `Object[]` that never equals the target `[version]`. Now selects the highest version entry.

### Tests
- Added regression tests documenting `-match`/`$Matches` array vs string behaviour and verifying Test-NTPConnectivity IP extraction against realistic multi-line w32tm.exe output.

## v0.6.3

### Set-AzStackHciPageFileSettingsMinimal (renamed)
- Renamed from Set-AzStackHciPageFileMinimumSettings for consistency with other function names

### Set-AzStackHciMemoryDumpSettings — KernelDump Parameter Sets
- Replaced AzureLocal parameter set with KernelDump and KernelDumpDedicated sets
- Added -KernelDump mandatory switch for CrashDumpEnabled=2 (Kernel Memory Dump)
- Added -DumpFilePath optional parameter (default C:\Windows\MEMORY.DMP) with drive and space validation
- -DedicatedDumpFileDriveLetter is now mandatory in KernelDumpDedicated set (mutually exclusive with -DumpFilePath)
- Updated cluster scriptblock to support all parameter set variations

### Get-AzStackHciOsConfigSettings — PassThru Support
- Added -PassThru switch: returns PSCustomObject with JSON health summary for programmatic consumption
- Enables silent automation: $results = Get-AzStackHciOsConfigSettings -Scope Cluster -NoOutput -PassThru
- Returned object includes all health checks plus HTMLReportPath and JSONReportPath

### Test-AzureLocalConnectivity — Tiered RFC1918 Private Link Detection
- RFC1918 detection now uses three-tier classification instead of one-size-fits-all warning
- Tier 1 (Red/Critical): Arc endpoints (*.his.arc.azure.com, *.guestconfiguration.azure.com, *.dp.kubernetesconfiguration.azure.com) — NOT SUPPORTED for Azure Local
- Tier 2 (Yellow/Warning): PaaS Private Link endpoints (Key Vault, Storage, ACR, SQL, Site Recovery, Backup, Service Bus) — proxy bypass required
- Tier 3 (Yellow/Info): Other RFC1918 addresses — informational, check DNS configuration
- Added proxy-aware messaging: when proxy detected, advises adding Private Link FQDNs to proxy bypass/exception list
- Added PRIVATE_LINK_PROXY_BYPASS_ENDPOINTS constant for PaaS services supporting Private Link
- Expanded PRIVATE_LINK_CRITICAL_ENDPOINTS to include *.his.arc.azure.com and *.dp.kubernetesconfiguration.azure.com
- Result Note field now shows tier-specific prefix: "*Arc Private Link NOT SUPPORTED*", "*Private Link detected - add to proxy bypass list*", or "*Private Link detected*"
- Summary output lists affected endpoints per tier with actionable guidance
- Removed duplicate PrivateLink Note-update block that was running twice
- Reference: https://learn.microsoft.com/en-us/azure/azure-local/concepts/firewall-requirements

### Test-AzureLocalConnectivity — KeyVault Placeholder Handling
- Placeholder KeyVault endpoint shows Failed with descriptive Note, skips pointless DNS retries
- Redirect loop guard changed from -eq to -ge for defensive bounds checking

### Get-AzStackHciOsConfigSettings — Power Plan and Report Rollup Fixes
- Power Plan check now FAILs if active plan is not High Performance (not just cross-node consistency)
- Added Knowledge link for Power Plan: slow performance when using power plans other than High Performance
- Node tab Power Plan section shows error when not High Performance (rolls up to node/sub-tab indicators)
- Fixed Summary tab icon not reflecting NetworkATC or Key Services failures

### Bug Fixes
- Restore-AzStackHciMemoryDumpSettings: added bounds check before .Split()[1] in backup parsing (cluster + local)
- Set-AzStackHciMemoryDumpSettings: added -ErrorAction Stop to Get-CimInstance in cluster scriptblock
- Test-DownloadSpeedParallel: HttpWebResponse range probe closed in finally block (fixed socket leak)
- Add-RedirectedUrlToResults: redirect Note now recorded even when original Note is empty
- Test-AzureLocalConnectivity: certificate chain .ChainElements.Count guard before indexing
- Test-Layer7Connectivity: HttpWebResponse disposed in finally block; Headers["Location"] syntax fixed
- Import-Csv failure on malformed GitHub markdown now emits warning instead of silent empty results
- Separated CERT_CAPTURE_TIMEOUT_TICKS (15s) from HTTP_TIMEOUT_SEC (60s)

For full version history (including v0.6.2 and earlier) see CHANGELOG.md shipped with this module.

FileList

Version History

Version Downloads Last updated
0.6.5 53 4/20/2026
0.6.4 (current version) 26 4/17/2026
0.6.2 145 3/18/2026
0.6.1 294 12/4/2025
0.6.0 205 9/17/2025
0.5.9 31 9/10/2025
Show more