Prevent Microsoft Teams from starting automatically after installation
| Registry value | preventfirstlaunchafterinstall |
| Group Policy | Prevent Microsoft Teams from starting automatically after installation |
| German version | Microsoft Teams am automatischen Starten nach der Installation hindern |
| Intune settings catalog | Prevent Microsoft Teams from starting automatically after installation (User) |
| Scope | User · HKCU |
| ADMX | Teams.admx · Teams_PreventFirstLaunchAfterInstall_Policy |
Group Policy path
Registry
| Value | Data |
|---|---|
HKCU\Software\policies\microsoft\office\16.0\teams | |
| preventfirstlaunchafterinstall | Enabled = 1 · Disabled = 0 |
Not configured = the value does not exist – the application default applies and users may change the setting.
PowerShell
Check the current value (read-only)
# --- Settings ---
$root = 'HKCU:' # other signed-in user (elevated): 'Registry::HKEY_USERS\<SID>'
$key = "$root\Software\policies\microsoft\office\16.0\teams"
foreach ($name in @('preventfirstlaunchafterinstall')) {
try { '{0} = {1}' -f $name, (Get-ItemPropertyValue -Path $key -Name $name -ErrorAction Stop) }
catch { '{0}: not configured' -f $name }
}Admin rights needed: HKCU\Software\Policies is read-only for standard users. An elevated session writes to the admin's own HKCU – to set it for another signed-in user, change $root to Registry::HKEY_USERS\<SID>.
Enable
# --- Settings ---
$root = 'HKCU:' # other signed-in user (elevated): 'Registry::HKEY_USERS\<SID>'
try {
$key = "$root\Software\policies\microsoft\office\16.0\teams"
if (-not (Test-Path $key)) { New-Item -Path $key -Force -ErrorAction Stop | Out-Null }
New-ItemProperty -Path $key -Name 'preventfirstlaunchafterinstall' -PropertyType DWord -Value 1 -Force -ErrorAction Stop | Out-Null # Enabled
'Done.'
}
catch { Write-Error "Failed: $($_.Exception.Message)" }Disable
# --- Settings ---
$root = 'HKCU:' # other signed-in user (elevated): 'Registry::HKEY_USERS\<SID>'
try {
$key = "$root\Software\policies\microsoft\office\16.0\teams"
if (-not (Test-Path $key)) { New-Item -Path $key -Force -ErrorAction Stop | Out-Null }
New-ItemProperty -Path $key -Name 'preventfirstlaunchafterinstall' -PropertyType DWord -Value 0 -Force -ErrorAction Stop | Out-Null # Disabled
'Done.'
}
catch { Write-Error "Failed: $($_.Exception.Message)" }Reset to Not configured
# --- Settings --- $root = 'HKCU:' # other signed-in user (elevated): 'Registry::HKEY_USERS\<SID>' $key = "$root\Software\policies\microsoft\office\16.0\teams" Remove-ItemProperty -Path $key -Name 'preventfirstlaunchafterinstall' -ErrorAction SilentlyContinue 'Policy values removed (Not configured).'
Intune (settings catalog)
Prevent Microsoft Teams from starting automatically after installation (User)
Settings catalog → Add settings → search for the name above.
Intune Settings Catalog Viewer ↗
Alternative: custom profile (OMA-URI)
| OMA-URI | ./User/Vendor/MSFT/Policy/Config/Teamsv2~Policy~L_Teams/Teams_PreventFirstLaunchAfterInstall_Policy |
| Data type | String |
| Value | <enabled/> · <disabled/> |
Cloud Policy
Cloud Policy (config.office.com → Customization → Policy Management) offers many user policies of the Microsoft 365 Apps – search for Prevent Microsoft Teams from starting automatically after installation. It also applies to unmanaged devices and wins over GPO and Intune for the same setting.
Microsoft 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.
Same category: Microsoft Teams
- Restrict sign in to Teams to accounts in specific tenantsrestrictteamssignintoaccountsfromtenantlist
All policies in this category · All 2 policies of Teams.admx