Edit

Share via


Azure Virutal Machine (VM) Windows Update error detection tool

Applies to: ✔️ Windows VMs

Overview

This PowerShell script scans Component-Based Servicing (CBS) logs for known Windows servicing error codes that indicate issues requiring an in-place upgrade (IPU) or repair. It counts occurrences of each error code and provides a summary at the end. If any errors are found, a remediation link to Microsoft documentation is displayed.

Features

  • Scans CBS logs and archived .zip logs in *C:\Windows\Logs\CBS*.
  • Filters based on a configurable date range (default: last 30 days).
  • Categorizes errors by severity: Critical, High, Medium, Low.
  • Displays a summary of error occurrences.
  • Provides remediation guidance link if errors are detected.

For more information, see Azure VM Windows Update Error Detection script.

Azure portal view Run Command example.

How to run the tool

You can run the tool in any of the following manners.

1. Download from GitHub and run within the VM

Download the scripts from GitHub and then run them manually. To access the scripts, follow the resource links in the previous sections.

2. Use prepackaged run command scripts

For more information, see Run scripts in your Windows VM by using action Run Commands.

  1. Run windows-vm-ipu-tool to verify activation status and detect common issues.
  2. Apply the suggested fixes or refer to the official documentation for advanced troubleshooting.

Additional resources

Contact us for help

If you have questions, you can ask Azure community support. You can also submit product feedback to Azure feedback community.

Third-party contact disclaimer

Microsoft provides third-party contact information to help you find additional information about this topic. This contact information may change without notice. Microsoft does not guarantee the accuracy of third-party contact information.