Microsoft Edge Deployment Guide

https://learn.microsoft.com/en-us/deployedge/
Admin
Documentation for deploying, configuring, and managing Microsoft Edge in enterprise environments...
Tokens:547,811
Snippets:9,784
Trust Score:10
Update:3 months ago
Show doc for...
Tokens:
Raw
### Force Install Extensions (macOS XML Example)

Source: https://learn.microsoft.com/en-us/deployedge/microsoft-edge-policies/extensioninstallforcelist

This XML example shows how to configure multiple extensions for force installation on macOS. Each extension is listed as a string containing its ID and source URL.

```xml
<array>
  <string>gbchcmhmhahfdphkhkmpfmihenigjmpp;https://edge.microsoft.com/extensionwebstorebase/v1/crx</string>
  <string>abcdefghijklmnopabcdefghijklmnop</string>
</array>
```

--------------------------------

### Force Install Extension (Group Policy Example)

Source: https://learn.microsoft.com/en-us/deployedge/microsoft-edge-policies/extensioninstallforcelist

This example shows the format for a single extension to be force-installed via Group Policy. It includes the extension ID and its source URL.

```text
gbchcmhmhahfdphkhkmpfmihenigjmpp;https://edge.microsoft.com/extensionwebstorebase/v1/crx
```

--------------------------------

### RelaunchWindow Policy Example (XML)

Source: https://learn.microsoft.com/en-us/deployedge/microsoft-edge-policies/relaunchwindow

This XML example configures the RelaunchWindow policy for macOS. It sets a 240-minute relaunch notification window starting at 2:15 AM.

```xml
<key>RelaunchWindow</key>
<dict>
  <key>entries</key>
  <array>
    <dict>
      <key>duration_mins</key>
      <integer>240</integer>
      <key>start</key>
      <dict>
        <key>hour</key>
        <integer>2</integer>
        <key>minute</key>
        <integer>15</integer>
      </dict>
    </dict>
  </array>
</dict>
```

--------------------------------

### Example: Allowed Extension Type (Hosted App)

Source: https://learn.microsoft.com/en-us/deployedge/microsoft-edge-policies/extensionallowedtypes

This example shows how to configure the policy to allow only hosted apps. This setting restricts installations to only this specific type of extension.

```text
Hosted app
```

--------------------------------

### Starting Microsoft Edge from Command Prompt

Source: https://learn.microsoft.com/en-us/deployedge/microsoft-edge-relnote-archive-stable-channel

This example shows how to start Microsoft Edge from a command prompt window, navigating to the application directory first. This is useful for scripting or automated tasks.

```batch
cmd /K cd /d %ProgramFiles(x86)%\Microsoft\Edge\Application && start msedge <url>
```

--------------------------------

### Configure Extension Install Sources (Registry)

Source: https://learn.microsoft.com/en-us/deployedge/microsoft-edge-policies/extensioninstallsources

Configure extension and user script install sources by setting registry values. Each value corresponds to a URL pattern that allows extension installations.

```powershell
SOFTWARE\Policies\Microsoft\Edge\ExtensionInstallSources\1 = "https://corp.contoso.com/*"
```

--------------------------------

### Specify Installation Program Command Line

Source: https://learn.microsoft.com/en-us/deployedge/deploy-edge-with-configuration-manager

Use the 'Installation program' field to specify the full command line for installing the application. You can add custom properties like '/q' for an unattended installation.

```powershell
msiexec /i "MicrosoftEdgeDevEnterpriseX64.msi" /q
```

--------------------------------

### macOS Configuration Example

Source: https://learn.microsoft.com/en-us/deployedge/microsoft-edge-policies/customhelplink

Example value for the CustomHelpLink preference key on macOS.

```xml
<string>https://go.microsoft.com/fwlink/?linkid=2080734</string>
```

--------------------------------

### Suppress Desktop Icon Creation During MSI Install

Source: https://learn.microsoft.com/en-us/deployedge/microsoft-edge-relnote-archive-stable-channel

Use this MSI command-line parameter to prevent the creation of a desktop icon when installing Microsoft Edge.

```bash
MicrosoftEdgeEnterpriseX64.msi DONOTCREATEDESKTOPSHORTCUT=true
```

--------------------------------

### Check Microsoft Edge Installation Level

Source: https://learn.microsoft.com/en-us/deployedge/edge-ie-mode-faq

Navigate to 'edge://version' and check the 'Executable path' to determine if Microsoft Edge is installed at the system level (starts with 'C:\Program Files') or user level (starts with 'C:\Users').

```text
edge://version
```

--------------------------------

### Example Value for RestoreOnStartupURLs (Mac)

Source: https://learn.microsoft.com/en-us/deployedge/microsoft-edge-policies/restoreonstartupurls

This XML example demonstrates how to configure multiple URLs for the RestoreOnStartupURLs policy on macOS.

