Partager via

API UpdateOrchestrator

  • Article

UpdateOrchestrator planifie vos mises à jour logicielles automatiques en tenant compte de l’impact sur l’utilisateur. Cette API vous permet de spécifier des actions, comme un téléchargement ou une installation, ainsi que leurs exigences afin d’exécuter des mises à jour à un moment optimal pour réduire l’impact sur l’utilisateur présent. Ces fonctionnalités bénéficient en particulier aux systèmes dont les performances sont moins bonnes, et qui ont des ressources informatiques limitées ou plus lentes.

Windows 20H1 comprend une solution de première génération pour les cas d’utilisation de mises à jour logicielles automatiques qui ont été adoptés par les mises à jour de système d’exploitation et les mises à jour des applications Microsoft Store, et expose une version initiale en « Accès limité » de cette API pour un ensemble choisi d’utilitaires de mise à jour d’applications en « mode utilisateur », comme décrit ci-dessous.

Fonctionnalités

  • Inscrit dynamiquement les utilitaires de mise à jour logicielle

  • Appelle les utilitaires de mise à jour logicielle inscrits pendant les périodes optimales, par exemple, quand l’utilisateur est absent, pour mettre à jour les « applications en mode utilisateur ».

  • Inclut la possibilité de « maintenir l’éveil » quand l’appareil est branché sur le secteur pour réduire davantage l’impact sur l’utilisateur absent.

Public de développeurs

Important

L’API UpdateOrchestrator fait partie d’une fonctionnalité à accès limité (voir la classe LimitedAccessFeatures). Pour plus d’informations ou pour demander un jeton de déverrouillage, utilisez le formulaire de demande de jeton d’accès LAF.

Utilisez l’API UpdateOrchestrator si vous avez déjà des utilitaires de mise à jour logicielle en arrière-plan pour les applications Win32 en « mode utilisateur », comme l’utilitaire de mise à jour d’Adobe pour Acrobat Reader ou Valve’s Steam. Cette interface n’est pas nécessaire pour les applications UWP/Microsoft Store, car le Microsoft Store tire déjà parti de cette fonctionnalité pour les mises à jour logicielles.

Pour offrir la meilleure expérience client, cette version initiale de l’API est limitée à un ensemble choisi d’utilitaires de mise à jour inscrits qui répondent aux critères suivants :

  • Mises à jour pour les applications en « mode utilisateur » uniquement
  • N’impliquent pas de BIOS/microprogramme/pilotes logiciels ou de périphérique
    • La mise à jour du BIOS, du microprogramme ou des pilotes de périphérique/logiciels qui n’ont pas les critères de qualité courants présente un risque important, en particulier quand l’utilisateur n’est pas présent.
  • Si vous utilisez cette API, vous devez pouvoir vous porter garant de tout le contenu téléchargé et installé par vos utilitaires de mise à jour logicielle en arrière-plan sur les systèmes utilisateur via des audits.

Pour l’instant, la version initiale de l’API UpdateOrchestrator en tant que fonctionnalité en accès limité est uniquement destinée aux utilitaires de mise à jour qui répondent aux critères ci-dessus.

Notre objectif est d’améliorer les fonctionnalités de cette API et de réduire l’impact de plusieurs utilitaires de mise à jour logicielle automatique sur Windows. Nous vous remercions de nous fournir vos commentaires en répondant à cette courte enquête afin de nous aider à comprendre comment améliorer l’API UpdateOrchestrator pour qu’elle répondre au mieux aux besoins de vos développeurs.

Accélération de l’installation des applications OEM via le cadre Universal Orchestrator

Important

Universal Orchestrator permet aux OEM d’enregistrer une application au cours du processus d’imagerie afin d’effectuer une installation ou une mise à jour accélérée en une seule fois. Cette installation a lieu dans les 30 minutes qui suivent la connexion d’un utilisateur à un nouvel appareil. Sachez que l’installation accélérée d’une application peut avoir un impact négatif sur les performances des nouveaux appareils. Cette fonctionnalité n’est disponible que sur certaines versions de clients et dans certaines régions.

Spécifications

Pour être intégrée dans le cadre des applications accélérées, l’application doit remplir les conditions suivantes :

  • Il doit s’agir d’une application packagée en magasin au format MSIX.
  • Elle doit avoir un nom de famille de produit (PFN) valide.

Inscription

