Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Update Repair in the Microsoft 365 Apps admin center helps you find Windows devices with Microsoft 365 Apps that are out of date or reporting update problems. Review each device's status and use the Repair action for eligible devices, or follow the recommended manual steps for devices that need attention.
Note
Update Repair is currently available as a preview. Some devices may require manual remediation and cannot be repaired from the admin center.
How Update Repair works
Update Repair uses device data reported to Inventory, including the installed Microsoft 365 Apps version and build, the target version policy, and Click-to-Run error information. It compares the installed version with the latest version available for the device's configured update channel and assigns a status.
The report shows devices in the Needs repair and Needs attention states. Devices that are Up to date or Outdated aren't shown because they don't currently require remediation.
| Status | What it means |
|---|---|
| Up to date | The device is on the latest available version for its update channel. |
| Outdated | The device is one or two versions behind and has no reported error. |
| Needs repair | The device is at least one version behind and has an error that doesn't require separate remediation, or it's at least three versions behind and has no reported error. |
| Needs attention | The device has an error that requires separate remediation, or it otherwise qualifies for repair but is running a Microsoft 365 Apps build earlier than 16.0.20326.20000. These devices aren't eligible for the Repair action. |
Prerequisites
- The device runs Windows and has Microsoft 365 Apps installed.
- The device appears in Inventory and reports current data.
- To be eligible for the Repair action, the device must run Microsoft 365 Apps build
16.0.20326.20000or later.
If eligible devices need repair or attention, a notification banner appears on the Home and Inventory pages. Select Review devices in the banner to open Update Repair and see device details and recommended actions.
Review devices that need attention
Devices in the Needs attention state can't be repaired by the Repair action. Select a device name to open its details pane and review the installed version and build, update status, and reported error information. Remediate the underlying issue before retrying the update.
If the device is running a build earlier than 16.0.20326.20000, use Click-to-Run Online Repair to update the installation and restore it to a supported state:
- Open Installed apps (or Add or remove programs) in Windows.
- Locate Microsoft 365 Apps and select Modify or Change.
- Select Online Repair, then Repair, and follow the prompts.
Alternatively, run the following command from an elevated Command Prompt:
"C:\Program Files\Common Files\Microsoft Shared\ClickToRun\OfficeClickToRun.exe" scenario=Repair platform=x64 RepairType=FullRepair forceappshutdown=True DisplayLevel=True
The command specifies the x64 platform. Verify that this matches the Microsoft 365 Apps installation on the device before running it.
Click-to-Run errors that require manual remediation
Devices that are three or more versions behind and report one of the following errors appear as Needs attention. Review the error category, resolve the issue, and then try the update again.
| Error category | Error codes | Recommended action |
|---|---|---|
| Disk space | 112, 30192, 30179 |
Free up disk space. |
| Permissions | 5, 181 |
Ensure the device has the permissions required to modify files and registry settings. |
| File or package issues | 151, 183, 30195, 30182 |
Repair the Office installation or clean up local files. |
| Metadata or file integrity | 30058, 30045 |
Retry the update or repair the Office installation. |
| Configuration issues | 148, 153, 158 |
Review and correct deployment or configuration settings. |
| System preconditions | 146, 147, 149 |
Close apps, restart the device if needed, or run the update with the required permissions. |
| Persistent network issues | 150, 159, 172 |
Check network connectivity, proxy settings, and firewall rules. |
Repair eligible devices
Use the Repair action for devices in the Needs repair state:
- In the Update Repair table, select one or more devices.
- Select Repair and confirm the action.
- Allow time for each device to check in with Inventory and receive the action.
The action triggers Click-to-Run Online Repair. It closes any open Microsoft 365 Apps, then reinstalls Microsoft 365 Apps by downloading the latest available build for the device's configured update channel from the Microsoft Content Delivery Network (CDN).
Warning
Repair interrupts users and closes open Microsoft 365 Apps. Notify affected users before you start. Ask them to save their work and close their Office apps, and leave their devices powered on, signed in, and connected so the action can be received.
The action doesn't start immediately. During preview, devices check in with Inventory every 12 hours when they aren't managed by Cloud Update, or every 2 hours when they are managed by Cloud Update. A device receives the action at its next check-in.
Frequently asked questions
Why doesn't a device appear in Update Repair?
Only Windows devices with Microsoft 365 Apps that appear in Inventory, report current data, and are classified as Needs repair or Needs attention appear in the report. Up to date and Outdated devices aren't shown.
Why didn't the repair start right away?
The device receives the action at its next Inventory check-in. During preview, check-ins occur every 12 hours for devices not managed by Cloud Update and every 2 hours for devices managed by Cloud Update. Keep the device powered on, signed in, and connected.
How long does a repaired device remain in the report?
A successfully repaired device can remain in the table for up to 28 days before it's removed.