asheroto / uninstallteams

Uninstall Teams in less than a minute.

UninstallTeams

UninstallTeams is a PowerShell script that allows you to quickly uninstall Microsoft Teams from all locations on your Windows machine. Desktop and Start Menu shortcuts are also removed.

You can also adjust the ability to access the Chat widget (Win+C) by enabling, disabling, or unsetting (default / effectively enabling). By default, the chat widget is enabled (unset). You can disable it by running the script with the -DisableChatWidget parameter. The -AllUsers parameter can be used to apply the setting to all user profiles on the machine, excluding the current one, as they are not applied to the current user profile (HKLM/HKCU registry hives).

By default when installing Microsoft Office, Teams is installed. To prevent Teams from being installed when installing Office, you can run -EnablePreventTeamsInstall before you install Office. To re-enable Teams to be installed when installing Office, you can run -DisablePreventTeamsInstall. This is a machine-wide setting.

If you specify a paramter, it will not uninstall Teams. If you do not specify a parameter, it will uninstall Teams.

Microsoft Teams user data is not removed.

Note: If you just installed Microsoft Office, you may need to restart the computer once or twice and then run UninstallTeams to prevent Teams from reinstalling.

Setup

Note: For a stable experience, use one of the methods listed below (#1, #2, or #3) to fetch the latest version. Using the version directly from the GitHub repository is not advised, as it could be under active development and not fully stable.

Method 1 - PowerShell Gallery

This is the recommended method, because it always gets the public release that has been tested, it's easy to remember, and supports all parameters.

Open PowerShell as Administrator and type

Install-Script UninstallTeams -Force

Follow the prompts to complete the installation (you can tap A to accept all prompts or Y to select them individually.

Note: -Force is optional but recommended, as it will force the script to update if it is outdated.

The script is published on PowerShell Gallery under UninstallTeams.

Tip - How to trust PSGallery

If you want to trust PSGallery so you aren't prompted each time you run this command, or if you're scripting this and want to ensure the script isn't interrupted the first time it runs...

Install-PackageProvider -Name "NuGet" -Force
Set-PSRepository -Name "PSGallery" -InstallationPolicy Trusted

Method 2 - One Line Command (Runs Immediately)

The URL asheroto.com/uninstallteams always redirects to the latest code-signed release of the script.

If you just need to run the basic script without any parameters, you can use the following one-line command:

irm asheroto.com/uninstallteams | iex

Due to the nature of how PowerShell works, you won't be able to use any parameters like -DisableOfficeTeamsInstall with this command. You can either use Method #1, #3, or if you absolutely need to use a one-line command with parameters, you can use the following:

&([ScriptBlock]::Create((irm asheroto.com/uninstallteams))) -DisableOfficeTeamsInstall

Method 3 - Download Locally and Run

• Download the latest UninstallTeams.ps1 from Releases
• Run the script with .\UninstallTeams.ps1

Usage

In PowerShell, type

UninstallTeams

This will execute the script and uninstall Microsoft Teams from your machine.

Parameters

These options are used independent of the main script. If you do not use any options, the script will uninstall Teams. If you use any of the options, the script will not uninstall Teams.

UninstallTeams provides additional options to manage the Chat widget (Win+C) for Microsoft Teams, as well as the ability to prevent Teams from being installed when installing Microsoft Office.

Parameter	Description
-EnableChatWidget	Enables the Chat widget (Win+C) for Microsoft Teams.
-DisableChatWidget	Disables the Chat widget (Win+C) for Microsoft Teams.
-UnsetChatWidget	Removes the Chat widget value, effectively enabling it since that is the default.
-AllUsers	Applies the Chat widget setting to all user profiles on the machine.
-EnableOfficeTeamsInstall	Enables the ability for Office to install Teams.
-DisableOfficeTeamsInstall	Disables the ability for Office to install Teams.
-UnsetOfficeTeamsInstall	Removes the Office Teams registry value, effectively enabling it since that is the default.
-Version	Outputs the current version of the script.
-Help	Displays the full help information for the script.
-CheckForUpdate	Checks for updates to the script on GitHub.
-Debug	Debug information is natively supported with additional information presented if used.

Contributing

If you'd like to help develop this project: fork the repo, edit, then submit a pull request. 😊

uninstallteams's Issues

no uninstall from C:\Program Files (x86)\Microsoft\Teams\current

I installed it using chocolatey:
choco install microsoft-teams.install -y --params '/AllUser /NoAutoStart'

Then teams got installed in "C:\Program Files (x86)\Microsoft\Teams\current"
The uninstaller finds it there and it runs but it doens't do anything and it stays installed. Am I missing something?

I also have this key in the registry:
Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Run :
Teams REG_SZ value: "C:\Program Files (x86)\Microsoft\Teams\Update.exe" --processStart "Teams.exe" --allUsers --process-start-args "--system-initiated"

I think it has something to do with :
https://learn.microsoft.com/en-us/microsoftteams/msi-deployment

Does not remove the Windows 11 shortcut.

Using Win + C will still open this pop-up:

UninstallWidgets.ps1

I used UninstallTeams and UninstallOneDriver , all works really well, and i am appreciate your scripts.

A lot of people don't need windows with fancy functions like Microsoft Teams, OneDriver also Widget.
It is possible to remove embedded Widget using a script like UninstallTeams.ps1 ?
It would benefit a lot of people to make Windows cleaner.