Passer au contenu principal
Utilisez cet outil pour créer rapidement de nouveaux scripts d’installation sans assistance pour les kits de développement XBOX One en choisissant parmi un large éventail d’actions prédéfinies. L’outil de création de scripts est disponible à la fois dans XBOX Device Portal (Windows Device Portal sur XBOX), comme illustré dans la figure 1, et dans XBOX Manager. Figure 1. Interface principale de l’outil de création de scripts dans XBOX Device Portal Capture d'écran de l'interface principale de l'outil de création de scripts dans XBOX Device Portal Cette rubrique contient les sections suivantes.

Ouvrir l’outil de création de scripts

L’outil de création de scripts est inclus dans XBOX Device Portal (Windows Device Portal sur XBOX) et hébergé dans XBOX Manager. Pour ouvrir l’outil dans XBOX Device Portal, accédez à l’espace de travail Automation dans le volet gauche, comme illustré dans la figure 2. Figure 2. Espaces de travail dans XBOX Device Portal Capture d'écran des espaces de travail dans XBOX Device Portal Si vous ne trouvez pas l’espace de travail Automation, ajoutez les outils d’automatisation à un nouvel espace de travail en procédant comme suit.
  1. Sélectionnez Menu dans le coin supérieur gauche, puis New workspace.
  2. Saisissez un nom pour le nouvel espace de travail, puis sélectionnez Add.
  3. Dans le nouvel espace de travail, sélectionnez Menu, puis Add tools to workspace.
  4. Dans la liste des outils, sélectionnez XBOX automation et XBOX unattended settings, puis Add.

Créer un script

Si vous travaillez déjà sur un script, pensez à exporter ou à déployer ce script avant de sélectionner New script. Pour créer un script, sélectionnez New script sous Automation ou dans votre espace de travail personnalisé. Cela efface le script actuel et réinitialise Script Name sur “New Script”.
cautionATTENTION : l’accès à un autre espace de travail de XBOX Device Portal a le même effet que la sélection de New script. Pour éviter de perdre votre travail, ouvrez votre nouvel espace de travail dans un nouvel onglet du navigateur.

Ajouter, modifier et réorganiser les actions d’un script

Les actions de script sont des tâches d’automatisation individuelles que vous pouvez combiner pour créer un script. . L’éditeur de scripts tient à jour un tableau des actions que vous avez ajoutées. Ce tableau est vide dans un script nouvellement créé. À mesure que vous ajoutez des actions, de nouvelles lignes sont ajoutées au tableau, comme illustré dans la figure 3. Figure 3. Tableau des actions dans l’outil de création de scripts Capture d'écran du tableau des actions dans l'outil de création de scripts Pour ajouter une nouvelle action à un script, sélectionnez New action. La boîte de dialogue New action s’affiche; elle contient des listes classées par catégorie de dizaines de tâches et de paramètres scriptables que vous pouvez ajouter à votre script. Pour ce faire, choisissez une catégorie, sélectionnez l’action souhaitée dans la liste, puis sélectionnez Next pour terminer l’ajout de l’action à votre script, comme illustré dans la figure 4. Figure 4. Boîte de dialogue New action dans l’outil de création de scripts Capture d'écran de la boîte de dialogue New action dans l'outil de création de scripts Pour modifier une action existante, sélectionnez son nom dans le tableau. Après avoir créé un script comportant plusieurs actions, vous pouvez modifier l’ordre d’exécution des actions en sélectionnant le lien move up ou move down dans la colonne Actions. Pour supprimer une action, sélectionnez le lien delete dans la colonne Actions, comme illustré dans la figure 3.

Exporter et importer des scripts

Pour enregistrer votre script, sélectionnez Export, puis enregistrez le script à l’aide de la boîte de dialogue de fichier standard. Le script est enregistré dans un fichier texte nommé “scriptname.xboxunattend”. (Notez que le bouton Export n’est pas disponible si le script ne contient aucune action.) Les scripts enregistrés peuvent être importés et déployés ultérieurement sur une autre console ou sur un lecteur USB. Pour modifier des scripts précédemment exportés, importez-les dans l’outil de création de scripts. Pour importer un script, sélectionnez Import, puis accédez au fichier .xboxunattend qui contient le script.

Déployer et effacer un script de démarrage

Pour exécuter automatiquement un script à chaque redémarrage de votre kit de développement, importez le script dans l’outil, puis sélectionnez Apply as boot script. Le script est alors copié dans un script de commandes nommé xd:\boot\boot.cmd sur votre kit de développement. À chaque redémarrage, votre kit de développement ouvre soit Developer Home sur la console (Dev Home) (par défaut pour les kits de développement), soit l’écran d’accueil commercial, selon les préférences sélectionnées, puis exécute votre script de démarrage environ 20 à 30 secondes plus tard. Pour supprimer le script de démarrage actuel de la console, sélectionnez Clear stored script. Ce bouton est disponible chaque fois que XBOX Device Portal est connecté à une console sur laquelle un script de démarrage est déployé.

Annuler un script de démarrage

Lorsque le kit de développement redémarre, le système affiche par défaut la notification suivante, illustrée dans la figure 5, avant l’exécution du script de démarrage. Figure 5. Notification du script de démarrage Capture d'écran de la notification du script de démarrage Cette notification vous permet d’annuler un script dangereux. Par exemple, un script qui redémarre la console n’est pas un bon choix de script de démarrage, car il entraînerait une boucle de redémarrage sans fin. Pour annuler un script, maintenez enfoncé le bouton XBOX de votre manette lorsque cette notification s’affiche. La notification d’annulation est activée par défaut et allonge légèrement la séquence de démarrage. Pour désactiver cette notification, sélectionnez l’option Run scripts immediately on startup sous Unattended script settings, comme illustré dans la figure 1.

Appeler des scripts depuis le panneau avant du kit de développement XBOX One X

Le kit de développement XBOX One X dispose d’un écran en façade intégré et de cinq boutons programmables. Vous pouvez configurer chacun de ces boutons pour qu’il effectue une action personnalisée lorsqu’il est enfoncé. Cela inclut à la fois les actions intégrées et les actions personnalisées que vous créez à l’aide de l’outil de création de scripts. Pour associer un script à un bouton du panneau avant, sélectionnez Add for front panel buttons dans l’outil de création de scripts afin de copier le script sur le kit de développement. Suivez ensuite les instructions de Gestion de l’automatisation de la console pour réassocier le bouton à votre script personnalisé.
Cette fonctionnalité n’apparaît que lorsque XBOX Device Portal est connecté à un kit de développement XBOX One X.
Dernière modification le 8 octobre 2026