WinDiagnostics/WindowsMaintenanceReport.ps1

565 lines
19 KiB
PowerShell

<#
.SYNOPSIS
Generates a Windows system and maintenance report.
.DESCRIPTION
Dependency-free, non-GUI Windows inventory and diagnostics script.
It collects:
- OS, BIOS, motherboard, CPU, RAM, GPU
- Disks, free space, physical disk health
- Installed desktop programs and AppX packages
- Startup programs, Run registry entries, startup folders
- Services and stopped automatic services
- Drivers and problem devices
- Windows hotfixes
- Defender and Firewall status
- Network adapters, IP/DNS config, listening TCP ports
- Power plan and battery info
- Scheduled tasks
- Top processes by memory
- Recent System/Application event log errors
- DISM component-store health
- SFC verify-only status
The script is intended to be READ-ONLY. It does not repair, uninstall,
disable, delete, or modify system settings.
.PARAMETER OutputDirectory
Directory in which to write the report.
Default: current working directory.
.PARAMETER EventLogDays
Number of days of System/Application errors to include.
Default: 7.
.PARAMETER MaxEventErrors
Maximum number of errors to include from each event log.
Default: 100.
.PARAMETER InstallCommand
Creates a winreport.cmd launcher next to this script.
If the script folder is on PATH, you can then run:
winreport
.EXAMPLE
.\WindowsMaintenanceReport.ps1
.EXAMPLE
.\WindowsMaintenanceReport.ps1 -OutputDirectory C:\Temp
.EXAMPLE
.\WindowsMaintenanceReport.ps1 -EventLogDays 30 -MaxEventErrors 250
.EXAMPLE
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\WindowsMaintenanceReport.ps1
.EXAMPLE
.\WindowsMaintenanceReport.ps1 -InstallCommand
.NOTES
Recommended: run as Administrator for the most complete output.
If execution policy blocks the script, use:
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\WindowsMaintenanceReport.ps1
To call "winreport" from anywhere:
1. Put this script in a permanent folder, e.g. C:\Tools\WinReport
2. Run:
.\WindowsMaintenanceReport.ps1 -InstallCommand
3. Add that folder to PATH
4. Then use:
winreport
#>
[CmdletBinding()]
param(
[string]$OutputDirectory = (Get-Location).Path,
[ValidateRange(1, 3650)]
[int]$EventLogDays = 7,
[ValidateRange(1, 5000)]
[int]$MaxEventErrors = 100,
[switch]$InstallCommand
)
$ErrorActionPreference = 'Continue'
function Test-IsAdministrator {
try {
$identity = [Security.Principal.WindowsIdentity]::GetCurrent()
$principal = New-Object Security.Principal.WindowsPrincipal($identity)
return $principal.IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)
}
catch {
return $false
}
}
function Write-Section {
param(
[Parameter(Mandatory)]
[System.IO.StreamWriter]$Writer,
[Parameter(Mandatory)]
[string]$Title,
[Parameter(Mandatory)]
[scriptblock]$Script
)
$Writer.WriteLine()
$Writer.WriteLine(('=' * 80))
$Writer.WriteLine($Title)
$Writer.WriteLine(('=' * 80))
try {
$result = & $Script 2>&1 | Out-String -Width 240
if ([string]::IsNullOrWhiteSpace($result)) {
$Writer.WriteLine('(no output)')
}
else {
$Writer.WriteLine($result.TrimEnd())
}
}
catch {
$Writer.WriteLine("ERROR: $($_.Exception.Message)")
}
}
function Install-WinReportCommand {
$scriptPath = $MyInvocation.PSCommandPath
if (-not $scriptPath) {
throw 'Unable to determine current script path.'
}
$scriptDir = Split-Path -Parent $scriptPath
$cmdPath = Join-Path $scriptDir 'winreport.cmd'
$scriptName = Split-Path -Leaf $scriptPath
$cmd = @"
@echo off
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "%~dp0$scriptName" %*
"@
Set-Content -LiteralPath $cmdPath -Value $cmd -Encoding ASCII
Write-Host "Created launcher:"
Write-Host " $cmdPath"
Write-Host
Write-Host "If this folder is on PATH, you can run:"
Write-Host " winreport"
}
if ($InstallCommand) {
Install-WinReportCommand
exit 0
}
if (-not (Test-Path -LiteralPath $OutputDirectory)) {
New-Item -ItemType Directory -Path $OutputDirectory -Force | Out-Null
}
$timestamp = Get-Date -Format 'yyyyMMdd_HHmmss'
$computerName = $env:COMPUTERNAME
$reportPath = Join-Path $OutputDirectory "windows_system_report_${computerName}_${timestamp}.txt"
$utf8NoBom = New-Object System.Text.UTF8Encoding($false)
$writer = New-Object System.IO.StreamWriter($reportPath, $false, $utf8NoBom)
try {
$writer.WriteLine('WINDOWS SYSTEM / MAINTENANCE REPORT')
$writer.WriteLine("Generated: $(Get-Date -Format 'yyyy-MM-dd HH:mm:ss K')")
$writer.WriteLine("Computer: $computerName")
$writer.WriteLine("User: $env:USERNAME")
$writer.WriteLine("Administrator: $(Test-IsAdministrator)")
$writer.WriteLine("PowerShell: $($PSVersionTable.PSVersion)")
$writer.WriteLine("Event log days: $EventLogDays")
Write-Section $writer 'OPERATING SYSTEM / COMPUTER / BIOS' {
Get-CimInstance Win32_OperatingSystem |
Select-Object Caption, Version, BuildNumber, OSArchitecture,
InstallDate, LastBootUpTime, LocalDateTime,
@{N='TotalMemoryGB';E={[math]::Round($_.TotalVisibleMemorySize / 1MB, 2)}},
@{N='FreeMemoryGB';E={[math]::Round($_.FreePhysicalMemory / 1MB, 2)}} |
Format-List
Get-CimInstance Win32_ComputerSystem |
Select-Object Manufacturer, Model, SystemType,
@{N='TotalPhysicalMemoryGB';E={[math]::Round($_.TotalPhysicalMemory / 1GB, 2)}},
Domain, PartOfDomain |
Format-List
Get-CimInstance Win32_BIOS |
Select-Object Manufacturer, Name, SMBIOSBIOSVersion,
ReleaseDate, SerialNumber |
Format-List
}
Write-Section $writer 'UPTIME' {
$os = Get-CimInstance Win32_OperatingSystem
$uptime = (Get-Date) - $os.LastBootUpTime
[PSCustomObject]@{
LastBoot = $os.LastBootUpTime
Days = $uptime.Days
Hours = $uptime.Hours
Minutes = $uptime.Minutes
} | Format-List
}
Write-Section $writer 'CPU' {
Get-CimInstance Win32_Processor |
Select-Object Name, Manufacturer, NumberOfCores,
NumberOfLogicalProcessors, MaxClockSpeed,
CurrentClockSpeed, LoadPercentage |
Format-List
}
Write-Section $writer 'MEMORY MODULES' {
Get-CimInstance Win32_PhysicalMemory |
Select-Object BankLabel, DeviceLocator,
@{N='CapacityGB';E={[math]::Round($_.Capacity / 1GB, 2)}},
Speed, ConfiguredClockSpeed, Manufacturer, PartNumber |
Format-Table -AutoSize
}
Write-Section $writer 'MOTHERBOARD' {
Get-CimInstance Win32_BaseBoard |
Select-Object Manufacturer, Product, Version, SerialNumber |
Format-List
}
Write-Section $writer 'GPU / DISPLAY ADAPTERS' {
Get-CimInstance Win32_VideoController |
Select-Object Name, DriverVersion,
@{N='VRAM_GB';E={
if ($_.AdapterRAM) {
[math]::Round($_.AdapterRAM / 1GB, 2)
}
else {
$null
}
}},
VideoModeDescription |
Format-Table -AutoSize
}
Write-Section $writer 'LOGICAL DISKS / FREE SPACE' {
Get-CimInstance Win32_LogicalDisk -Filter "DriveType=3" |
Select-Object DeviceID, VolumeName, FileSystem,
@{N='SizeGB';E={[math]::Round($_.Size / 1GB, 2)}},
@{N='FreeGB';E={[math]::Round($_.FreeSpace / 1GB, 2)}},
@{N='FreePercent';E={
if ($_.Size) {
[math]::Round(($_.FreeSpace / $_.Size) * 100, 1)
}
}} |
Format-Table -AutoSize
}
Write-Section $writer 'PHYSICAL DISKS' {
Get-CimInstance Win32_DiskDrive |
Select-Object Model, InterfaceType, MediaType,
@{N='SizeGB';E={[math]::Round($_.Size / 1GB, 2)}},
FirmwareRevision, SerialNumber, Status |
Format-Table -AutoSize
}
Write-Section $writer 'STORAGE HEALTH / RELIABILITY' {
if (Get-Command Get-PhysicalDisk -ErrorAction SilentlyContinue) {
Get-PhysicalDisk |
Select-Object FriendlyName, MediaType, HealthStatus,
OperationalStatus,
@{N='SizeGB';E={[math]::Round($_.Size / 1GB, 2)}} |
Format-Table -AutoSize
Get-PhysicalDisk | ForEach-Object {
""
"Disk: $($_.FriendlyName)"
try {
$_ | Get-StorageReliabilityCounter -ErrorAction Stop |
Select-Object Temperature, Wear,
ReadErrorsTotal, WriteErrorsTotal,
PowerOnHours |
Format-List
}
catch {
'Storage reliability counters unavailable.'
}
}
}
else {
'Get-PhysicalDisk is unavailable on this system.'
}
}
Write-Section $writer 'INSTALLED PROGRAMS' {
$paths = @(
'HKLM:\Software\Microsoft\Windows\CurrentVersion\Uninstall\*',
'HKLM:\Software\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\*',
'HKCU:\Software\Microsoft\Windows\CurrentVersion\Uninstall\*'
)
Get-ItemProperty $paths -ErrorAction SilentlyContinue |
Where-Object { $_.DisplayName } |
Select-Object DisplayName, DisplayVersion, Publisher,
InstallDate, InstallLocation |
Sort-Object DisplayName -Unique |
Format-Table -AutoSize
}
Write-Section $writer 'MICROSOFT STORE / APPX PACKAGES' {
if (Get-Command Get-AppxPackage -ErrorAction SilentlyContinue) {
Get-AppxPackage |
Select-Object Name, Version, Publisher, Architecture |
Sort-Object Name |
Format-Table -AutoSize
}
}
Write-Section $writer 'STARTUP PROGRAMS' {
Get-CimInstance Win32_StartupCommand |
Select-Object Name, Command, Location, User |
Sort-Object Name |
Format-Table -Wrap -AutoSize
}
Write-Section $writer 'STARTUP REGISTRY LOCATIONS' {
$startupKeys = @(
'HKLM:\Software\Microsoft\Windows\CurrentVersion\Run',
'HKLM:\Software\Microsoft\Windows\CurrentVersion\RunOnce',
'HKLM:\Software\WOW6432Node\Microsoft\Windows\CurrentVersion\Run',
'HKCU:\Software\Microsoft\Windows\CurrentVersion\Run',
'HKCU:\Software\Microsoft\Windows\CurrentVersion\RunOnce'
)
foreach ($key in $startupKeys) {
""
"[$key]"
if (Test-Path $key) {
$item = Get-ItemProperty $key
$item.PSObject.Properties |
Where-Object {$_.Name -notlike 'PS*'} |
Select-Object Name, Value |
Format-Table -Wrap -AutoSize
}
else {
'(not present)'
}
}
}
Write-Section $writer 'STARTUP FOLDERS' {
$folders = @(
"$env:APPDATA\Microsoft\Windows\Start Menu\Programs\Startup",
"$env:ProgramData\Microsoft\Windows\Start Menu\Programs\Startup"
)
foreach ($folder in $folders) {
""
"Folder: $folder"
if (Test-Path $folder) {
Get-ChildItem $folder -Force |
Select-Object Name, FullName, LastWriteTime |
Format-Table -AutoSize
}
else {
'(not present)'
}
}
}
Write-Section $writer 'AUTOMATIC SERVICES' {
Get-CimInstance Win32_Service |
Where-Object {$_.StartMode -eq 'Auto'} |
Select-Object Name, DisplayName, State, StartMode, StartName |
Sort-Object State, DisplayName |
Format-Table -AutoSize
}
Write-Section $writer 'AUTOMATIC SERVICES NOT RUNNING' {
Get-CimInstance Win32_Service |
Where-Object {$_.StartMode -eq 'Auto' -and $_.State -ne 'Running'} |
Select-Object Name, DisplayName, State, StartMode |
Format-Table -AutoSize
}
Write-Section $writer 'DEVICES WITH PROBLEMS' {
if (Get-Command Get-PnpDevice -ErrorAction SilentlyContinue) {
Get-PnpDevice -PresentOnly -ErrorAction SilentlyContinue |
Where-Object {$_.Status -ne 'OK'} |
Select-Object Status, Class, FriendlyName, InstanceId |
Format-Table -Wrap -AutoSize
}
else {
Get-CimInstance Win32_PnPEntity |
Where-Object {$_.ConfigManagerErrorCode -ne 0} |
Select-Object Name, PNPClass, ConfigManagerErrorCode, DeviceID |
Format-Table -Wrap -AutoSize
}
}
Write-Section $writer 'SIGNED DRIVERS' {
Get-CimInstance Win32_PnPSignedDriver |
Where-Object {$_.DeviceName} |
Select-Object DeviceName, Manufacturer, DriverVersion, DriverDate |
Sort-Object DeviceName |
Format-Table -AutoSize
}
Write-Section $writer 'WINDOWS UPDATES / HOTFIXES' {
Get-HotFix |
Sort-Object InstalledOn -Descending |
Select-Object HotFixID, Description, InstalledBy, InstalledOn |
Format-Table -AutoSize
}
Write-Section $writer 'WINDOWS DEFENDER STATUS' {
if (Get-Command Get-MpComputerStatus -ErrorAction SilentlyContinue) {
Get-MpComputerStatus |
Select-Object AntivirusEnabled, AntispywareEnabled,
RealTimeProtectionEnabled, BehaviorMonitorEnabled,
IoavProtectionEnabled, NISEnabled,
AntivirusSignatureLastUpdated,
AntispywareSignatureLastUpdated,
QuickScanAge, FullScanAge |
Format-List
}
else {
'Microsoft Defender cmdlets unavailable.'
}
}
Write-Section $writer 'FIREWALL PROFILES' {
if (Get-Command Get-NetFirewallProfile -ErrorAction SilentlyContinue) {
Get-NetFirewallProfile |
Select-Object Name, Enabled, DefaultInboundAction,
DefaultOutboundAction |
Format-Table -AutoSize
}
}
Write-Section $writer 'NETWORK ADAPTERS' {
if (Get-Command Get-NetAdapter -ErrorAction SilentlyContinue) {
Get-NetAdapter |
Select-Object Name, InterfaceDescription, Status,
LinkSpeed, MacAddress |
Format-Table -AutoSize
}
}
Write-Section $writer 'IP CONFIGURATION' {
ipconfig /all
}
Write-Section $writer 'DNS SERVERS' {
if (Get-Command Get-DnsClientServerAddress -ErrorAction SilentlyContinue) {
Get-DnsClientServerAddress |
Where-Object {$_.ServerAddresses.Count -gt 0} |
Select-Object InterfaceAlias, AddressFamily,
@{N='Servers';E={$_.ServerAddresses -join ', '}} |
Format-Table -AutoSize
}
}
Write-Section $writer 'ACTIVE TCP LISTENERS' {
if (Get-Command Get-NetTCPConnection -ErrorAction SilentlyContinue) {
Get-NetTCPConnection -State Listen -ErrorAction SilentlyContinue |
Select-Object LocalAddress, LocalPort, OwningProcess |
Sort-Object LocalPort |
Format-Table -AutoSize
}
else {
netstat -ano
}
}
Write-Section $writer 'POWER PLAN' {
powercfg /getactivescheme
}
Write-Section $writer 'BATTERY' {
Get-CimInstance Win32_Battery -ErrorAction SilentlyContinue |
Select-Object Name, Status, EstimatedChargeRemaining,
EstimatedRunTime, BatteryStatus |
Format-List
}
Write-Section $writer 'NON-MICROSOFT SCHEDULED TASKS' {
if (Get-Command Get-ScheduledTask -ErrorAction SilentlyContinue) {
Get-ScheduledTask -ErrorAction SilentlyContinue |
Where-Object {$_.TaskPath -notlike '\Microsoft\*'} |
Select-Object TaskName, TaskPath, State |
Sort-Object TaskPath, TaskName |
Format-Table -AutoSize
}
}
Write-Section $writer 'TOP PROCESSES BY MEMORY' {
Get-Process |
Sort-Object WorkingSet64 -Descending |
Select-Object -First 30 ProcessName, Id,
@{N='MemoryMB';E={[math]::Round($_.WorkingSet64 / 1MB, 1)}},
CPU |
Format-Table -AutoSize
}
Write-Section $writer "RECENT SYSTEM ERRORS - LAST $EventLogDays DAYS" {
$start = (Get-Date).AddDays(-$EventLogDays)
Get-WinEvent -FilterHashtable @{
LogName = 'System'
Level = 2
StartTime = $start
} -ErrorAction SilentlyContinue |
Select-Object -First $MaxEventErrors TimeCreated, Id,
ProviderName, Message |
Format-List
}
Write-Section $writer "RECENT APPLICATION ERRORS - LAST $EventLogDays DAYS" {
$start = (Get-Date).AddDays(-$EventLogDays)
Get-WinEvent -FilterHashtable @{
LogName = 'Application'
Level = 2
StartTime = $start
} -ErrorAction SilentlyContinue |
Select-Object -First $MaxEventErrors TimeCreated, Id,
ProviderName, Message |
Format-List
}
Write-Section $writer 'WINDOWS COMPONENT STORE STATUS' {
DISM.exe /Online /Cleanup-Image /CheckHealth
}
Write-Section $writer 'SYSTEM FILE CHECK - VERIFY ONLY' {
sfc.exe /verifyonly
}
Write-Section $writer 'IMPORTANT DIRECTORIES' {
[PSCustomObject]@{
WindowsDirectory = $env:WINDIR
SystemDrive = $env:SystemDrive
ProgramFiles = $env:ProgramFiles
ProgramFilesX86 = ${env:ProgramFiles(x86)}
ProgramData = $env:ProgramData
UserProfile = $env:USERPROFILE
Temp = $env:TEMP
} | Format-List
}
}
finally {
$writer.Dispose()
}
Write-Host
Write-Host 'Report completed.'
Write-Host "Saved to: $reportPath"