Windows Upgrade / IPU Failure Decoder

Windows Upgrade / IPU Failure Decoder is a PowerShell tool designed to help administrators quickly identify likely causes of Windows feature update and In-Place Upgrade (IPU) failures.

The tool analyzes Windows Setup logs and optionally MECM (Microsoft Endpoint Configuration Manager) Task Sequence logs to highlight the most relevant failure, provide contextual information, and generate actionable recommendations.

---

Features

• Detects common Windows Setup upgrade failures

• Analyzes MECM Task Sequence failures (SMSTS.log)

• Identifies failed readiness checks

• Extracts the most relevant failure event

• Provides log context around the failure

• Generates actionable recommendations

• Supports automation through exit codes and quiet mode

• Exports results to:

  • JSON
  • CSV
  • HTML

---

Supported Scenarios

Windows Feature Updates

• Windows 10 → Windows 11
• Windows 11 Feature Updates
• Setup.exe based upgrades

MECM In-Place Upgrades

• Task Sequence based IPU deployments
• Readiness check failures
• Failed command lines
• Failed scripts
• Task Sequence execution failures

---

Requirements

• Windows 10 or Windows 11
• PowerShell 5.1 or later
• Administrative privileges recommended
• MECM client installed (for MECM log analysis)

---

Usage

Basic Analysis

.\WindowsUpgradeFailureDecoder.ps1

Include MECM Task Sequence Analysis

.\WindowsUpgradeFailureDecoder.ps1 -IncludeMECM

Show Detailed Context

.\WindowsUpgradeFailureDecoder.ps1 -IncludeMECM -Detailed

Export Reports

.\WindowsUpgradeFailureDecoder.ps1 `
    -IncludeMECM `
    -ExportJson `
    -ExportCsv `
    -ExportHtml

Open HTML Report Automatically

.\WindowsUpgradeFailureDecoder.ps1 `
    -IncludeMECM `
    -ExportHtml `
    -OpenReport

Quiet Mode

.\WindowsUpgradeFailureDecoder.ps1 `
    -IncludeMECM `
    -Quiet

Example output:

FailureDetected;Engine=MECM Task Sequence;Category=Failed Task Sequence action;ErrorCode=4316;Step=Check Readiness;ReadinessCheck=TPM Enabled

---

Exit Codes

Exit Code	Meaning
0	No failure detected
2	Failure detected
9	Script error (reserved for future versions)

---

Example Findings

TPM Readiness Failure

Failed Step      : Check Readiness
Readiness Check  : TPM Enabled
Confidence       : High
Likely Cause     : TPM is disabled or not properly exposed to Windows

Secure Boot Failure

Readiness Check  : Secure Boot
Confidence       : High
Likely Cause     : Secure Boot is disabled or device is not configured in UEFI mode

Windows Setup Failure

Error Code       : 0xC1900101
Category         : Driver failure

---

Generated Reports

JSON

Suitable for:

• Power BI
• Data collection
• Automation
• Integration with management platforms

CSV

Suitable for:

• Excel analysis
• Bulk reporting
• Operational reviews

HTML

Suitable for:

• Helpdesk investigations
• Incident reports
• Technical reviews
• Management summaries

---

Disclaimer

This tool is audit-only.

It does not modify:

• Windows configuration
• MECM Task Sequences
• BIOS settings
• TPM settings
• Secure Boot settings
• BitLocker configuration

Always validate recommendations before implementing changes in production environments.

---

Roadmap

Planned future enhancements:

• Additional Windows Setup error decoding
• SetupDiag integration
• Batch analysis mode
• Power BI reporting templates
• Intune remediation integration

---

Author

Lijane Consulting

Digital Workplace & Endpoint Management Expertise

Website: https://lijaneconsulting.com

---

License

MIT License