Les OEM peuvent enregistrer une application pour qu’elle soit accélérée en écrivant une nouvelle clé dans le dossier de transit existant pour les applications accélérées :

HKLM\Software\Microsoft\WindowsUpdate\Orchestrator\UScheduler_OOBE

Chaque enregistrement fourni par l’OEM se présente sous la forme d’une sous-clé (avec un nom unique qui sera utilisé pour identifier cette application accélérée), et d’un ensemble de valeurs de registre pour indiquer les options spécifiques à cette application. Le contenu de chaque clé est au format suivant :

Nom de la clé : nom unique pour cette application accélérée

Sous la sous-clé d’enregistrement de l’application accélérée, les OEM doivent créer deux valeurs :

  • Nom de la valeur : updaterPriority
    Description : Numéro indiquant la priorité relative de la mise à jour de cette application
    Type de valeur : REG_DWORD
    Données : Valeur numérique comprise entre 1 et 100. Les valeurs inférieures indiquent une priorité relative plus élevée par rapport aux autres applications accélérées.

  • Nom de la valeur : expeditedPayload
    Description : Bloc JSON contenant les options de cet outil de mise à jour spécifique
    Type de valeur : REG_SZ
    Données : Une chaîne représentant un blob JSON valide avec des options pour cet outil de mise à jour spécifique.

Vue d’ensemble du contenu du blob JSON :

State Type Nom de clé Description
Obligatoire Chaîne PFN Le nom de famille du package de l’application (ex : Microsoft.WindowsStore_8wekyb3d8bbwe)
Requis Chaîne Point de terminaison Une chaîne URI pointant vers un emplacement hébergeant un package MSIX. Il doit s’agir d’un URI SSL commençant par « https ».
Facultatif Boolean AllowedInOobe Si cette application accélérée doit s’exécuter pendant l’OOBE de l’utilisateur
Facultatif Number MaxRetryCount Le nombre de fois que ce programme de mise à jour est autorisé à réessayer après un échec. 1 constitue la valeur par défaut. Le maximum est de 5.
Facultatif Number TimeoutDurationInMinutes La durée d’attente en minutes pour que ce programme de mise à jour termine son travail. La valeur par défaut est 15. La durée maximale est de 30 minutes.
Facultatif Tableau (Chaîne) ExcludedRegions Un tableau JSON de chaînes de caractères pour les régions où cette application ne doit pas être accélérée. Chaque entrée du tableau correspond au code de pays ISO 3166-1 à deux lettres de la région souhaitée. Par exemple, ["US"] empêcherait ce flux sur les appareils dont la région est les États-Unis.

Exemple de charge utile JSON :

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

Exécution

Le cadre de l’orchestrateur universel invoque automatiquement chacune des applications enregistrées, dans l’ordre basé sur la priorité relative, dans les 30 premières minutes où un utilisateur atteint le Bureau sur un nouvel appareil (ou pendant l’OOBE de l’utilisateur si la valeur AllowedInOobe est définie sur true). Chaque application enregistrée ajoutée par le processus d’enregistrement OEM fera l’objet d’une tentative jusqu’à ce que l’une des conditions suivantes soit remplie :

  • Elle est installée avec succès
  • Elle dépasse le nombre maximum d’échecs spécifié dans MaxRetryCount. Après chaque échec, l’application entre dans une période de refroidissement de 30 minutes avant d’être tentée à nouveau.

Le cadre Universal Orchestrator n’effectuera pas de tentatives accélérées si l’une des conditions suivantes est remplie :

  • L’appareil n’a pas d’accès à Internet.
  • L’appareil est sur un réseau avec compteur.
  • L’appareil est sur batterie et l’économiseur de batterie est activé.
  • L’appareil est configuré avec une stratégie de trafic réseau restreint de Windows Update.
  • L’appareil est configuré avec une stratégie CTA qui n’est pas définie pour l’approbation automatique.

Dans chacun de ces incidents, le cadre de l’orchestrateur universel maintiendra les enregistrements en place jusqu’à ce que la configuration de l’appareil permette de procéder à des tentatives accélérées.

Important

Soyez prudent lorsque vous choisissez d’accélérer les applications via ce cadre, car les opérations de mise à jour se produisent lorsque l’appareil peut être en cours d’utilisation et peuvent avoir un impact négatif sur les performances de l’expérience de l’utilisateur sur un nouvel appareil.