Skip to main content

Hey all,



I took some time off during the summer and completed a tool that I have been thinking about for some time. I’ve fully tested it with Jamf Pro. Hope it helps!



https://office-reset.com

Many thanks!



Used this to rectify a recalcitrant Outlook account yesterday.



I'm adding to our Self Service now. Caching the package and then launching it via command


@mosermat Thanks for letting me know about this! Just to be safe I'll make a change in the upcoming version to be more specific about which folders to remove under /Library/Application Support/Microsoft


@chuck3000 Thanks for the feedback! Both Office 2016 and 2019 share the same app and bundle ID, so you typically don't find both versions on the same machine. In other words, if you had 2016 installed and then upgraded to 2019 (or 365), the 2016 version would be overwritten. Of course, there are ways of making 2016 and 2019 coexist such as renaming or moving the app bundle. However, long story short is that Office-Reset looks for apps with their standard name and bundle ID in the /Applications folder of the boot partition, so it won't try and mess with other versions which may exist on secondary partitions.



Hope this helps!



Paul.


Thanks @pbowden
Of my inventory I found I have three machines with both 2016 and 2019 installed. Of my approx 100 seats that’s not horrible.



A couple further questions (and sorry I have not dissected the scripts yet):
Can I pick and choose what to remove or leave? Eg: only leave excel 2019 but remove the rest? Does it touch MS Remote Desktop? Does the script effect other MS apps like Skype or Teams? What about the Outlook Database vs just the app? Are the MS fonts removed too?



Thanks again for all your work!


@chuck3000 Most of your questions can be answered by looking at https://office-reset.com/faq/
However, quick answers:
1. You can pick and choose which apps to 'reset'. I intentionally say 'reset' here rather than 'remove' because the purpose of the tool is to fix problems. In other words, you could choose to 'Reset Excel' and the tool will figure out what might be wrong with Excel to get it back into a working state. For example, if the tool detects that the Excel app is corrupt, it will remove it and install a new version.
2. Nope, the tool doesn't offer any support for Microsoft Remote Desktop. However, it does support both Teams and Skype for Business.
3. Yes, the tool supports both Outlook Database resets and Outlook app/preference/metadata resets.
4. Since 2016 the MS supplied fonts are embedded within the app packages and not installed into system and user locations. However, we do have Cloud Fonts and these are removed as part of the 'completely remove Office' option.



I hope this helps!


@pbowden This tool looks great - thank you. In the process of getting O365 installed in our environment so this will come in handy for my team


@pbowden I apologize but I'm not finding details on the FAQ how to use the fix packages to simply remove the software completely. I pulled the script of the OneNote_Reset package and essentially it appears I just need to remove the "RepairApp" portions of the script and mostly rely on the clean up portion at the end (the part starting with Office-Reset: Removing configuration data for ${APP_NAME}"). Or am I making this too difficult?
Again, your powers are certainly appreciated!
I'll be sending over a Pot of coffee rather than a cup...
Best regards


@chuck3000 Really appreciate the super-sized coffee! If you haven't discovered the links already, make sure you check out https://office-reset.com/macadmins and https://office-reset.com/jamf/.
If you're looking to remove Office completely from a machine (e.g. all apps, config data, preferences, etc, etc) you just need to push the Complete Removal Package download through a Jamf Policy (or put it in Self Service).



Let me know if you're looking for a custom solution or something else, and I'm more than happy to provide!



Paul.


@pbowden
I’m Looking to just remove a single app, oneNote in this example. But could be PowerPoint or outlook or Skype (and all the pieces of Skype/4bix).


@chuck3000 Some of the apps have interdependencies on shared configuration data, so removal of a single app begs the question as to how far you want to go to clean-up, and boils down to the problem you want to solve.



Skype for Business is the easy one as it doesn't have any interdependencies, so you can remove it and all of it's configuration data with the package at https://office-reset.com/download/Microsoft_SkypeForBusiness_Removal_1.5.pkg.



Word, Excel, PowerPoint, Outlook and OneNote use shared configuration data and keychain entries, so those are the most problematic to separate. If you're simply looking to remove one of the apps because you don't use it, and would like the disk space back, then the easiest option is just to rm the app bundle in /Applications. If you wish, you can go further by using the app-specific reset package such as https://office-reset.com/download/Microsoft_PowerPoint_Reset_1.5.pkg to get remove any PowerPoint specific configuration, preferences and metadata.



On the other hand, if you're looking to remove a single app with the intention of installing it again (e.g. you suspect that the existing app might be corrupt), then simply run that app-specific reset package because it will check for corruption and repair it as necessary.



I hope this helps. Feel free to elaborate on your scenario or the specific problem you're trying to solve!



Thanks, Paul.


@pbowden
For my removal of OneNote alone, simply removed the app:



/bin/rm -rf "/Applications/Microsoft OneNote.app"


then I snagged this from your script and added them to my script:



