Windows 10 IoT Standard Utils de ligne de commande

Article
04/03/2023

Vous souhaitez configurer certains des paramètres sur votre appareil ? Les outils ci-dessous sont disponibles à votre disposition. Utilisez PowerShell pour exécuter ces commandes après vous être connecté à votre appareil.

Notes

Ces outils ne sont pas préchargés . Vous devez inclure les ID de fonctionnalité appropriés pour obtenir ces outils dans l’image.

Utils de ligne de commande spécifiques à IoT Core

Définition de l’application de démarrage

Utilisez l’éditeur de démarrage pour configurer des applications de démarrage sur votre appareil Windows IoT Core. Exécutez IotStartup avec l’une des options suivantes :

IotStartup list répertorie les applications installées
IotStartup list headed répertorie les applications en tête installées
IotStartup list headless répertorie les applications sans tête installées
IotStartup list [MyApp] répertorier les applications installées qui correspondent au modèle MyApp
IotStartup add ajoute des applications dirigées et sans tête
IotStartup add headed [MyApp] ajoute des applications en tête qui correspondent au modèle MyApp. Le modèle ne doit correspondre qu’à une seule application.
IotStartup add headless [Task1] ajoute des applications sans tête qui correspondent au modèle Task1
IotStartup remove supprime les applications headless et headless
IotStartup remove headed [MyApp] supprime les applications en tête qui correspondent au modèle MyApp
IotStartup remove headless [Task1] supprime les applications sans tête qui correspondent au modèle Task1
IotStartup startup répertorie les applications en tête et sans tête inscrites pour le démarrage
IotStartup startup [MyApp] répertorie les applications en tête et sans tête inscrites pour le démarrage qui correspondent au modèle MyApp
IotStartup startup headed [MyApp] répertorie les applications en tête inscrites pour le démarrage qui correspondent MyApp
IotStartup startup headless [Task1] répertorie les applications sans tête inscrites pour le démarrage qui correspondent Task1
IotStartup run [MyApp] démarrer l’application identifiée par MyApp
IotStartup stop [MyApp] arrêter l’application identifiée par MyApp
Pour obtenir de l’aide, essayez IotStartup help

Modifier les paramètres de la région et de l’utilisateur ou de la langue vocale

L’outil IoTSettings change la région, la langue de l’utilisateur ou la langue vocale. Il s’agit d’un outil en ligne de commande qui peut être appelé à partir d’une application à l’aide de l’API ProcessLauncher. Ces commandes doivent être exécutées en tant que compte par défaut, et non en tant qu’administrateur.

IotSettings del account {all | username} supprime tous les comptes MSA ou Azure AD sur le système ou un compte spécifique. Des comptes spécifiques prennent la forme username@provider.com
IotSettings del diagnostics supprime les informations de diagnostic dans le cloud pour l’appareil actuel. Notez que cela supprime l’historique jusqu’au moment de l’appel. Les nouvelles informations diagnostics continueront d’être enregistrées.
IotSettings list account répertorie tous les comptes MSA ou Azure AD qui ont été connectés à l’appareil.
IotSettings list uilanguage répertorie toutes les langues de l’interface utilisateur
IotSettings list speechlanguage répertorie toutes les langues vocales
IotSettings get uilanguage affiche la langue actuelle de l’interface utilisateur
IotSettings get speechlanguage affiche la langue vocale actuelle
IotSettings get region affiche la région actuelle
IotSettings set uilanguage language\_tag - (e.g. fr-CA) définit la langue d’interface utilisateur par défaut Français canadien)
IotSettings set speechlanguage language\_tag - (e.g. fr-CA) définit la langue vocale Français canadienne)
IotSettings set region region\_code - (e.g. CA) définit la région par défaut sur Le Canada)
IotSettings set bluetoothpref {sink | source} Spécifie la préférence de rôle Bluetooth à sélectionner lorsque les appareils créés avec des fonctionnalités IOT_BLUETOOTH_A2DP_SOURCE et IOT_BLUETOOTH_A2DP_SINK se connectent à un autre appareil qui prend également en charge les deux rôles.
IotSettings get bluetoothpref retourne la préférence de rôle Bluetooth actuelle pour les appareils créés avec IOT_BLUETOOTH_A2DP_SOURCE et IOT_BLUETOOTH_A2DP_SINK. La valeur par défaut est source.

Conseil

IoTSettings -list uiLanguage renvoie la liste des langues d’interface utilisateur prises en charge (dans la version de l’image principale De Windows IoT sur laquelle elle a été exécutée)

Modifier le volume et l’appareil audio par défaut

L’outil IoTCoreAudioControlTool contrôle les options audio, telles que la définition des périphériques de capture et de lecture par défaut et la modification du volume. Pour obtenir la liste complète des paramètres, exécutez IoTCoreAudioControlTool h.

Installation manuelle de . Fichiers APPX

DeployAppx permet d’installer et de supprimer dans . Packages APPX dans les scénarios de développement. Méthode correcte pour l’installation de . Les packages APPX dans les images de production consiste à utiliser un package d’approvisionnement, comme indiqué dans le sujet Installer votre application . DeployAppx prend également en charge l’interrogation . Informations sur le package APPX.

