### Set Extension Installation Modes
Source: https://learn.microsoft.com/en-us/deployedge/microsoft-edge-manage-extensions-ref-guide?source=recommendations
Examples of using the installation_mode property to control whether users can install extensions, including allowing all, blocking all, or providing custom block messages.
```json
{"*": {"installation_mode": "allowed"}}
```
```json
{"*": {"installation_mode": "blocked"}}
```
```json
{"*": {"blocked_install_message": "Call IT(408 - 555 - 1234) for an exception"}}
```
--------------------------------
### JSON Example for WebAppInstallForceList Policy
Source: https://learn.microsoft.com/en-us/deployedge/microsoft-edge-browser-policies/webappinstallforcelist
This JSON snippet shows an example of the WebAppInstallForceList policy value. It defines an array of objects, where each object represents a web app to be installed. Configurations include options like creating desktop shortcuts, setting default launch containers (window or tab), and specifying fallback application names or custom icons.
```json
[{"create_desktop_shortcut": true, "default_launch_container": "window", "url": "https://www.contoso.com/maps"}, {"default_launch_container": "tab", "url": "https://app.contoso.edu"}, {"default_launch_container": "window", "fallback_app_name": "Editor", "url": "https://app.contoso.edu/editor"}, {"custom_name": "Spreadsheets", "default_launch_container": "window", "install_as_shortcut": true, "url": "https://app.contoso.edu/sheets"}, {"custom_icon": {"hash": "c28f469c450e9ab2b86ea47038d2b324c6ad3b1e9a4bd8960da13214afd0ca38", "url": "https://mydomain.example.com/sunny_icon.png"}, "url": "https://weather.example.com"}]
```
```json
[
{
"create_desktop_shortcut": true,
"default_launch_container": "window",
"url": "https://www.contoso.com/maps"
},
{
"default_launch_container": "tab",
"url": "https://app.contoso.edu"
},
{
"default_launch_container": "window",
"fallback_app_name": "Editor",
"url": "https://app.contoso.edu/editor"
},
{
"custom_name": "Spreadsheets",
"default_launch_container": "window",
"install_as_shortcut": true,
"url": "https://app.contoso.edu/sheets"
},
{
"custom_icon": {
"hash": "c28f469c450e9ab2b86ea47038d2b324c6ad3b1e9a4bd8960da13214afd0ca38",
"url": "https://mydomain.example.com/sunny_icon.png"
},
"url": "https://weather.example.com"
}
]
```
--------------------------------
### Start Microsoft Edge in InPrivate Mode with App Mode
Source: https://learn.microsoft.com/en-us/deployedge/microsoft-edge-known-issues?tabs=Open
This example demonstrates how to start Microsoft Edge in InPrivate mode and application mode using the command line. This is a workaround for an issue where the browser crashes when using these flags together.
```cmd
"C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe" https://www.contoso.com --inprivate
```
--------------------------------
### XML Example for macOS WebAppInstallForceList Policy
Source: https://learn.microsoft.com/en-us/deployedge/microsoft-edge-browser-policies/webappinstallforcelist
This XML snippet demonstrates how to configure the WebAppInstallForceList policy for macOS using the preference key 'WebAppInstallForceList'. It mirrors the JSON structure, defining an array of dictionaries, each specifying web app installation details such as desktop shortcuts, launch containers, and custom icons.
```xml
WebAppInstallForceList
create_desktop_shortcut
default_launch_container
window
url
https://www.contoso.com/maps
default_launch_container
tab
url
https://app.contoso.edu
default_launch_container
window
fallback_app_name
Editor
url
https://app.contoso.edu/editor
custom_name
Spreadsheets
default_launch_container
window
install_as_shortcut
url
https://app.contoso.edu/sheets
custom_icon
hash
c28f469c450e9ab2b86ea47038d2b324c6ad3b1e9a4bd8960da13214afd0ca38
url
https://mydomain.example.com/sunny_icon.png
url
https://weather.example.com
```
--------------------------------
### Configure ExtensionInstallBlocklist via Registry and XML
Source: https://learn.microsoft.com/en-us/deployedge/microsoft-edge-browser-policies/extensioninstallblocklist?source=recommendations
Examples showing how to define blocked extensions using Windows Registry keys and macOS property list (plist) XML format. These configurations identify extensions by their unique IDs to restrict installation.
```Registry
SOFTWARE\Policies\Microsoft\Edge\ExtensionInstallBlocklist\1 = "extension_id1"
SOFTWARE\Policies\Microsoft\Edge\ExtensionInstallBlocklist\2 = "extension_id2"
```
```XML
extension_id1
extension_id2
```
--------------------------------
### Block Command Line Extension Installs (Windows Group Policy)
Source: https://learn.microsoft.com/en-us/deployedge/microsoft-edge-browser-policies/extensioninstalltypeblocklist
This example demonstrates how to configure the ExtensionInstallTypeBlocklist policy using Group Policy on Windows to block extensions from being loaded via the command line. This is useful for enhancing security by preventing unauthorized extension installations.
```plaintext
Blocks extensions from being loaded from command line
```
--------------------------------
### Force-install Web Apps using JSON configuration
Source: https://learn.microsoft.com/en-us/deployedge/microsoft-edge-browser-policies/webappinstallforcelist
This configuration defines a list of web applications to be force-installed. Each entry can specify installation options such as creating desktop shortcuts, how the app opens, fallback names, custom names, and custom icons. The 'url' is mandatory for each web app.
```json
[
{
"create_desktop_shortcut": true,
"default_launch_container": "window",
"url": "https://www.contoso.com/maps"
},
{
"default_launch_container": "tab",
"url": "https://app.contoso.edu"
},
{
"default_launch_container": "window",
"fallback_app_name": "Editor",
"url": "https://app.contoso.edu/editor"
},
{
"custom_name": "Spreadsheets",
"default_launch_container": "window",
"install_as_shortcut": true,
"url": "https://app.contoso.edu/sheets"
},
{
"custom_icon": {
"hash": "c28f469c450e9ab2b86ea47038d2b324c6ad3b1e9a4bd8960da13214afd0ca38",
"url": "https://mydomain.example.com/sunny_icon.png"
},
"url": "https://weather.example.com"
}
]
```
--------------------------------
### Set Relaunch Window for Microsoft Edge (Group Policy)
Source: https://learn.microsoft.com/en-us/deployedge/microsoft-edge-browser-policies/relaunchwindow?source=recommendations
This example shows how to configure the RelaunchWindow policy using Group Policy Editor. It specifies a 240-minute duration starting at 2:15 AM for the relaunch notification period.
```json
{"entries": [{"duration_mins": 240, "start": {"hour": 2, "minute": 15}}]}
```
--------------------------------
### OMA-URI Path Examples for Recommended Policies
Source: https://learn.microsoft.com/en-us/deployedge/configure-edge-with-mdm
Provides examples of OMA-URI paths for various recommended policies in Microsoft Edge.
```APIDOC
## OMA-URI Path Examples for Recommended Policies
### Description
This table shows examples of OMA-URI paths for recommended policies in Microsoft Edge.
### Method
N/A (Informational)
### Endpoint
N/A (Informational)
### Parameters
N/A
### Request Example
N/A
### Response
#### Success Response (N/A)
N/A
#### Response Example
| Policy | OMA-URI |
|--------------------------|-----------------------------------------------------------------------------------------------------------|
| RegisteredProtocolHandlers | `./Device/Vendor/MSFT/Policy/Config/Edge~Policy~microsoft_edge_recommended~ContentSettings_recommended/RegisteredProtocolHandlers_recommended` |
| PasswordManagerEnabled | `./Device/Vendor/MSFT/Policy/Config/Edge~Policy~microsoft_edge_recommended~PasswordManager_recommended/PasswordManagerEnabled_recommended` |
| PrintHeaderFooter | `./Device/Vendor/MSFT/Policy/Config/Edge~Policy~microsoft_edge_recommended~Printing_recommended/PrintHeaderFooter_recommended` |
| SmartScreenEnabled | `./Device/Vendor/MSFT/Policy/Config/Edge~Policy~microsoft_edge_recommended~SmartScreen_recommended/SmartScreenEnabled_recommended` |
| HomePageLocation | `./Device/Vendor/MSFT/Policy/Config/Edge~Policy~microsoft_edge_recommended~Startup_recommended/HomepageLocation_recommended` |
| ShowHomeButton | `./Device/Vendor/MSFT/Policy/Config/Edge~Policy~microsoft_edge_recommended~Startup_recommended/ShowHomeButton_recommended` |
| FavoritesBarEnabled | `./Device/Vendor/MSFT/Policy/Config/Edge~Policy~microsoft_edge_recommended~/FavoritesBarEnabled_recommended` |
```
--------------------------------
### Expanded Relaunch Window Configuration (Registry)
Source: https://learn.microsoft.com/en-us/deployedge/microsoft-edge-browser-policies/relaunchwindow?source=recommendations
This expanded example shows the detailed JSON structure for the RelaunchWindow registry value. It clearly defines the array of entries, each with a duration in minutes and a start time specified by hour and minute.
```json
{
"entries": [
{
"duration_mins": 240,
"start": {
"hour": 2,
"minute": 15
}
}
]
}
```
--------------------------------
### Configure ExperimentationAndConfigurationServiceControl via Registry and Configuration Files
Source: https://learn.microsoft.com/en-us/deployedge/microsoft-edge-browser-policies/experimentationandconfigurationservicecontrol
Examples of how to set the ExperimentationAndConfigurationServiceControl policy across different platforms using Registry keys, XML preference files, and integer values.
```Registry
Windows Registry Path: SOFTWARE\Policies\Microsoft\Edge
Value Name: ExperimentationAndConfigurationServiceControl
Value Type: REG_DWORD
Example Value: 0x00000002
```
```XML
2
```
```Text
2
```
--------------------------------
### Manage Search Engines Policy Example (JSON)
Source: https://learn.microsoft.com/en-us/deployedge/microsoft-edge-browser-policies/managedsearchengines
This JSON structure demonstrates how to configure the ManagedSearchEngines policy. It includes settings for search engine discovery, default search engine, keywords, search URLs, suggest URLs, image search URLs, and image search POST parameters. Note that some parameters like 'encoding' are optional starting from Edge 80, and 'allow_search_engine_discovery' is optional starting from Edge 83.
```json
[{"allow_search_engine_discovery": true}, {"is_default": true, "keyword": "example1.com", "name": "Example1", "search_url": "https://www.example1.com/search?q={searchTerms}", "suggest_url": "https://www.example1.com/qbox?query={searchTerms}"}, {"image_search_post_params": "content={imageThumbnail},url={imageURL},sbisrc={SearchSource}", "image_search_url": "https://www.example2.com/images/detail/search?iss=sbiupload", "keyword": "example2.com", "name": "Example2", "search_url": "https://www.example2.com/search?q={searchTerms}", "suggest_url": "https://www.example2.com/qbox?query={searchTerms}"}, {"encoding": "UTF-8", "image_search_url": "https://www.example3.com/images/detail/search?iss=sbiupload", "keyword": "example3.com", "name": "Example3", "search_url": "https://www.example3.com/search?q={searchTerms}", "suggest_url": "https://www.example3.com/qbox?query={searchTerms}"}, {"keyword": "example4.com", "name": "Example4", "search_url": "https://www.example4.com/search?q={searchTerms}"}]
```