Microsoft Edge Update › Microsoft Edge WebView2 Runtime
Allow installation
Supported on Microsoft Edge Update 1.3.127.1 and later
What it does
Lets you specify whether the WebView2 Runtime can be installed using Microsoft Edge Update. If you enable (1) this policy, users can install the WebView2 Runtime through Microsoft Edge Update. If you disable (0) this policy (or set it to 'Installs disabled'), users cannot install the WebView2 Runtime through Microsoft Edge Update. If you set this policy to Always allow Machine-Wide Installs but not Per-User Installs (4), the WebView2 Runtime will only be deployed machine-wide. If you set the policy to Force Installs (Machine-Wide) (5), users can install the WebView2 Runtime to all machines where Microsoft Edge Update is pre-installed. Requires Microsoft Edge Update 1.3.155.43 or higher. If you don't configure this policy, the WebView2 Runtime will be installed through Microsoft Edge Update.
What it writes
- Hive
- HKEY_LOCAL_MACHINE
- Registry key
Software\Policies\Microsoft\EdgeUpdate
Options
| Option | Type | Registry value | Allowed values |
|---|---|---|---|
| Install PolicyRequiredDefault: Always allow Installs (recommended) | Drop-down list | Install{F3017226-FE2A-4295-8BDF-00C3A9A7E4C5} |
|
Configure and deploy
Choose a state and the option values; the output below is generated from the template for exactly that.
Enabled · Computer · template defaults
Registry file (.reg)
Windows Registry Editor Version 5.00
[HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\EdgeUpdate]
"Install{F3017226-FE2A-4295-8BDF-00C3A9A7E4C5}"=dword:00000001
PowerShell
$ErrorActionPreference = 'Stop'
function Set-RegistryValue {
param(
[Parameter(Mandatory = $true)][string] $Path,
[Parameter(Mandatory = $true)][string] $Name,
[Parameter(Mandatory = $true)][string] $PropertyType,
[Parameter(Mandatory = $true)][object] $Value
)
if (-not (Test-Path -LiteralPath $Path)) {
New-Item -Path $Path -Force | Out-Null
}
New-ItemProperty -LiteralPath $Path -Name $Name -PropertyType $PropertyType -Value $Value -Force | Out-Null
}
function Remove-RegistryValue {
param(
[Parameter(Mandatory = $true)][string] $Path,
[Parameter(Mandatory = $true)][string] $Name
)
if (Test-Path -LiteralPath $Path) {
Remove-ItemProperty -LiteralPath $Path -Name $Name -Force -ErrorAction SilentlyContinue
}
}
function Clear-RegistryKeyValues {
param(
[Parameter(Mandatory = $true)][string] $Path
)
if (-not (Test-Path -LiteralPath $Path)) {
return
}
foreach ($propertyName in (Get-Item -LiteralPath $Path).Property) {
Remove-ItemProperty -LiteralPath $Path -Name $propertyName -Force -ErrorAction SilentlyContinue
}
}
# Policy: Allow installation
# Name: Pol_AllowInstallationMicrosoftEdgeWebView
# Scope: Machine
# State: Enabled
# Source: msedgeupdate.admx
Set-RegistryValue -Path 'Registry::HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\EdgeUpdate' -Name 'Install{F3017226-FE2A-4295-8BDF-00C3A9A7E4C5}' -PropertyType 'DWord' -Value 1
- The OMA-URI is an inferred ADMX-backed Policy CSP candidate derived from the source ADMX file name and policy name.
- Some Microsoft policies use built-in Policy CSP pages whose area names don't match the ADMX file name, so verify the candidate against Microsoft Learn before deployment.
ADMX profile candidate (OMA-URI)
./Device/Vendor/MSFT/Policy/Config/ADMX_msedgeupdate/Pol_AllowInstallationMicrosoftEdgeWebViewADMX SyncML candidate
<SyncML xmlns="SYNCML:SYNCML1.2">
<SyncBody>
<Replace>
<CmdID>1</CmdID>
<Item>
<Meta>
<Format>chr</Format>
<Type>text/plain</Type>
</Meta>
<Target>
<LocURI>./Device/Vendor/MSFT/Policy/Config/ADMX_msedgeupdate/Pol_AllowInstallationMicrosoftEdgeWebView</LocURI>
</Target>
<Data><enabled/>
<data id="Part_InstallPolicy" value="0"/></Data>
</Item>
</Replace>
<Final/>
</SyncBody>
</SyncML>Intune remediation scripts
Detection
$ErrorActionPreference = 'Stop'
$reasons = [System.Collections.Generic.List[string]]::new()
function Test-RegistryValueExists {
param(
[Parameter(Mandatory = $true)][string] $Path,
[Parameter(Mandatory = $true)][string] $Name
)
if (-not (Test-Path -LiteralPath $Path)) {
return $false
}
return $null -ne (Get-ItemProperty -LiteralPath $Path -Name $Name -ErrorAction SilentlyContinue)
}
function Test-RegistryValueEquals {
param(
[Parameter(Mandatory = $true)][string] $Path,
[Parameter(Mandatory = $true)][string] $Name,
[Parameter(Mandatory = $true)][string] $Kind,
[Parameter(Mandatory = $true)][object] $Expected
)
if (-not (Test-Path -LiteralPath $Path)) {
return $false
}
$valueObject = Get-ItemProperty -LiteralPath $Path -Name $Name -ErrorAction SilentlyContinue
if ($null -eq $valueObject) {
return $false
}
$actual = $valueObject.$Name
switch ($Kind) {
'String' { return [string]$actual -ceq [string]$Expected }
'ExpandString' { return [string]$actual -ceq [string]$Expected }
'DWord' { return [uint32]$actual -eq [uint32]$Expected }
'QWord' { return [uint64]$actual -eq [uint64]$Expected }
'MultiString' {
$actualArray = @($actual)
$expectedArray = @($Expected)
if ($actualArray.Count -ne $expectedArray.Count) { return $false }
for ($index = 0; $index -lt $actualArray.Count; $index++) {
if ([string]$actualArray[$index] -cne [string]$expectedArray[$index]) { return $false }
}
return $true
}
'Binary' {
$actualArray = [byte[]]$actual
$expectedArray = [byte[]]$Expected
if ($actualArray.Length -ne $expectedArray.Length) { return $false }
for ($index = 0; $index -lt $actualArray.Length; $index++) {
if ($actualArray[$index] -ne $expectedArray[$index]) { return $false }
}
return $true
}
default { return [string]$actual -ceq [string]$Expected }
}
}
# Policy: Allow installation
# Name: Pol_AllowInstallationMicrosoftEdgeWebView
# Scope: Machine
# State: Enabled
# Source: msedgeupdate.admx
$isMatch = Test-RegistryValueEquals -Path 'Registry::HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\EdgeUpdate' -Name 'Install{F3017226-FE2A-4295-8BDF-00C3A9A7E4C5}' -Kind 'DWord' -Expected 1
if (-not $isMatch) {
$reasons.Add('Value mismatch: HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\EdgeUpdate\Install{F3017226-FE2A-4295-8BDF-00C3A9A7E4C5}') | Out-Null
}
if ($reasons.Count -eq 0) {
Write-Output 'Compliant'
exit 0
}
$reasons | ForEach-Object { Write-Output $_ }
exit 1
Remediation
$ErrorActionPreference = 'Stop'
function Set-RegistryValue {
param(
[Parameter(Mandatory = $true)][string] $Path,
[Parameter(Mandatory = $true)][string] $Name,
[Parameter(Mandatory = $true)][string] $PropertyType,
[Parameter(Mandatory = $true)][object] $Value
)
if (-not (Test-Path -LiteralPath $Path)) {
New-Item -Path $Path -Force | Out-Null
}
New-ItemProperty -LiteralPath $Path -Name $Name -PropertyType $PropertyType -Value $Value -Force | Out-Null
}
function Remove-RegistryValue {
param(
[Parameter(Mandatory = $true)][string] $Path,
[Parameter(Mandatory = $true)][string] $Name
)
if (Test-Path -LiteralPath $Path) {
Remove-ItemProperty -LiteralPath $Path -Name $Name -Force -ErrorAction SilentlyContinue
}
}
function Clear-RegistryKeyValues {
param(
[Parameter(Mandatory = $true)][string] $Path
)
if (-not (Test-Path -LiteralPath $Path)) {
return
}
foreach ($propertyName in (Get-Item -LiteralPath $Path).Property) {
Remove-ItemProperty -LiteralPath $Path -Name $propertyName -Force -ErrorAction SilentlyContinue
}
}
# Policy: Allow installation
# Name: Pol_AllowInstallationMicrosoftEdgeWebView
# Scope: Machine
# State: Enabled
# Source: msedgeupdate.admx
Set-RegistryValue -Path 'Registry::HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\EdgeUpdate' -Name 'Install{F3017226-FE2A-4295-8BDF-00C3A9A7E4C5}' -PropertyType 'DWord' -Value 1
History 37 retained releases
- 150.0.4078.8016 Jul 2026
- Already present in the first release ChangeIntel keeps.
36 later releases left it unchanged.
Template
- Internal name
Pol_AllowInstallationMicrosoftEdgeWebView- Namespace
Microsoft.Policies.Update- Template file
msedgeupdate.admx- Release
- Microsoft Edge 155.0.4283.62 · file set
0a733b0040dbbf02…
Definition, editor controls and support
Definition
<policy class="Machine" displayName="$(string.Pol_AllowInstallation)" explainText="$(string.Explain_WebView_Install)" key="Software\Policies\Microsoft\EdgeUpdate" name="Pol_AllowInstallationMicrosoftEdgeWebView" presentation="$(presentation.Pol_AllowInstallation)" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions">
<parentCategory ref="Microsoft.Policies.Update:Cat_WebView" />
<supportedOn ref="Microsoft.Policies.Update:Sup_EdgeUpdate1_3_127_1" />
<elements>
<enum id="Part_InstallPolicy" required="true" valueName="Install{F3017226-FE2A-4295-8BDF-00C3A9A7E4C5}">
<item displayName="$(string.Name_InstallsEnabled)">
<value>
<decimal value="1" />
</value>
</item>
<item displayName="$(string.Name_InstallsDisabled)">
<value>
<decimal value="0" />
</value>
</item>
<item displayName="$(string.Name_ForceInstallsMachine)">
<value>
<decimal value="5" />
</value>
</item>
<item displayName="$(string.Name_InstallsEnabledMachineOnly)">
<value>
<decimal value="4" />
</value>
</item>
</enum>
</elements>
</policy>Editor controls
<presentation id="Pol_AllowInstallation" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions">
<dropdownList defaultItem="0" refId="Part_InstallPolicy">Install Policy</dropdownList>
</presentation>Supported platforms and category
Microsoft.Policies.Update:category:Cat_EdgeUpdate
<category displayName="$(string.Cat_GoogleUpdate)" explainText="$(string.Explain_GoogleUpdate)" name="Cat_EdgeUpdate" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions">
</category>
Microsoft.Policies.Update:category:Cat_WebView
<category displayName="$(string.Cat_WebView)" explainText="$(string.Explain_WebView)" name="Cat_WebView" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions">
<parentCategory ref="Microsoft.Policies.Update:Cat_EdgeUpdate" />
</category>
Microsoft.Policies.Update:definition:Sup_EdgeUpdate1_3_127_1
<definition displayName="$(string.Sup_EdgeUpdate1_3_127_1)" name="Sup_EdgeUpdate1_3_127_1" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions" />
Microsoft.Policies.Update:category:Cat_EdgeUpdate
<category displayName="$(string.Cat_GoogleUpdate)" explainText="$(string.Explain_GoogleUpdate)" name="Cat_EdgeUpdate" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions">
</category>
<strings><string id="Microsoft.Policies.Update:Cat_GoogleUpdate">Microsoft Edge Update</string><string id="Microsoft.Policies.Update:Explain_GoogleUpdate">Policies to control the installation and updating of Microsoft Edge using Microsoft Edge Update.</string></strings>
Microsoft.Policies.Update:category:Cat_WebView
<category displayName="$(string.Cat_WebView)" explainText="$(string.Explain_WebView)" name="Cat_WebView" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions">
<parentCategory ref="Microsoft.Policies.Update:Cat_EdgeUpdate" />
</category>
<strings><string id="Microsoft.Policies.Update:Cat_WebView">Microsoft Edge WebView2 Runtime</string><string id="Microsoft.Policies.Update:Explain_WebView">Specfies policies for the WebView2 Runtime.</string></strings>
Microsoft.Policies.Update:definition:Sup_EdgeUpdate1_3_127_1
<definition displayName="$(string.Sup_EdgeUpdate1_3_127_1)" name="Sup_EdgeUpdate1_3_127_1" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions" />
<strings><string id="Microsoft.Policies.Update:Sup_EdgeUpdate1_3_127_1">Microsoft Edge Update 1.3.127.1 and later</string></strings>