```xml
<array>
  <string>https://contoso.com</string>
  <string>https://www.fabrikam.com</string>
</array>
```

--------------------------------

### Example File Type for Auto-Opening (Group Policy)

Source: https://learn.microsoft.com/en-us/deployedge/microsoft-edge-policies/autoopenfiletypes

This example shows how to configure a single file type, 'exe', to be automatically opened on download using Group Policy.

```text
exe
```

--------------------------------

### Example Policy Value for Windows Group Policy

Source: https://learn.microsoft.com/en-us/deployedge/microsoft-edge-policies/defaultthirdpartystoragepartitioningsetting

This example shows how to configure the DefaultThirdPartyStoragePartitioningSetting policy to allow third-party storage partitioning by default using Group Policy.

```text
Allow third-party storage partitioning by default.

```

--------------------------------

### Example Policy Value for Windows Group Policy

Source: https://learn.microsoft.com/en-us/deployedge/microsoft-edge-browser-policies/defaultthirdpartystoragepartitioningsetting

This example shows how to set the policy to allow third-party storage partitioning by default using Group Policy.

```text
Allow third-party storage partitioning by default.
```

--------------------------------

### Expanded RelaunchWindow Registry Value Example

Source: https://learn.microsoft.com/en-us/deployedge/microsoft-edge-policies/relaunchwindow

An expanded JSON representation of the RelaunchWindow registry value, detailing the duration and start time for the relaunch notification window. This configuration sets the window to start at 2:15 AM and last for 240 minutes.

```json
{
  "entries": [
    {
      "duration_mins": 240,
      "start": {
        "hour": 2,
        "minute": 15
      }
    }
  ]
}
```

--------------------------------

### Configure Extension Management Settings

Source: https://learn.microsoft.com/en-us/deployedge/microsoft-edge-browser-policies/extensionsettings

This JSON example demonstrates how to configure various settings for managing extensions in Microsoft Edge, including allowed types, blocked permissions, installation sources, and installation modes for both wildcard and specific extension IDs.

```json
{
"*": {"allowed_types": ["hosted_app"], "blocked_install_message": "Custom error message.", "blocked_permissions": ["downloads", "bookmarks"], "install_sources": ["https://company-intranet/apps"], "installation_mode": "blocked", "runtime_allowed_hosts": ["*://good.contoso.com"], "runtime_blocked_hosts": ["*://*.contoso.com"]},
"abcdefghijklmnopabcdefghijklmnop": {"blocked_permissions": ["history"], "file_url_navigation_allowed": true, "installation_mode": "allowed", "minimum_version_required": "1.0.1"},
"bcdefghijklmnopabcdefghijklmnopa": {"allowed_permissions": ["downloads"], "installation_mode": "force_installed", "override_update_url": true, "runtime_allowed_hosts": ["*://good.contoso.com"], "runtime_blocked_hosts": ["*://*.contoso.com"], "sidebar_auto_open_blocked": true, "toolbar_state": "force_shown", "update_url": "https://contoso.com/update_url"},
"cdefghijklmnopabcdefghijklmnopab": {"blocked_install_message": "Custom error message.", "installation_mode": "blocked"},
"defghijklmnopabcdefghijklmnopabc,efghijklmnopabcdefghijklmnopabcd": {"blocked_install_message": "Custom error message.", "installation_mode": "blocked"},
"fghijklmnopabcdefghijklmnopabcde": {"blocked_install_message": "Custom removal message.", "installation_mode": "removed"},
"update_url:https://www.contoso.com/update.xml": {"allowed_permissions": ["downloads"], "blocked_permissions": ["wallpaper"], "installation_mode": "allowed"}
}
```

--------------------------------

### Example Registry Value for ExtensionSettings

Source: https://learn.microsoft.com/en-us/deployedge/microsoft-edge-browser-policies/extensionsettings

This is a compact JSON representation of the ExtensionSettings registry value. It demonstrates various configurations for extensions, including installation modes, permissions, and host restrictions.

```json
{"*": {"allowed_types": ["hosted_app"], "blocked_install_message": "Custom error message.", "blocked_permissions": ["downloads", "bookmarks"], "install_sources": ["https://company-intranet/apps"], "installation_mode": "blocked", "runtime_allowed_hosts": ["*://good.contoso.com"], "runtime_blocked_hosts": ["*://*.contoso.com"]}, "abcdefghijklmnopabcdefghijklmnop": {"blocked_permissions": ["history"], "file_url_navigation_allowed": true, "installation_mode": "allowed", "minimum_version_required": "1.0.1"}, "bcdefghijklmnopabcdefghijklmnopa": {"allowed_permissions": ["downloads"], "installation_mode": "force_installed", "override_update_url": true, "runtime_allowed_hosts": ["*://good.contoso.com"], "runtime_blocked_hosts": ["*://*.contoso.com"], "sidebar_auto_open_blocked": true, "toolbar_state": "force_shown", "update_url": "https://contoso.com/update_url"}, "cdefghijklmnopabcdefghijklmnopab": {"blocked_install_message": "Custom error message.", "installation_mode": "blocked"}, "defghijklmnopabcdefghijklmnopabc,efghijklmnopabcdefghijklmnopabcd": {"blocked_install_message": "Custom error message.", "installation_mode": "blocked"}, "fghijklmnopabcdefghijklmnopabcde": {"blocked_install_message": "Custom removal message.", "installation_mode": "removed"}, "update_url:https://www.contoso.com/update.xml": {"allowed_permissions": ["downloads"], "blocked_permissions": ["wallpaper"], "installation_mode": "allowed"}}
```

