イメージング プロセス中に OEM アプリケーションを登録する

必要条件

迅速なアプリ フレームワークにプラグインするには、アプリが次の要件を満たしている必要があります。

• MSIX 形式のストア パッケージ アプリである必要があります
• 有効な製品ファミリ名 (PFN) が必要です。

登録

登録ファイルは、必要な迅速なフローと、実行する必要があるカスタム クライアント側のターゲット設定に関する情報を含むメタデータを含む ASCII JSON ファイルです。

迅速なアプリでは、アプリを更新/取得するための 2 つのメカニズムがサポートされています。

1. Microsoft Store から、ProductId （推奨） を使用して
2. MSIX パッケージまたはバンドルを含む URL から。 このパッケージには、有効なパッケージ ファミリ名 (PFN) を持つストア パッケージ アプリが含まれている必要があります。 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 でのみ、Amd64 デバイス (Education および EducationN エディションを除く) での 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 は次の場所から PowerShell スクリプト AppOrchestration を使用する必要があります。

microsoft/ms-update-universalorchestrator: Universal Orchestrator ベースの更新フローにオンボードするためのスクリプトとツール

スクリプトは基本的な検証を実行し、デバイス上の適切な場所に登録をステージングします。 エラーが発生した場合、スクリプトは特定のエラーの詳細を含む例外をスローします。

スクリプトを使用するには:

1. スクリプトをデバイスにダウンロードします。 GitHub リポジトリ ページから、ZIP ファイルとしてダウンロードし、デバイスに展開することを選択できます
2. PowerShell ウィンドウで、"Import-Module <PathToScripts>\scripts\AppOrchestration.psd1" を実行します

登録フローには、次の 4 つの主要なコマンドレットが使用されます。

Test-UpdaterRegistration <PathToRegistrationFile> を使用する
目的: (登録を実行せずに) 提案された登録ファイルの内容を検証します。 OEM がデバイスに影響を与えずに登録ファイル ペイロードを反復処理できるようにします。

Add-UpdaterRegistration < PathToRegistrationFile>
目的: 登録ファイルの内容を検証して適切な場所にステージングし、迅速なアプリ フローにオンボードします。

Get-UpdaterRegistration < OEMName><UpdaterName>
目的: OEMName と UpdaterName が指定されている場合は、それらの値と一致する既存の登録の概要を返します。 これらの入力を省略した場合は、デバイスに存在するすべての現在の登録の概要を返します。

Remove-UpdaterRegistration < OEMName><UpdaterName>
目的: OEMName と UpdaterName の値に一致する登録を未設定に戻します。

実行

ユニバーサル オーケストレーター フレームワークは、ユーザーが新しいデバイスでデスクトップに到達してから最初の 30 分以内 (または AllowedInOobe が true に設定されている場合は User OOBE の間) に、相対的な優先順位に基づいて、登録されている各アプリを自動的に順番に呼び出します。 OEM 登録プロセスによって追加された登録された各アプリケーションは、次のいずれかになるまで試行されます。

• 正常にインストールされました
• MaxRetryCount で指定されたエラーの最大数を超えています。 エラーが発生するたびに、アプリは 30 分のクール ダウン期間に入り、再試行されます。

次のいずれかの条件に該当する場合、ユニバーサル オーケストレーター フレームワークは迅速な試行を実行しません。

• デバイスはインターネットにアクセスできません。
• デバイスは従量制課金ネットワーク上にあります。
• デバイスがバッテリに搭載され、バッテリ セーバーが有効になっています。
• デバイスは、Windows Update の制限付きネットワーク トラフィック ポリシーで構成されます。
• デバイスは、AutoApprove に設定されていない CTA ポリシー で構成されます。

いずれの場合も、ユニバーサル オーケストレーター フレームワークは、デバイス構成で迅速な試行を続行できるようになるまで、登録を維持します。

アプリの登録に、迅速なフローをブロックする省略可能な値 (エディションの種類など) が含まれている場合、ユニバーサル オーケストレーター フレームワークでは、この登録要求が満たされたと見なされ、後でデバイスでこれらの条件が変更される可能性がある場合でも、再び試みることはありません。