다음을 통해 공유


WebAppInstallForceList

강제 설치된 Web Apps 목록 구성

지원되는 버전

  • Windows 및 MacOS (80 이상)

설명

정책을 설정하면 사용자 상호 작용 없이 자동으로 설치되는 웹앱 목록이 지정됩니다. 사용자는 정책을 해제하거나 이러한 웹앱을 제거할 수 없습니다.

정책의 각 목록 항목은 필수 구성원이 있는 개체입니다. URL(설치할 웹 앱의 URL)

및 6개 선택적 구성원:

  • default_launch_container(웹앱이 열리는 방식의 경우 새 탭이 기본값임)

  • create_desktop_shortcut(Linux 및 Microsoft Windows 데스크톱 바로 가기를 만들려면 true입니다.)

  • fallback_app_name(Microsoft Edge 버전 90부터는 PWA(Progressive Web App)가 아닌 경우 앱 이름을 재정의하거나, PWA이지만 설치를 완료하기 전에 인증이 필요한 경우 임시로 설치된 앱 이름을 재정의할 수 있습니다.) 둘 다의 custom_name fallback_app_name이 제공된 경우 후자는 무시됩니다.)

  • custom_name(모든 데스크톱 플랫폼에서 Microsoft Edge 버전 112부터 모든 웹앱 및 PWA의 앱 이름을 영구적으로 재정의할 수 있습니다.)

  • custom_icon(모든 데스크톱 플랫폼에서 Microsoft Edge 버전 112부터 설치된 앱의 앱 아이콘을 재정의할 수 있습니다. 아이콘은 정사각형, 최대 1MB 크기여야 하며 jpeg, png, gif, webp, ico 형식 중 하나여야 합니다. 해시 값은 아이콘 파일의 SHA256 해시여야 합니다. 앱 설치 시 아이콘을 사용할 수 있도록 인증 없이 URL에 액세스할 수 있어야 합니다.)

  • install_as_shortcut(Microsoft Edge 버전 107부터 시작). 사용하도록 설정하면 지정된 URL이 데스크톱 브라우저 GUI의 "바로 가기 만들기..." 옵션을 통해 수행되는 것처럼 바로 가기로 설치됩니다. 바로 가기로 설치되면 URL의 매니페스트가 변경되면 업데이트되지 않습니다. 사용하지 않도록 설정되거나 설정되지 않은 경우 지정된 URL의 웹앱이 정상적으로 설치됩니다. (현재 Microsoft Edge에서는 지원되지 않습니다.)

지원되는 기능

  • 필수 사항: 예
  • 권장 사항: 아니요
  • 동적 정책 새로 고침: 예
  • 프로필별: 예
  • Microsoft 계정으로 로그인한 프로필에 적용: 아니요

데이터 형식

  • Dictionary

Windows 정보 및 설정

그룹 정책(ADMX) 정보

  • GP 고유 이름: WebAppInstallForceList
  • GP 이름: 강제 설치된 웹 앱 목록 구성
  • GP 경로(필수): 관리 템플릿/Microsoft Edge
  • GP 경로 (권장): 해당 없음
  • 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\정책\Microsoft\Edge
  • 경로 (권장): 해당 없음
  • 값 이름: 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>

참고 항목