Prevent Microsoft Teams from starting automatically after installation
Explanation
This policy setting controls whether Microsoft Teams starts automatically when the user logs into a device after Teams is installed.
If you enable this policy setting, Teams does not start automatically when the user logs in to the device and the user has not started Teams previously.
Note: If you enable this policy setting, you must do so before Teams is installed.
Once a user starts Teams for the first time, Teams is configured to start automatically the next time the user logs into the device.
If you disable or don’t configure this policy setting, Teams automatically starts when a user logs in to the device after Teams is installed.
Note: The user can configure Teams not to start automatically by configuring user settings within Teams.
Registry
HKEY_CURRENT_USER\software\policies\microsoft\office\16.0\teams- Value name
preventfirstlaunchafterinstall
| State | Value written |
|---|---|
| Enabled | REG_DWORD = 1 |
| Disabled | REG_DWORD = 0 |
PowerShell
PowerShell commands that write to the registry what the policy would write. Values in angle brackets (<…>) must be replaced.
Writing directly to the registry bypasses Group Policy: if a GPO manages this value, it will be rewritten at the next gpupdate; otherwise the value stays in place (the "tattooing" effect). Prefer a GPO or, locally, LGPO.exe. Run PowerShell as administrator for HKLM. Some policies need a restart or gpupdate /force.
Enable
# Enable: teams16/Teams_PreventFirstLaunchAfterInstall_Policy
$k = 'HKCU:\software\policies\microsoft\office\16.0\teams'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name 'preventfirstlaunchafterinstall' -Value 1 -Type DWordDisable
# Disable: teams16/Teams_PreventFirstLaunchAfterInstall_Policy
$k = 'HKCU:\software\policies\microsoft\office\16.0\teams'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name 'preventfirstlaunchafterinstall' -Value 0 -Type DWordRevert to "Not configured"
# Revert to "Not configured": teams16/Teams_PreventFirstLaunchAfterInstall_Policy
$k = 'HKCU:\software\policies\microsoft\office\16.0\teams'
Remove-ItemProperty -Path $k -Name 'preventfirstlaunchafterinstall' -ErrorAction SilentlyContinueApplication
Microsoft 365 Apps / Office (Microsoft) — November 2026 templates
Official templates downloaded on November 12, 2026.