DeployAppx install MyApp.appx installe . APPX et le certificat du même nom s’il est trouvé.
DeployAppx install force MyApp.appx force la désinstallation du actuellement installé. APPX portant le même nom de package s’il a été trouvé avant d’installer le nouveau . APPX. Cela est utile pour l’installation d’un . APPX avec le numéro de version identique ou inférieur à celui actuellement installé. APPX.
DeployAppx install retry MyApp.appx réessayez d’installer . APPX 10 fois en cas d’échec avec un délai de 2 secondes entre les tentatives.
DeployAppx uninstall App_1.0.1.0_x86__publisherid123 désinstallez .appx avec le nom complet du package correspondant.
DeployAppx uninstall MyApp.appx désinstallez tous les installés . APPX avec un nom de famille de package correspondant.
DeployAppx getpackages répertorie les noms complets des packages installés.
DeployAppx getpackageid IotCoreDefaultApp.appx affiche le nom du package, le nom de la famille de package et le nom complet du package pour . APPX.

DeployAppx getpackageid IotCoreDefaultApp.appx
         Package Name: 16454Windows10IOTCore.IOTCoreDefaultApplication
  Package Family Name: 16454Windows10IOTCore.IOTCoreDefaultApplication_rz84sjny4rf58
    Package Full Name: 16454Windows10IOTCore.IOTCoreDefaultApplication_2.0.8.0_arm__rz84sjny4rf58

DeployAppx register appxmanifest.xml Unsupported

Utils de ligne de commande généraux

Mettre à jour le mot de passe du compte

Il est vivement recommandé de mettre à jour le mot de passe par défaut pour le compte administrateur. Pour ce faire, vous pouvez émettre la commande suivante : net user Administrator [new password] où [new password] représente un mot de passe fort de votre choix.

Créer des comptes d’utilisateur locaux

Si vous souhaitez accorder à d’autres utilisateurs l’accès à votre appareil Windows IoT Core, vous pouvez créer des comptes d’utilisateur locaux supplémentaires à l’aide de PS en tapant dans net user [username] [password] /add. Si vous souhaitez ajouter cet utilisateur à d’autres groupes, tels que le groupe Administrateur, utilisez net localgroup Administrators [username] /add.

Définition du mot de passe

Pour modifier le mot de passe d’un compte sur votre appareil, exécutez net user [account-username] [new-password] pour modifier le mot de passe du compte.

Interroger et définir le nom de l’appareil

Pour identifier le nom de votre appareil actuel, tapez hostnamesimplement . Pour modifier le nom de votre appareil Windows IoT Core, tapez SetComputerName [new machinename]. Vous devrez peut-être redémarrer votre appareil pour que le changement de nom prenne effet.

Configuration réseau de base

La plupart des utilitaires de configuration réseau de base que vous connaissez peut-être déjà sont disponibles dans Windows IoT Core, y compris des commandes telles que ping.exe, netstat.exe, netsh.exeipconfig.exe, tracert.exe, et arp.exe.

Utilitaires de copie

Microsoft fournit des outils familiers, notamment sfpcopy.exexcopy.exe.

Process Management

Pour afficher les processus en cours d’exécution, vous pouvez essayer get-process ou .tlist.exe Pour arrêter un processus en cours d’exécution, tapez kill.exe [pid or process name].

Définir l’option de démarrage (démarrage sans tête ou tête)

Les appareils Windows IoT Core peuvent être configurés sur le mode d’appareil dirigé (lorsque des fonctionnalités d’affichage sont requises) ou sans tête (lorsqu’un affichage n’est pas obligatoire ou disponible). Pour modifier ce paramètre, utilisez setbootoption.exe [headed | headless].

Notes

La modification de ce paramètre nécessite un redémarrage pour que la modification prenne effet.

Planificateur de tâches

Pour afficher la liste actuelle des tâches planifiées, utilisez la schtasks.exe commande . Vous pouvez créer de nouvelles tâches avec le /create commutateur ou exécuter des tâches à la demande avec le /run commutateur. Pour obtenir la liste complète des paramètres pris en charge, utilisez schtasks.exe /?

Pilotes d'appareils

L’utilitaire de console de périphérique est utile pour identifier et gérer les périphériques et pilotes installés. Pour obtenir la liste complète des paramètres, utilisez devcon.exe /?

Accès au Registre

Si vous devez accéder au Registre pour afficher ou modifier les paramètres, utilisez la reg.exe /? commande pour obtenir la liste complète des paramètres pris en charge.

Services

La gestion des services Windows peut être effectuée via la net.exe commande . Pour afficher la liste des services en cours d’exécution, tapez net start. Pour démarrer ou arrêter un service spécifique, tapez net [start | stop] [service name]. Vous pouvez également utiliser le gestionnaire de contrôle de service via sc.exe la commande .

Configuration de démarrage

Vous pouvez apporter des modifications à la configuration de démarrage de votre appareil Windows IoT Core à l’aide bcdedit.exede . Pour instance, vous pouvez activer testsigning avec bcdedit –set testsigning on la commande .