--------------------------------

### Example File Type for Auto-Opening (Group Policy)

Source: https://learn.microsoft.com/en-us/deployedge/microsoft-edge-policies/autoopenfiletypes

This example shows how to configure a single file type, 'txt', to be automatically opened on download using Group Policy.

```text
txt
```

--------------------------------

### WebAppInstallForceList Policy Configuration

Source: https://learn.microsoft.com/en-us/deployedge/microsoft-edge-policies/webappinstallforcelist

This XML snippet demonstrates how to configure the WebAppInstallForceList policy. It includes examples of forcing web app installations with options for desktop shortcuts, default launch containers, custom names, and custom icons.

```XML
<key>WebAppInstallForceList</key>
<array>
  <dict>
    <key>create_desktop_shortcut</key>
    <true/>
    <key>default_launch_container</key>
    <string>window</string>
    <key>url</key>
    <string>https://www.contoso.com/maps</string>
  </dict>
  <dict>
    <key>default_launch_container</key>
    <string>tab</string>
    <key>url</key>
    <string>https://app.contoso.edu</string>
  </dict>
  <dict>
    <key>default_launch_container</key>
    <string>window</string>
    <key>fallback_app_name</key>
    <string>Editor</string>
    <key>url</key>
    <string>https://app.contoso.edu/editor</string>
  </dict>
  <dict>
    <key>custom_name</key>
    <string>Spreadsheets</string>
    <key>default_launch_container</key>
    <string>window</string>
    <key>install_as_shortcut</key>
    <true/>
    <key>url</key>
    <string>https://app.contoso.edu/sheets</string>
  </dict>
  <dict>
    <key>custom_icon</key>
    <dict>
      <key>hash</key>
      <string>c28f469c450e9ab2b86ea47038d2b324c6ad3b1e9a4bd8960da13214afd0ca38</string>
      <key>url</key>
      <string>https://mydomain.example.com/sunny_icon.png</string>
    </dict>
    <key>url</key>
    <string>https://weather.example.com</string>
  </dict>
</array>
```

--------------------------------

### Windows Registry Example

Source: https://learn.microsoft.com/en-us/deployedge/microsoft-edge-browser-policies/cpuperformancetieroverride

Example registry value for the CpuPerformanceTierOverride policy.

```text
0x00000004
```

--------------------------------

### Example Registry Value

Source: https://learn.microsoft.com/en-us/deployedge/microsoft-edge-policies/extensioninstalltypeblocklist

This is an example registry value for the ExtensionInstallTypeBlocklist policy, specifying 'command_line' to block extensions loaded from the command line.

```text
command_line

```

--------------------------------

### Allow all extensions

Source: https://learn.microsoft.com/en-us/deployedge/microsoft-edge-manage-extensions-ref-guide

Sets the installation mode to 'allowed', enabling users to install any extension. This is the default behavior.

```json
{
  "*": {
    "installation_mode": "allowed"
  }
}
```

--------------------------------

### Example Registry Value

Source: https://learn.microsoft.com/en-us/deployedge/microsoft-edge-browser-policies/preferslowkexalgorithms

This is an example of a REG_SZ value for the PreferSlowKexAlgorithms registry setting.

```powershell
cnsa2

```

--------------------------------

### Block all extensions

Source: https://learn.microsoft.com/en-us/deployedge/microsoft-edge-manage-extensions-ref-guide

Sets the installation mode to 'blocked', preventing users from installing any extensions.

```json
{
  "*": {
    "installation_mode": "blocked"
  }
}
```

--------------------------------

### macOS Configuration Profile Example

Source: https://learn.microsoft.com/en-us/deployedge/microsoft-edge-policies/audiocaptureallowedurls

Example XML value for the AudioCaptureAllowedUrls preference key on macOS, including multiple URL patterns.

```xml
<array>
  <string>https://www.contoso.com/</string>
  <string>https://[*.]contoso.edu/</string>
</array>
```

--------------------------------

### macOS Preference Key Example

Source: https://learn.microsoft.com/en-us/deployedge/microsoft-edge-policies/webrtcudpportrange

Example value for the WebRtcUdpPortRange preference key on macOS.

```xml
<string>10000-11999</string>
```
Tokens:
Raw