Open in the explorer

Prevent Microsoft Teams from starting automatically after installation

Type
User
GPO path
User Configuration › Policies › Administrative Templates › Microsoft Teams
Supported on
At least Windows Server 2008 R2 or Windows 7
ADMX file
teams16.admx
Internal name
teams16/Teams_PreventFirstLaunchAfterInstall_Policy

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
StateValue written
EnabledREG_DWORD = 1
DisabledREG_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 DWord

Disable

# 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 DWord

Revert 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 SilentlyContinue

Application

Microsoft 365 Apps / Office (Microsoft) — November 2026 templates

Official templates downloaded on November 12, 2026.