Labo 1c : Ajout de fichiers et de paramètres de Registre à une image

Article
10/15/2018

Nous allons créer des fichiers de test et des clés de Registre dans une image Windows IoT Core, et les empaqueter afin qu’ils puissent être pris en charge après leur distribution à vos clients. Étant donné que les fichiers et les clés de Registre que vous ajoutez à votre image ne sont souvent pas spécifiques à une architecture, nous vous recommandons de créer un package commun que vous pouvez utiliser dans toutes vos architectures d’appareil.

Objectifs

Créer un package qui contient les paramètres de registre et de fichier pour votre appareil
Empaqueter le package de paramètres de registre/fichier afin qu’il puisse être inclus dans une image FFU
Modifier les fichiers de configuration de projet du Kit de modules complémentaires IoT pour inclure votre package de paramètres de registre/fichier
Créer et déployer une image FFU qui contient votre package de paramètres de registre/fichier

Nous allons créer des fichiers de test et des clés de Registre pour l’image, puis les empaqueter afin qu’ils puissent être pris en charge une fois qu’ils ont atteint vos clients.

Nous allons les ajouter au manifeste de fonctionnalité commun (OEMCommonFM.xml), qui est utilisé dans les builds x86, x64 et Arm.

Pour ce labo, nous allons démarrer un nouveau produit, ProductB, afin que nous puissions plus tard utiliser l’exemple d’application IoT pour obtenir l’adresse IP de notre appareil et vérifier que nos fichiers et clés reg sont bien faits.

Conditions préalables

Vérifiez que vous avez créé une image de base à partir de Créer une image de base précédemment.

Vous aurez besoin des outils suivants installés pour copmlete cette action :

Évaluation et déploiement Windows KiT (Windows ADK)
Environnement PowerShell IoT Core
Packages Windows 10 IoT Standard
IoT Core ADK Add-Ons
Un éditeur de texte comme le Bloc-notes ou VS Code.

Créer vos fichiers de test

Créez quelques exemples de fichiers texte à l’aide du Bloc-notes et ajoutez du texte aléatoire afin que ces fichiers ne soient pas vides. Pour notre exemple, nous avons créé deux fichiers intitulés TestFile1.txt et TestFile2.txt.

Créer un package pour les fichiers de test

Ouvrez l’environnement PowerShell IoT Core : exécutez C:\MyWorkspace\IoTCorePShell.cmd en tant qu’administrateur et créez un package de fichiers à l’aide de Add-IoTFilePackage :
```
# Array of files with destinationDir, Source and destinationFilename
$myfiles = @(
    ("`$(runtime.system32)","C:\Temp\TestFile1.txt", ""),        
    ("`$(runtime.bootDrive)\OEMInstall","C:\Temp\TestFile2.txt", "TestFile2.txt")
    )
Add-IoTFilePackage Files.Configs $myfiles
```
Cela crée un nouveau dossier à l’emplacement C:\MyWorkspace\Common\Packages\Files.Configs.

Cela ajoute également une FILES_CONFIGS FeatureID au C:\MyWorkspace\Common\Packages\OEMCOMMONFM.xml fichier.

Les variables telles que $(runtime.system32) sont définies dans C:\Program Files (x86)\Windows Kits\10\Tools\bin\i386\pkggen.cfg.xml.

Créez un package de registre à l’aide de Add-IoTRegistryPackage :

# Array of files with destinationDir, Source and destinationFilename
$myregkeys = @(
    ("`$(hklm.software)\`$(OEMNAME)\Test","StringValue", "REG_SZ", "Test string"),
    ("`$(hklm.software)\`$(OEMNAME)\Test","DWordValue", "REG_DWORD", "0x12AB34CD")
    )
Add-IoTRegistryPackage Registry.Settings $myregkeys

Cela crée un nouveau dossier à l’emplacement C:\MyWorkspace\Common\Packages\Registry.Settings.

Cela ajoute également une REGISTRY_SETTINGS FeatureID au C:\MyWorkspace\Common\Packages\OEMCOMMONFM.xml fichier.

Générez les packages à l’aide de New-IoTCabPackage :
```
New-IoTCabPackage Files.Configs
(or) buildpkg Files.Configs
New-IoTCabPackage Registry.Settings
(or) buildpkg Registry.Settings
```
Le package est généré et est disponible à l’adresse C:\MyWorkspace\Build\<arch>\pkgs.

Créer un produit

Créez un dossier produit.
```
Add-IoTProduct ProductB RPi2
(or) newproduct ProductB RPi2
```
Cela vous invite à entrer des valeurs SMBIOS .

Mettre à jour les fichiers de configuration du projet

Mettez à jour la configuration de test du produit pour inclure les fonctionnalités à l’aide de Add-IoTProductFeature :

Add-IoTProductFeature ProductX Test FILES_CONFIGS -OEM
(or) addfid ProductX Test FILES_CONFIGS -OEM
Add-IoTProductFeature ProductX Test REGISTRY_SETTINGS -OEM
(or) addfid ProductX Test REGISTRY_SETTINGS -OEM

Générer et tester l’image

Générez à nouveau l’image FFU, comme spécifié dans Créer une image de base. Vous devez uniquement exécuter la commande New-IoTFFUImage :

New-IoTFFUImage ProductX Test
(or)buildimage ProductX Test

Une fois le fichier FFu généré, vous pouvez le flasher sur votre appareil matériel comme spécifié dans Flashing a Windows IoT Core image.

Vérifier l’ajout de fichiers et de clés de Registre

Pour vérifier que les fichiers ont été ajoutés sur l’appareil, procédez comme suit :

Connectez votre PC de technicien et l’appareil au même réseau Ethernet.

Par exemple, pour vous connecter sur un réseau câblé, branchez un câble Ethernet. Pour vous connecter directement à l’appareil, branchez un câble réseau directement à partir de votre PC de technicien à l’appareil.
Sur l’application de test, notez l’adresse IP de l’appareil. Par exemple, 10.100.0.100.
Sur le PC de technicien, ouvrez Explorateur de fichiers et tapez l’adresse IP de l’appareil avec un préfixe \ et un suffixe \c$ :
```
\\10.100.0.100\c$
```

Utilisez le nom de l’appareil, le compte d’administrateur par défaut et le mot de passe pour vous connecter. (La valeur par défaut est : minwinpc\Administrator /p@ssw0rd)

Vérifiez si les fichiers existent sur l’appareil. Pour notre exemple, recherchez :

\\10.100.0.100\c$\Windows\system32\TestFile1.txt

\\10.100.0.100\c$\OEMInstall\TestFile2.txt

Vérifier les clés de Registre

Sur le PC de technicien, connectez votre appareil à l’aide d’un client SSH, tel que PuTTY. Par exemple, utilisez l’adresse IP et le port 22 pour vous connecter à l’appareil. Connectez-vous ensuite à l’aide du compte administrateur et du mot de passe. (Pour en savoir plus, consultez SSH).
À partir de la ligne de commande dans le client SSH, interrogez le système pour obtenir la clé de Registre. Dans notre exemple, cette commande a été exécutée pour case activée l’existence de la clé de Registre :
```
reg query HKLM\Software\Fabrikam\Test
```
Le client SSH doit afficher vos valeurs de test.

Vous pouvez également utiliser la commande Exécuter dans le portail d’appareil Windows pour exécuter la reg query commande.

La fenêtre de sortie doit afficher vos valeurs de test.

Étapes suivantes

Labo 1d : ajouter un package d’approvisionnement à une image

Share via