AzStackHci.DiagnosticSettings

Author(s)

• Microsoft Corporation

Tags

Microsoft AzStackHci Diagnostic Settings Connectivity AzureLocal

Functions

Get-AzStackHciMemoryDumpSettings Set-AzStackHciMemoryDumpSettings Restore-AzStackHciMemoryDumpSettings Get-AzStackHciPageFileSettings Restore-AzStackHciPageFileSettings Set-AzStackHciPageFileMinimumSettings Set-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.2

### Test-AzureLocalConnectivity
- Added -OutputFormat parameter (HTML or CSV); JSON is always generated automatically alongside the chosen format
- Changed default output from CSV to HTML with Azure-themed styling (color-coded rows, bold status, scrollable tables with synced scrollbars)
- Added Write-Progress with sub-progress bars for redirects, remaining URLs, and wildcard expansion
- Added ArcGateway parameter set: -ArcGatewayDeployment and -ArcGatewayURL mandatory together
- Enhanced SSL inspection detection with known root CA thumbprint validation
- Added exponential backoff to DNS retry logic
- Added URL validation for endpoints parsed from markdown
- Added support for prefix wildcard patterns (e.g. azgn*.servicebus.windows.net)
- Fixed double redirect Note prefix on multi-hop redirects (e.g. download.microsoft.com)
- Fixed VerbosePreference leak on Azure Local nodes where machine-level $VerbosePreference = 'Continue'
- Improved Managed Identity error handling in Private Link Scope detection
- Certificate validation callback reset to null in end block (prevents leaking to other sessions)

### Test-Layer7Connectivity
- SSL certificate retrieval retries once on failure (handles intermittent backend server TLS handshake timeouts)
- Reduced HttpClient timeout for certificate retrieval from 60s to 15s
- Certificate validation callback reset to null in end block
- Added Write-Verbose streaming alongside Write-Host output

### Get-AzStackHciOsConfigSettings
- Parallel data collection across cluster nodes via Invoke-Command fan-out (near-linear speedup)
- All per-node collections consolidated into single self-contained remote script block
- Consolidated tabbed HTML report with cluster name and datetime in filename
- JSON output always generated automatically alongside HTML report
- HTML report copied to C:\ProgramData\AzStackHci.DiagnosticSettings\ for persistence
- Summary tab: cluster/host info, GPO status overview, data collection matrix per node
- Cluster Consistency checks: UBR, Windows Features, NIC Drivers, Power Plan, Hardware, Hotfix, DNS, NTP
- Summary tab health checks: Storage Health, NetworkATC Status, Key Services Health (cluster-aware), Arc Agent Health
- JSON output redesigned as lightweight PASS/FAIL health summary, to avoid excessive JSON serialization of the entire report data structure
- Key Services cluster-group awareness: blue badge for cluster-owned services expected Stopped on non-owner nodes
- Arc Agent Health: status, version, heartbeat validation; version drift detection across nodes
- GPO Health Check badge changed from red to yellow for domain GPOs (warning instead of error)
- Cluster Drift Control made non-blocking and is executed against the cluster scope as a background job
- Excluded vmic* guest integration services from Key Services (expected Stopped on hosts)
- Per-node sub-tabs: OS Policy & Config, Network & Connectivity, Time & Crypto, System & Hardware, Services & Agents, Events & Reboot
- Data collected: System Info, Network Config, Virtual Switch/SET, WinHTTP Proxy, Firewall Profiles, W32Time/NTP, TLS/SCHANNEL, Hotfixes, Windows Features, Power Plan, Key Drivers, Key Services, Arc Agent, Defender, Event Logs (7 days), Pending Reboot, NetIntentStatus, ClusterGroups
- Stability Events (Unexpected Restarts & Bug Checks) moved to top of Summary tab, before GPO Overview
- Added GPO Overview summary card with green/yellow status and knowledge base link
- GPOs contribute warning to Summary tab three-level rollup
- Non-Microsoft Services detection on Summary tab
- Section status icons moved to left side in collapsible section headers
- Report filenames prefixed with cluster name (e.g. ClusterName_AzureLocal_OsConfigReport-...)
- Export folder prefixed with cluster/node name; collected data stored under Data-Collection subfolder
- Status Overview table at top of Summary tab with pass/warn/fail status and anchor links per section
- JSON report also copied to C:\ProgramData\AzStackHci.DiagnosticSettings\
- Added tip about opening HTML report from IT jump box or EUC device

### Set-AzStackHciMemoryDumpSettings
- Added SupportsShouldProcess (-WhatIf/-Confirm)
- Added registry rollback on failure (captures original values, restores on error)
- Fixed misleading verbose: "Dedicated Dump File Size set to" changed to "required"

### Restore-AzStackHciMemoryDumpSettings
- Added SupportsShouldProcess with ConfirmImpact='High' (replaces manual Read-Host prompt)

### Set-AzStackHciPageFileMinimumSettings / Set-AzStackHciUserModeCrashDumpSettings
- Added SupportsShouldProcess (-WhatIf/-Confirm) to both functions

### Auto-Update (Module Version Management)
- Fixed Sort-Object to use -Descending for correct newest version selection
- Fixed Find-Module handling of multiple PSRepositories returning an array
- Fixed Get-LatestModuleVersion early return emitting duplicate null
- Stale module cleanup moved to after successful install only

### Module Architecture (no functional changes to exported commands)
- Refactored into modular file structure: 10 Private/ helpers + 8 Public/ function files
- Added Constants file centralizing all configuration values (timeouts, ports, redirect limits)
- Added Initialize-ModuleState for clean state reset between runs
- Extracted redirect tracking into Add-RedirectedUrlToResults helper
- Added Write-AzSError helper for consistent error output
- Added CompatiblePSEditions (Desktop and Core), LicenseUri, ProjectUri
- Expanded Pester test coverage; all 14 exported functions remain unchanged
- Converted all source files to UTF-8 BOM encoding for readable git diffs

### Improvements
- Certificate validation callback cleanup guaranteed via try/finally (prevents stale callback on exceptions)
- Auto-update version check uses 15-second timeout to prevent hangs when PSGallery is unreachable
- Auto-update validates installed module version after import
- Added [OutputType()] declarations to all 14 exported functions
- Added comment-based help to Test-Layer7Connectivity, Test-TCPConnectivity, Test-AzureLocalConnectivity, Get-AzStackHciOsConfigSettings
- Write-Progress shows estimated time remaining during endpoint testing

For full version history see CHANGELOG.md shipped with this module.