Arrêt/redémarrage de l’appareil

Pour arrêter votre appareil, tapez shutdown /s /t 0. Pour redémarrer l’appareil, utilisez le commutateur à la /r place avec la commande shutdown /r /t 0.

Affichage et modification des paramètres d’affichage

L’outil SetDisplayResolution peut être utilisé pour répertorier les paramètres d’affichage actuels et pour afficher la liste des valeurs prises en charge. Il peut également être utilisé pour ajuster la résolution, la fréquence d’actualisation et/ou l’orientation de l’affichage aux valeurs prises en charge par votre plateforme. L’utilitaire accepte les arguments de ligne de commande suivants :

SetDisplayResolution Répertorie la résolution d’affichage actuelle.
SetDisplayResolution -list Répertorie les résolutions d’affichage prises en charge.
SetDisplayResolution -orientation:[n] Modifiez l’orientation de l’affichage, où n=0,90,180 ou 270.
SetDisplayResolution [width] [height] Modifier la largeur et la hauteur en pixels
SetDisplayResolution [width] [height] [refreshrate] Modifier la largeur, la hauteur et la fréquence d’actualisation où la largeur et la hauteur sont exprimées en pixels et la fréquence d’actualisation en Hz
SetDisplayResolution [width] [height] [refreshrate] [orientation] Modifiez la largeur, la hauteur, le taux d’actualisation et l’orientation de l’écran où la largeur et la hauteur sont exprimées en pixels, le taux d’actualisation en Hz et l’orientation est de 0, 90, 180 ou 270.

Capture d’écran

Vous pouvez prendre la capture d’écran de votre appareil Windows IoTCore à l’aide ScreenCapture.exede . Par exemple, l’exécution ScreenCapture c:\folder\screencap.jpg prend la capture d’écran et l’enregistre dans screencap.jpg fichier.

Obtenir des informations sur les cartes réseau

Pour afficher la liste de toutes les cartes réseau disponibles, exécutez GetAdapterInfo l’outil .

Définir les autorisations de dossier pour les applications UWP

Les applications Windows universelles n'ont pas accès à certains dossiers de votre appareil. Pour rendre un dossier accessible à une application UWP, vous pouvez utiliser l’outil FolderPermissions . Par exemple, exécutez FolderPermissions c:\test -e pour accorder aux applications UWP l’accès au c:\test dossier. Notez que cela fonctionne uniquement avec les API Win32 natives, par exemple. CreateFile2 et non avec des API WinRT comme StorageFolder, StorageFile, etc.

Utiliser des ports série

MinComm vous permet d’utiliser des ports série à partir de la ligne de commande. Il est fourni en tant qu’exemple de projet dans le dépôt d’exemples ms-iot.

Usage: MinComm.exe [-list] device_path [baud=<B>] [parity=<P>] [data=<D>] [stop=<S>] [xon={on|off}] [odsr={on|off}] [octs={on|off}] [dtr={on|off|hs}] [rts={on|off|hs|tg}] [idsr={on|off}]

  -list                List all available serial ports on the system and exit.
  device_path          Device path or COM port to open (e.g. COM1)
  baud=<B>             Specifies the transmission rate in bits per second.
  parity={n|e|o|m|s}   Specifies how the system uses the parity bit to check
                       for transmission errors. The abbreviations stand for
                       none, even, odd, mark, and space.
  data={5|6|7|8}       Specifies the number of data bits in a character.
  stop={1|1.5|2}       Specifies the number of stop bits that define the end of
                       a character.
  xon={on|off}         Specifies whether the xon or xoff protocol for data-flow
                       control is on or off.
  odsr={on|off}        Specifies whether output handshaking that uses the
                       Data Set Ready (DSR) circuit is on or off.
  octs={on|off}        Specifies whether output handshaking that uses the
                       Clear To Send (CTS) circuit is on or off.
  dtr={on|off|hs}      Specifies whether the Data Terminal Ready (DTR) circuit
                       is on or off or set to handshake.
  rts={on|off|hs|tg}   Specifies whether the Request To Send (RTS) circuit is
                       set to on, off, handshake, or toggle.
  idsr={on|off}        Specifies whether the DSR circuit sensitivity is on
                       or off.

Parameters that are not specified will default to the port's current
configuration. For more information on the connection parameters, see the
Technet documentation for the Mode command:
  https://technet.microsoft.com/library/cc732236.aspx

Examples:
  Connect to the first serial port found in the port's current configuration:
    MinComm.exe

  List all serial ports on the system:
    MinComm.exe -list

  Open COM1 in 115200 8N1 configuration:
    MinComm.exe COM1 baud=115200 parity=n data=8 stop=1

  Open COM1 in 115200 8N1 configuration:
    MinComm.exe \\.\COM1 baud=115200 parity=n data=8 stop=1

  Open device interface in 115200 8N1 configuration:
    MinComm.exe \\?\USB#VID_FFFF&PID_0005#{86e0d1e0-8089-11d0-9ce4-08003e301f73} baud=115200 parity=n data=8 stop=1

Partager via