WebAppInstallForceList

2025-05-09

Настроить список принудительно установленных веб-приложений

Поддерживаемые версии

На Windows и macOS начиная с 80 или позже

Описание

При настройке политики определяется список веб-приложений, которые устанавливаются автоматически без вмешательства пользователя. Пользователи не могут отключить политику или удалить эти веб-приложения.

Каждый элемент списка политики является объектом с обязательным элементом: URL-адрес (URL-адрес веб-приложения для установки)

и 6 необязательных членов:

default_launch_container (для открытия веб-приложения — по умолчанию используется новая вкладка)
create_desktop_shortcut (True, если вы хотите создать ярлыки для рабочего стола Linux и Microsoft Windows).
fallback_app_name (Начиная с Microsoft Edge версии 90, вы можете окончательно переопределить имя приложения, если оно не является прогрессивным веб-приложением (PWA), или временно переопределить имя приложения, если требуется проверка подлинности до завершения установки. Если указаны и custom_name, и fallback_app_name, последнее будет проигнорировано.)
custom_name (начиная с Microsoft Edge версии 112 на всех настольных платформах позволяет постоянно переопределять имя приложения для всех веб-приложений и PWA.)
custom_icon (Начиная с Microsoft Edge версии 112 на всех настольных платформах позволяет переопределить значок приложения установленных приложений. Значки должны быть квадратными, максимальным размером 1 МБ и в одном из следующих форматов: jpeg, png, gif, webp, ico. Хэш-значение должно быть хэшом SHA256 файла значка. URL-адрес должен быть доступен без проверки подлинности, чтобы убедиться, что значок можно использовать при установке приложения.)
install_as_shortcut (начиная с Microsoft Edge версии 107). Если этот параметр включен, указанный URL-адрес будет установлен в качестве ярлыка, как если бы это было сделано с помощью команды "Создать ярлык..." в графическом интерфейсе классического браузера. Обратите внимание, что при установке в качестве ярлыка он не будет обновлен, если манифест в URL-адресе изменится. Если параметр отключен или не задан, веб-приложение по указанному URL-адресу будет установлено в обычном режиме. (В настоящее время это не поддерживается в Microsoft Edge.)

Поддерживаемые функции

Может быть обязательным: Да
Может быть рекомендовано: Нет
Обновление динамической политики: Да
На профиль: Да
Применимо к профилю, вошедшего с помощью учетной записи Майкрософт: Нет

Тип данных

Dictionary

Сведения и параметры Windows

Сведения о групповой политике (ADMX)

Уникальное имя GP: WebAppInstallForceList
Имя GP: Настройка списка принудительно установленных веб-приложений.
Путь к групповой политике (обязательный): административные шаблоны/Microsoft Edge
Путь GP (рекомендуется): N/A
Имя файла GP ADMX: MSEdge.admx

Пример значения

[{"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"}]

Параметры реестра

Путь (обязательный): SOFTWARE\Policies\Microsoft\Edge
Путь (рекомендуется): N/A
Имя значения: WebAppInstallForceList
Тип значения: REG_SZ

Пример значения реестра

[{"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"}]

Развернутый пример значения реестра

[
  {
    "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"
  }
]

Информация о Mac и настройки

Имя ключа предпочтения: WebAppInstallForceList
Пример значения:

<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>

См. также

Microsoft Edge - Политики