Office Admin Explorer

Prevent Microsoft Teams from starting automatically after installation

Registry value
preventfirstlaunchafterinstall
Group PolicyPrevent Microsoft Teams from starting automatically after installation
German versionMicrosoft Teams am automatischen Starten nach der Installation hindern
Intune settings catalogPrevent Microsoft Teams from starting automatically after installation (User)
ScopeUser · HKCU
ADMXTeams.admx · Teams_PreventFirstLaunchAfterInstall_Policy
Open in the interactive explorer+ Add to my collection

Group Policy path

User Configuration\Policies\Administrative Templates\Microsoft Teams

Registry

ValueData
HKCU\Software\policies\microsoft\office\16.0\teams
preventfirstlaunchafterinstallEnabled = 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 typeString
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

All policies in this category · All 2 policies of Teams.admx