이미징 프로세스 중에 OEM 애플리케이션 등록

요구 사항

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

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

등록

등록 파일은 원하는 신속한 흐름 및 수행해야 하는 사용자 지정 클라이언트 쪽 대상 지정에 대한 정보가 포함된 메타데이터를 포함하는 ASCII JSON 파일입니다.

신속한 앱은 앱을 업데이트/획득하는 두 가지 메커니즘을 지원합니다.

1. Microsoft Store에서 ProductId 을(를) 사용하여 (권장)
2. MSIX 패키지 또는 번들을 포함하는 URL에서 이 패키지에는 유효한 PFN(패키지 패밀리 이름)이 있는 Store 패키지 앱이 포함되어야 합니다. OEM 또는 앱 소유자는 이 URL을 유지 관리할 책임이 있습니다.

각 등록 파일에는 다음과 같은 필수 JSON 속성이 포함되어야 합니다.

또한 다음 선택적 속성을 지정하여 신속한 앱 설치의 동작을 수정하거나 특정 조건에서만 발생하는 신속한 흐름을 대상으로 지정할 수 있습니다.

샘플

OOBE 동안 미국과 멕시코에서만 스토어 기반 스텁 인수를 실행할 수 있습니다.

{  
    "OEMName": "Contoso",
    "UpdaterName": "OEMApp1",
    "RegistrationVersion":1,  
    "Source": "Store",  
    "Scenario": "StubAcquisition",  
    "PFN": "FakePackageFamilyName",  
    "ProductId": "StoreProductId",  
    "HonorDeprovisioning": true,  
    "AllowedInOobe": true,  
    "IncludedRegions": ["US", "MX"],  
    "Priority": 50  
}

Windows 11 23H2 버전에서만, Education 및 EducationN 에디션을 제외하고, amd64 디바이스에서 URL을 통한 앱 설치 (not Windows 11 22H2)

{  
    "OEMName": "Contoso",
    "UpdaterName": "OEMApp1",
    "RegistrationVersion":2,  
    "Source": "CustomURL",  
    "Scenario": "Acquisition",  
    "PFN": "FakePackageFamilyName",  
    "Endpoint": "https://<SSL_URI>",   
    "ExcludedEditions": [121, 122],   
    "Architecture": "amd64",   
    "MinimumAllowedBuildVersion": 22631,  
    "Priority": 60 
}

도구

등록 프로세스를 용이하게 하고 등록 메타데이터에 대한 실행 가능한 피드백을 제공하려면 OEM은 다음 위치에서 AppOrchestration PowerShell 스크립트를 사용해야 합니다.

microsoft/ms-update-universalorchestrator: 유니버설 오케스트레이터 기반 업데이트 흐름에 온보딩할 스크립트 및 도구

스크립트는 기본 유효성 검사를 수행하고 디바이스의 적절한 위치에 등록을 준비합니다. 모든 오류가 발생하면 스크립트는 특정 오류 세부 정보와 함께 예외를 발생시킵니다.

스크립트를 사용하려면 다음을 수행합니다.

1. 디바이스에 스크립트를 다운로드합니다. GitHub 리포지토리 페이지에서 ZIP 파일로 다운로드하고 디바이스에 추출하도록 선택할 수 있습니다.
2. PowerShell 창에서 "Import-Module <PathToScripts>\scripts\AppOrchestration.psd1"을 실행합니다.

등록 흐름에 사용되는 네 가지 기본 cmdlet이 있습니다.

<Test-UpdaterRegistration PathToRegistrationFile>
목적: 등록을 수행하지 않고 제안된 등록 파일의 콘텐츠 유효성을 검사합니다. OEM에서 디바이스에 영향을 주지 않고 등록 파일 페이로드를 반복할 수 있습니다.

<Add-UpdaterRegistration PathToRegistrationFile>
목적: 신속한 앱 흐름에 온보딩하기 위해 등록 파일의 내용의 유효성을 검사하고 적절한 위치에 스테이징합니다.

Get-UpdaterRegistration <OEMName><UpdaterName>
목적: OEMName 및 UpdaterName이 제공되면 해당 값과 일치하는 기존 등록 요약을 반환합니다. 이러한 입력을 생략하면 디바이스에 있는 모든 현재 등록에 대한 요약을 반환합니다.

Remove-UpdaterRegistration <OEMName><UpdaterName>
목적: OEMName 및 UpdaterName 값과 일치하는 등록을 스테이징 해제합니다.

실행

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

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

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

• 디바이스에 인터넷에 액세스할 수 없습니다.
• 디바이스가 요금제 네트워크에 있습니다.
• 디바이스가 배터리에 있고 배터리 절약 장치가 사용하도록 설정되어 있습니다.
• 디바이스는 Windows 업데이트 제한 네트워크 트래픽 정책으로 구성됩니다.
• 디바이스가 자동 승인이 설정되지 않은 CTA 정책으로 설정되어 있습니다.

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

앱 등록에 신속한 흐름을 차단하는 선택적 값(예: 버전 유형)이 포함된 경우 유니버설 오케스트레이터 프레임워크는 이 등록 요청이 처리된 것으로 간주하고 나중에 디바이스에서 해당 조건이 변경될 수 있더라도 다시 시도하지 않습니다.