8000
Skip to content

This script tries to uninstall the current version of Microsoft Office and installs a new and fresh copy of Office365

License

Notifications You must be signed in to change notification settings

Admonstrator/msoffice-removal-tool

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

29 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Microsoft Office Removal Tool

Remove Office installations with ease!

Latest Release License Stars


πŸ’– Support the Project

If you find this tool helpful, consider supporting its development:

GitHub Sponsors Buy Me A Coffee Ko-fi PayPal


πŸ“– About

This script downloads the current Office uninstaller from Microsoft and automatically removes all Office installations on your computer.

The script features two removal methods and can optionally install the newest Office 365 build after removal.

Created by Aaron Viehl for the community.

⚠️ Disclaimer – This is an independent project, not officially affiliated with Microsoft


✨ Features

  • πŸš€ Automatic Removal – Removes all Office installations from your computer
  • πŸ”„ Flexible Methods – Choose between SaRA or Office365 setup removal
  • πŸ“¦ Optional Installation – Install Office365 after removal if desired
  • πŸ›‘οΈ Safe Processing – Built-in stage mechanism to track progress
  • ⚑ Flexible Options – Multiple parameters for customized removal
  • πŸ”„ Automatic Reboot – Optional automatic reboot after completion

πŸ“‹ Requirements

Requirement Details
OS Windows (Windows 10 or later recommended)
PowerShell PowerShell 5.0 or later
Permissions Administrator privileges required
Internet Required for downloading Office uninstaller

πŸš€ Quick Start

Run the script without cloning the repository:

iwr https://get.admon.me/remove-msoffice -OutFile msoffice-removal-tool.ps1; powershell -ExecutionPolicy Bypass .\msoffice-removal-tool.ps1

πŸŽ›οΈ Parameters

The msoffice-removal-tool.ps1 script supports the following parameters:

Parameter Description
-InstallOffice365 The script will try to install the newest Office365 build after removal
-SuppressReboot No reboot will be executed after script is done
-UseSetupRemoval Will use the official Office365 setup instead of SaRA for uninstalling
-RunAgain Will skip the stage mechanism - whole script will run again
-Force Non-interactive mode - No user interaction required
-SecondsToReboot [int] Seconds until the computer will reboot (default: 120)

πŸ“š Usage Examples

Standard Removal

Remove Office with the default SaRA method:

.\msoffice-removal-tool.ps1

Removal with Reinstallation

Remove Office and install the latest Office365 build:

.\msoffice-removal-tool.ps1 -InstallOffice365

Force Removal Without Reboot

Skip all prompts and prevent automatic reboot:

.\msoffice-removal-tool.ps1 -Force -SuppressReboot

Using Office Setup Removal

Use the Office365 setup method instead of SaRA:

.\msoffice-removal-tool.ps1 -UseSetupRemoval -Force

Complete Unattended Removal with Reinstallation

For fully unattended operation with reinstallation:

.\msoffice-removal-tool.ps1 -InstallOffice365 -Force -SecondsToReboot 60

Restarting the Entire Process

To skip the stage mechanism and run the entire script again:

.\msoffice-removal-tool.ps1 -RunAgain -Force

πŸ” Key Features Explained

🎯 Stage Mechanism

The script uses a built-in stage mechanism to ensure it only performs necessary steps and doesn't repeat work unnecessarily.

After every stage, a registry value is written to:

HKLM:\Software\OEM\Singleton-Factory-GmbH\M365\Install\CurrentStage

The mechanism is:

  • βœ… Applied automatically
  • βœ… Persistent across script restarts
  • βœ… Can be overridden with -RunAgain parameter

πŸ”§ Removal Methods

Default Method (SaRA):

Setup Method:

  • Uses the official Office365 setup
  • More thorough removal
  • Enabled with -UseSetupRemoval parameter

πŸ“¦ Office365 Installation

When using -InstallOffice365, the script will:

  • βœ… Automatically download the latest Office365 build
  • βœ… Install Office365 after removal completes
  • βœ… Configure the XML installation files from the office365-installer/ directory

πŸ’‘ Getting Help

Need assistance or have questions?

  • πŸ› Report issues on GitHub – Bug reports and feature requests
  • πŸ“§ Contact via GitHub – For private inquiries

⚠️ Disclaimer

This script is provided as-is without any warranty. Use it at your own risk.

It may potentially:

  • πŸ”₯ Remove important files or configurations
  • πŸ”₯ Cause system instability
  • πŸ”₯ Require manual recovery steps

You have been warned!

Always read the documentation carefully and understand what a script does before running it. Create a system restore point before executing this script.


πŸ“œ License

This project is licensed under the MIT License – see the LICENSE file for details.


Made with ❀️ by Admonstrator

⭐ If you find this useful, please star the repository!

Last updated: 2025-12-21

About

This script tries to uninstall the current version of Microsoft Office and installs a new and fresh copy of Office365

Topics

Resources

License

Stars

Watchers

Forks

0