Microsoft 365 Reset (1.0.0)

A MDM-agnostic, unified, user-friendly macOS script to repair, reset, or remove Microsoft 365 components

Background

A December 2023 Microsoft 365 Reset (2.0.0b1) via Jamf Pro Self Service post detailed a “quick-and-dirty Jamf Pro Policy hack for testing Microsoft_Office_Reset_2.0.0.pkg” (which still works as advertised today, more than 840 days later).

However, while recently conducting some internal training, I was pained by how user un-friendly the workflow seemed, even if it did get the job done.

Slideshow

Overview

The latest version is always available in the Microsoft-365-Reset repository on GitHub.com.

The Microsoft-365-Reset.zsh script seeks to provide an MDM-agnostic, unified, user-friendly approach to all of Paul’s Office-Reset goodness.

Additionally, one resolution to the nightmare that is the Adobe Acrobat Add-in Removal for Microsoft 365 is also included.

Under-the-hood

The script consolidates the expanded package workflows into one easy-to-use tool with:

• Interactive swiftDialog UI in self-service, test, and debug modes
• Non-interactive execution in silent mode
• Dependency-aware operation resolution
• Deterministic execution order
• Shared logging and exit codes for automation
• Auto-repair for selected Microsoft apps using Microsoft-hosted packages
• MOFA community-maintained reset script contents adapted into the unified workflow

MOFA Parity

The MOFA Community scripts are built upon the original Office-Reset.com tools, ensuring they remain up-to-date, reliable, and continuously improved. 

• reset_factory performs its own MOFA-style suite cleanup in addition to dependency expansion
• App repair/reinstall flows for Word, Excel, PowerPoint, Outlook, and OneNote now stop after repair instead of continuing with configuration cleanup in the same run
• reset_teams preserves Teams backgrounds, resets Teams TCC state, and opens Screen Recording settings in interactive modes
• reset_teams preserves installed Teams app bundles unless repair is required; reset_teams_force performs the explicit app removal and reinstall path
• Teams reset and AutoUpdate registration now treat new Teams as the current TEAMS21 product while keeping classic Teams on the legacy product ID
• Separate reset_license and reset_credentials operations cover MOFA’s split between license-only and broader sign-in reset flows
• reset_teams_force provides a force-reinstall path for Teams without adding a new CLI parameter

Support

Best-effort support is available on the Mac Admins Slack (free, registration required) — sans a dedicated channel for this script — or you can open an issue (after reviewing the README.md).