다음을 통해 공유

UpdateOrchestrator API

  • 아티클

UpdateOrchestrator는 사용자 영향을 염두에 두고 자동 소프트웨어 업데이트를 예약합니다. 이 API를 사용하면 사용자의 현재 영향을 최소화하는 최적의 시간에 업데이트를 실행하기 위해 요구 사항과 함께 다운로드 또는 설치와 같은 작업을 지정할 수 있습니다. 이러한 기능은 특히 컴퓨팅 리소스가 제한되거나 느린 낮은 성능 시스템에 도움이 됩니다.

Windows 20H1에는 OS 업데이트 및 스토어 앱 업데이트에서 채택된 자동 소프트웨어 업데이트 사용 사례에 대한 1세대 솔루션이 포함되어 있으며, 아래 설명된 대로 '사용자 모드' 앱의 선택 업데이트 프로그램 집합에 대해 이 API의 초기 '제한된 액세스' 버전을 노출합니다.

기능

  • 소프트웨어 업데이트 관리자를 동적으로 등록

  • 사용자 부재 중과 같이 최적의 시간 동안 등록된 소프트웨어 업데이트를 호출하여 '사용자 모드 앱'을 업데이트합니다.

  • AC 전원에서 '깨어있는 상태'를 유지하여 사용자 이탈 영향을 더욱 줄일 수 있는 기능이 포함되어 있습니다.

개발자 대상

Important

이 UpdateOrchestrator API는 제한된 액세스 기능의 일부입니다( LimitedAccessFeatures 클래스 참조). 자세한 내용을 보거나 잠금 해제 토큰을 요청하려면 LAF 액세스 토큰 요청 양식을 사용하세요.

Acrobat 판독기용 Adobe 업데이트 프로그램 또는 Valve의 Steam과 같은 Win32 '사용자 모드' 애플리케이션에 대한 백그라운드 소프트웨어 업데이트 프로그램이 이미 있는 경우 UpdateOrchestrator API를 사용합니다. Microsoft Store가 소프트웨어 업데이트에 이 기능을 이미 활용하므로 UWP/Store 애플리케이션에는 이 인터페이스가 필요하지 않습니다.

최상의 고객 환경을 제공하기 위해 이 초기 API 릴리스의 범위는 다음 조건을 충족하는 등록된 업데이트 프로그램의 선택 집합으로 지정됩니다.

  • '사용자 모드' 애플리케이션에 대해서만 업데이트
  • BIOS/펌웨어/디바이스 또는 소프트웨어 드라이버를 포함하지 마세요.
    • 일반적인 품질 기준을 통과하지 못한 BIOS, 펌웨어 또는 디바이스/소프트웨어 드라이버를 업데이트하면 특히 사용자가 없을 때 상당한 위험이 발생합니다.
  • 이 API 사용에 참여하려면 백그라운드 소프트웨어 업데이트 관리자가 감사를 통해 사용자 시스템에서 다운로드하고 설치한 모든 콘텐츠를 보증할 수 있어야 합니다.

제한된 액세스 기능으로 UpdateOrchestrator API의 초기 릴리스는 현재 위의 조건을 충족하는 업데이트 사용자에만 해당합니다.

이 API의 기능을 개선하고 Windows의 여러 자동 소프트웨어 업데이트 프로그램의 영향을 줄이는 것이 목표입니다. 이 간단한 설문 조사를 통해 UpdateOrchestrator API가 개발자의 요구를 더 잘 충족할 수 있는 방법을 이해해 주셔서 감사합니다.

유니버설 오케스트레이터 프레임워크를 통해 OEM 앱 신속 처리

Important

유니버설 오케스트레이터는 일회성 신속 처리한 설치/업데이트를 수행하기 위해 이미징 프로세스 중에 애플리케이션을 등록하는 OEM에 기능을 제공합니다. 이 설치는 사용자가 새 디바이스에 로그인한 후 30분 이내에 발생합니다. 애플리케이션을 신속 처리하면 새 디바이스의 기본 제공 환경에 부정적인 성능 영향을 줄 수 있습니다. 이 기능은 선택한 클라이언트 빌드 및 선택한 지역에서만 사용할 수 있습니다.

요구 사항

신속 처리한 앱 프레임워크에 연결하려면 앱이 다음 요구 사항을 충족해야 합니다.

  • MSIX 형식의 스토어 패키지 앱이어야 합니다.
  • 유효한 PFN(제품군 이름)이 있어야 합니다.

등록

OEM은 신속 처리한 앱에 대한 기존 준비 폴더에 새 키를 작성하여 신속하게 애플리케이션을 등록할 수 있습니다.