/bin/rm -f "/Library/Preferences/com.microsoft.onenote.mac.plist"
/bin/rm -f "/Library/Managed Preferences/com.microsoft.onenote.mac.plist"
/bin/rm -f "$HOME/Library/Preferences/com.microsoft.onenote.mac.plist"
/bin/rm -rf "$HOME/Library/Containers/com.microsoft.onenote.mac"
/bin/rm -rf "$HOME/Library/Containers/com.microsoft.onenote.mac.shareextension"
/bin/rm -rf "$HOME/Library/Application Scripts/com.microsoft.onenote.mac"
/bin/rm -rf "$HOME/Library/Application Scripts/com.microsoft.onenote.mac.shareextension"
/bin/rm -rf "/Applications/Microsoft OneNote.app.installBackup"
/bin/rm -rf "$HOME/Library/Group Containers/UBF8T369G9.Office/OneNote"


These i'm debating if they'll hurt other installed Office apps:



/bin/rm -rf "$HOME/Library/Group Containers/UBF8T369G9.Office/FontCache"
/bin/rm -rf "$HOME/Library/Group Containers/UBF8T369G9.Office/TemporaryItems"


Appreciate your hard work...


@chuck3000 Looks good. Personally, I'd recommend that you don't include those last two statements in the third block as they are shared with the other apps. Technically, the folders will get rebuilt if you delete them, but it would be better to stay safe and let them be.


You are the guy who saved my ass tousand times :-)


@mickl089 you are too kind - thanks for the compliment!


@pbowden I do understand Office Reset is a repair tool first and foremost. However, it's counterintuitive for the Complete Removal Package to also reset — including repair — the apps. If all you want is to uninstall whatever versions are installed, why bother downloading and updating to the newest versions first?


@mthakur yes, you’re correct. There’s logic in the preinstall script of the Complete Removal meta package to remove the apps before the repair sequence runs. Because the apps will be removed first, the repair logic which runs codesign and version check will be skipped. All told, a Complete Removal won’t attempt to repair.



Hope this helps!


@pbowdenwhat does the LICENSE RESET.pkg do?   I am using an EA that gets the Office license versions installed and on some it displays that it has both 2019 and 365. How can this be?  Can I just remove the 365 license while keeping the 2019?

Also it seems like the COMPLETE REMOVAL.pkg works to remove Office 2021 (basically 2021 & 2019 are the same location).


@pbowdenwhat does the LICENSE RESET.pkg do?   I am using an EA that gets the Office license versions installed and on some it displays that it has both 2019 and 365. How can this be?  Can I just remove the 365 license while keeping the 2019?

Also it seems like the COMPLETE REMOVAL.pkg works to remove Office 2021 (basically 2021 & 2019 are the same location).


@tcandela the License Reset package removes all Volume and 365 licenses, plus it removes the identity data from the keychain.

If the EA is reporting that you have both 2019 and 365 licenses, what's likely happened here is that you have run the VL Serializer to create the 2019 license, but you've also signed-in to an O365 account that also has a license associated with it. From a product perspective, it'll be using the O365 subscription account until you sign out.


@pbowdenI thought the office 2021 VL Serializer would replace the 2019 VL serializer? because now my EA is saying "Office 2021/2019 Volume License (Stacked)"

why aint it just saying "Office 2021 Volume License" ??????


@tcandela we changed things with the 2021 VL Serializer so that you can have both a 2019 and 2021 license side-by-side. This helps with updates while the apps are launched. See my JNUC session at https://www.youtube.com/watch?v=7cFKXl4qI00 for more info here.


@pbowden so is it better to have stacked licenses or just the 2021 alone?


@pbowden if I have the EA showing  office 2019/2021 stacked and then I ran the 'license-reset.pkg' followed by the 2021 LTSC serializer.pkg would it be a problem?   It's ok just to have the EA with 'Office 2021 license installed' ?


@pbowden if I have the EA showing  office 2019/2021 stacked and then I ran the 'license-reset.pkg' followed by the 2021 LTSC serializer.pkg would it be a problem?   It's ok just to have the EA with 'Office 2021 license installed' ?


@tcandela yup, that's a fine approach and won't cause a problem. Technically, it's better to have a 'stacked' license, but either way works.


@tcandela yup, that's a fine approach and won't cause a problem. Technically, it's better to have a 'stacked' license, but either way works.


@pbowden I think with having only the 2021 license appearing in the EA it will make it easier to find the computers running Office 2021


@pbowden i had a mac with the EA showing 'office 2019 volume license and Office 365' then I ran the license_reset.pkg and the EA now display 'office 365 activations: 1'.  Should it have been 'blank' after running the license-reset.pkg? you previously wrote = License Reset package removes all Volume and 365 licenses, plus it removes the identity data from the keychain.

I then ran the 2021 VL serializer and now it shows 'office 2021 volume license and Office 365'