Registrieren einer OEM-Anwendung während des Imageerstellungsprozesses

Anforderungen

Um das beschleunigte App-Framework zu nutzen, muss die App die folgenden Anforderungen erfüllen:

• Es muss sich um eine store-verpackte App im MSIX-Format handeln.

• Er muss über einen gültigen Produktfamiliennamen (PFN) verfügen.

Registrierung

Registrierungsdateien sind ASCII-JSON-Dateien, die Metadaten mit Informationen zum gewünschten beschleunigten Datenfluss sowie alle benutzerdefinierten Client-Zielvorgaben enthalten, die ausgeführt werden müssen.

Beschleunigte Apps unterstützen zwei Mechanismen zum Aktualisieren/Erwerben einer App:

1. Aus dem Microsoft Store mithilfe einer Produkt-ID (empfohlen)

2. Aus einer URL, die ein MSIX-Paket oder -Bündel enthält. Dieses Paket muss eine store-verpackte App mit einem gültigen Paketfamiliennamen (PFN) enthalten. Der OEM- oder App-Besitzer ist für die Aufrechterhaltung dieser URL verantwortlich.

Jede Registrierungsdatei muss die folgenden erforderlichen JSON-Eigenschaften enthalten:

Darüber hinaus können die folgenden optionalen Eigenschaften angegeben werden, um das Verhalten der beschleunigten App-Installation zu ändern oder den beschleunigten Fluss nur unter bestimmten Bedingungen zu erreichen.

Proben

Store-basierte Stub-Erfassung, nur in den USA und Mexiko, zur Ausführung während der OOBE (Out-of-Box Experience)

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

URL-basierter App-Erwerb auf amd64-Geräten, ausschließlich unter Windows 11 23H2, ausgenommen die Editionen Education und EducationN (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 
}

Werkzeuge

Um den Registrierungsprozess zu erleichtern und umsetzbares Feedback zu den Registrierungsmetadaten bereitzustellen, müssen OEMs die AppOrchestration PowerShell-Skripts von folgendem Speicherort aus verwenden:

microsoft/ms-update-universalorchestrator: Skripte und Tools zur Eingliederung in universelle Orchestrator-basierte Update-Flüsse

Die Skripte führen eine grundlegende Überprüfung durch und hinterlegen die Registrierung am richtigen Ort auf dem Gerät. Bei Fehlern lösen die Skripts eine Ausnahme mit den spezifischen Fehlerdetails aus.

So verwenden Sie die Skripts:

1. Laden Sie die Skripts auf Ihr Gerät herunter. Auf der GitHub-Repositoryseite können Sie auswählen, ob sie als ZIP-Datei heruntergeladen und auf Ihr Gerät extrahiert werden sollen.

2. Führen Sie in einem PowerShell-Fenster "Import-Module <PathToScripts>\scripts\AppOrchestration.psd1" aus.

Für den Registrierungsfluss werden vier Haupt-Cmdlets verwendet:

Test-UpdaterRegistration <PathToRegistrationFile>
Zweck: Überprüfen des Inhalts einer vorgeschlagenen Registrierungsdatei (ohne Registrierung). Ermöglicht den OEMs, die Nutzlast der Registrierungsdatei anzupassen, ohne dass sich dies auf das Gerät auswirkt.

Add-UpdaterRegistration <PathToRegistrationFile>
Zweck: Überprüfen, organisieren und bereitstellen Sie den Inhalt einer Registrierungsdatei an den entsprechenden Ort, um den beschleunigten App-Prozess zu starten.

Get-UpdaterRegistration <OEMName><UpdaterName>
Zweck: Wenn OEMName und UpdaterName bereitgestellt werden, geben Sie eine Zusammenfassung einer vorhandenen Registrierung zurück, die diesen Werten entspricht. Wenn diese Eingaben weggelassen werden, geben Sie eine Zusammenfassung aller aktuellen Registrierungen zurück, die auf dem Gerät vorhanden sind.

Remove-UpdaterRegistration <OEMName><UpdaterName>
Zweck: Entfernt alle Registrierungen, die mit den Werten von OEMName und UpdaterName übereinstimmen.

Ausführung

Das Universal Orchestrator-Framework ruft automatisch jede der registrierten Apps in der Reihenfolge auf, basierend auf relativer Priorität, und zwar innerhalb der ersten 30 Minuten, nachdem ein Benutzer den Desktop auf einem neuen Gerät erreicht hat (oder während der Benutzer-OOBE, wenn AllowedInOobe auf 'true' gesetzt ist). Jede registrierte Anwendung, die durch den OEM-Registrierungsprozess hinzugefügt wurde, wird versucht auszuführen, bis entweder:

• Es wurde erfolgreich installiert.

• Er überschreitet die maximale Anzahl von Fehlern, die in MaxRetryCount angegeben wurden. Nach jedem Fehler wechselt die App in einen Abkühlzeitraum von 30 Minuten, bevor sie erneut versucht wird.

Das Universal Orchestrator-Framework führt keine beschleunigten Versuche aus, wenn eine der folgenden Bedingungen zutrifft:

• Das Gerät hat keinen Internetzugang.

• Das Gerät befindet sich in einem getakteten Netzwerk.

• Das Gerät befindet sich im Akku, und der Stromsparmodus ist aktiviert.

• Das Gerät ist mit einer Windows-Update-Richtlinie für eingeschränkten Netzwerkverkehrkonfiguriert.

• Das Gerät ist mit einer CTA-Richtlinie konfiguriert, die für AutoApprove nicht festgelegt ist.

In jedem dieser Fälle behält das Universal Orchestrator-Framework die Registrierungen bei, bis die Gerätekonfiguration beschleunigte Versuche ermöglicht, fortzufahren.

Wenn die App-Registrierung optionale Werte enthält, die den beschleunigten Fluss blockieren (z. B. aufgrund des Editionstyps), betrachtet das Universal Orchestrator-Framework diese Registrierungsanforderung als erfüllt und versucht sie nicht erneut, auch wenn sich diese Bedingungen später auf einem Gerät ändern können.