HKLM\Software\Microsoft\WindowsUpdate\Orchestrator\UScheduler_OOBE

OEM 제공 등록은 각각 SubKey 형식(이 신속 처리한 앱을 식별하는 데 사용할 고유한 이름) 및 이 애플리케이션에 대한 특정 옵션을 나타내는 레지스트리 값 집합입니다. 각 키의 콘텐츠는 다음과 같은 형식입니다.

키 이름: 이 신속 처리한 앱의 고유 이름

신속 처리한 앱 등록을 위한 하위 키 아래에서 OEM은 다음 두 값을 만들어야 합니다.

  • 값 이름: updaterPriority
    설명: 이 애플리케이션 업데이트의 상대적 우선 순위를 나타내는 숫자
    값 형식: REG_DWORD
    데이터: 1에서 100까지의 숫자 값입니다. 값이 낮을수록 다른 빠른 앱에 대한 상대적 우선 순위가 높음을 나타냅니다.

  • 값 이름: expeditedPayload
    설명: 이 특정 업데이트 관리자에 대한 옵션이 있는 JSON Blob
    값 형식: REG_SZ
    데이터: 이 특정 업데이트 관리자에 대한 옵션이 있는 유효한 JSON Blob을 나타내는 문자열

JSON Blob의 콘텐츠 개요:

State(상태) Type 키 이름 설명
필수 문자열 PFN 앱의 패키지 제품군 이름(예: Microsoft.WindowsStore_8wekyb3d8bbwe)
Required 문자열 엔드포인트 MSIX 패키지를 호스트하는 위치를 가리키는 문자열 URI. 'https'로 시작하는 SSL URI여야 합니다.
선택 사항 Boolean AllowedInOobe 이 신속 처리한 앱이 사용자 OOBE 중에 실행되어야 하는지 여부
선택 사항 숫자 MaxRetryCount 이 업데이트 관리자가 실패 후 다시 시도할 수 있는 횟수입니다. 기본값은 1입니다. 최댓값은 5입니다.
선택 사항 숫자 TimeoutDurationInMinutes 이 업데이트 관리자가 작업을 완료할 때까지 대기하는 기간(분)입니다. 기본값은 15입니다. 최댓값은 30입니다.
선택 사항 배열(문자열) ExcludedRegions 이 앱을 신속하게 처리해서는 안 되는 지역에 대한 문자열의 JSON 배열입니다. 배열의 각 항목은 원하는 지역의 2자 ISO 3166-1 국가 코드에 해당합니다. 예를 들어 ["US"] 지역은 미국의 디바이스에서 이 흐름을 방지합니다.

샘플 JSON 페이로드:

{  
    "PFN": "PFNName",  
    "Endpoint": "SSL_URI",  
    "AllowedInOobe": false,  
    "MaxRetryCount": 3,  
    "TimeoutDurationInMinutes": 15,  
    "ExcludedRegions": ["CN", "FR"]   
}

실행

유니버설 오케스트레이터 프레임워크는 사용자가 새 디바이스에서 데스크탑에 도달한 후 처음 30분 이내에(또는 AllowedInOobe가 true로 설정된 경우 사용자 OOBE 동안) 상대적 우선 순위에 따라 등록된 각 앱을 순서대로 자동으로 호출합니다. OEM 등록 프로세스에 의해 추가된 등록된 각 애플리케이션은 다음 중 하나까지 시도됩니다.

  • 설치되었습니다.
  • MaxRetryCount에 지정된 최대 오류 수를 초과합니다. 실패할 때마다 앱은 다시 시도하기 전에 30분의 쿨다운 기간을 입력합니다.

유니버설 오케스트레이터 프레임워크는 다음 조건이 충족되는 경우 신속 처리한 시도를 수행하지 않습니다.

  • 디바이스가 인터넷에 액세스할 수 없습니다.
  • 디바이스가 데이터 통신 네트워크상에 있습니다.
  • 디바이스가 배터리에 있고 배터리 절약 모드가 설정되어 있습니다.
  • Windows 업데이트 제한 네트워크 트래픽 정책으로 디바이스가 구성됨
  • 디바이스가 자동 승인에 대해 설정되지 않은 CTA 정책으로 구성됨

이러한 각 경우에서 유니버설 오케스트레이터 프레임워크는 디바이스 구성에서 신속 처리한 시도를 진행할 수 있을 때까지 등록을 유지합니다.

Important

디바이스가 사용 중일 때 업데이트 작업이 이루어지고 새 디바이스에서 사용자 환경의 성능에 부정적인 영향을 줄 수 있으므로 이 프레임워크를 통해 앱을 신속 처리하도록 선택할 때 주의해야 합니다.