Inscrire une application OEM pendant le processus d’imagerie

Exigences

Pour vous connecter à l’infrastructure d’application accélérée, l’application doit répondre aux exigences suivantes :

• Il doit s’agir d’une application empaquetée dans le Windows Store au format MSIX
• Il doit avoir un nom de famille de produits valide (PFN)

Inscription

Les fichiers d’inscription sont des fichiers JSON ASCII qui contiennent des métadonnées avec des informations sur le flux accéléré souhaité et tout ciblage personnalisé côté client qui doit être effectué.

Les applications accélérées prennent en charge deux mécanismes pour mettre à jour/ acquérir une application :

1. Du Microsoft Store en utilisant un ProductId (recommandé) et.
2. À partir d’une URL qui contient un package ou un bundle MSIX. Ce package doit contenir une application empaquetée dans le Windows Store avec un nom de famille de package valide (PFN). Le propriétaire de l’oem ou de l’application est responsable de la maintenance de cette URL.

Chaque fichier d’inscription doit contenir les propriétés JSON requises suivantes :

En outre, les propriétés facultatives suivantes peuvent être spécifiées pour modifier le comportement de l’installation de l’application accélérée, ou pour cibler le flux accéléré à se produire uniquement dans certaines conditions.

Échantillons

acquisition de stub en magasin, uniquement aux États-Unis et au Mexique, pour s’exécuter pendant le OOBE

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

Acquisition d'applications basées sur URL sur des appareils amd64, excluant les éditions Éducation et ÉducationN, uniquement sur Windows 11 23H2 (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 
}

Outils

Pour faciliter le processus d’inscription et fournir des commentaires actionnables sur les métadonnées d’inscription, les OEM doivent utiliser les scripts PowerShell AppOrchestration à partir de l’emplacement suivant :

microsoft/ms-update-universalorchestrator : Scripts et outils pour s’intégrer aux flux de mise à jour basés sur Universal Orchestrator

Les scripts effectuent une validation de base et étapent l’inscription à l’emplacement approprié sur l’appareil. En cas d’échec, les scripts lèvent une exception avec les détails spécifiques de l'échec.

Pour utiliser les scripts :

1. Téléchargez les scripts sur votre appareil. Dans la page du dépôt GitHub, vous pouvez sélectionner le téléchargement en tant que fichier ZIP et l’extraire sur votre appareil
2. Dans une fenêtre PowerShell, exécutez «Import-Module <PathToScripts>\scripts\AppOrchestration.psd1 »

Il existe quatre applets de commande principales utilisées pour le flux d’inscription :

<Test-UpdaterRegistration PathToRegistrationFile>
Objectif : Valider le contenu d’un fichier d’inscription proposé (sans effectuer l’inscription). Permet à l’OEM d’itérer sur la charge utile du fichier d’inscription sans impacter l’appareil.

<Add-UpdaterRegistration PathToRegistrationFile>
Objectif : Valider et mettre en scène le contenu d’un fichier d’inscription à l’emplacement approprié, à intégrer au flux d’application accéléré.

<Get-UpdaterRegistration OEMName><UpdaterName>
Objectif : si OEMName et UpdaterName sont fournis, retournez un résumé d’une inscription existante qui correspond à ces valeurs. Si ces entrées sont omises, retournez un résumé de toutes les inscriptions actuelles présentes sur l’appareil.

Remove-UpdaterRegistration <OEMName><UpdaterName>
Objectif : Annulez toute inscription qui correspond aux valeurs OEMName et UpdaterName.

Exécution

L’infrastructure d’orchestrateur universel appelle automatiquement chacune des applications inscrites, en fonction de la priorité relative, dans les 30 premières minutes suivant l'accès d'un utilisateur au Bureau sur un nouvel appareil (ou pendant l’OOBE utilisateur si AllowedInOobe est défini sur true). Chaque application enregistrée ajoutée par le processus d'inscription OEM sera essayée jusqu'à ce que :

• Il est correctement installé
• Il dépasse le nombre maximal d’échecs spécifié dans MaxRetryCount. Après chaque échec, l’application entrera une période de refroidissement de 30 minutes avant de réessayer.

L’infrastructure d’Orchestrateur universel n’effectue pas de tentatives accélérées si l’une des conditions suivantes est remplie :

• L’appareil n’a pas accès à Internet.
• L’appareil se trouve sur un réseau à consommation mesurée.
• L’appareil est sur batterie et l’économiseur de batterie est activé.
• L'appareil est configuré avec une stratégie Windows Update de restriction du trafic réseau .
• L’appareil est configuré avec une stratégie CTA qui n’est pas définie pour AutoApprove.

Dans chacun de ces cas, le cadre de l'orchestrateur universel garde les enregistrements en place jusqu'à ce que la configuration du dispositif permette de faire avancer les tentatives accélérées.

Si l’inscription de l’application contient des valeurs facultatives qui bloquent le flux accéléré (par exemple, en raison du type d’édition), l’infrastructure d’Orchestrateur universel considère cette demande d’inscription remplie et ne la réessaye pas, même si ces conditions peuvent changer ultérieurement sur un appareil.