Windows 10 IoT Core Befehlszeilenhilfsprogramme

Möchten Sie einige der Einstellungen auf Ihrem Gerät konfigurieren? Die folgenden Tools stehen Ihnen zur Verfügung. Verwenden Sie PowerShell, um diese Befehle auszuführen, nachdem Sie eine Verbindung mit Ihrem Gerät hergestellt haben.

Hinweis

Diese Tools sind nicht vorab geladen. Sie müssen entsprechende Feature-IDs einschließen, um diese Tools in das Image zu erhalten.

IoT Core-spezifische Befehlszeilenhilfsprogramme

Festlegen der Start-App

Verwenden Sie den Start-Editor, um Start-Apps auf Ihrem Windows IoT Core-Gerät zu konfigurieren. Führen Sie IotStartup mit einer der folgenden Optionen aus:

  • IotStartup list Listet installierte Anwendungen auf
  • IotStartup list headed Listet installierte Spitzenanwendungen auf
  • IotStartup list headless Listet installierte headless-Anwendungen auf.
  • IotStartup list [MyApp] Auflisten installierter Anwendungen, die dem Muster entsprechen MyApp
  • IotStartup add fügt Kopf- und Kopflose Anwendungen hinzu
  • IotStartup add headed [MyApp] fügt Spitzenanwendungen hinzu, die dem Muster MyAppentsprechen. Das Muster darf nur mit einer Anwendung übereinstimmen.
  • IotStartup add headless [Task1] Fügt kopflose Anwendungen hinzu, die dem Muster entsprechen Task1
  • IotStartup remove entfernt Kopf- und Kopflose Anwendungen
  • IotStartup remove headed [MyApp] Entfernt Kopfanwendungen, die dem Muster entsprechen MyApp
  • IotStartup remove headless [Task1] Entfernt kopflose Anwendungen, die dem Muster entsprechen Task1
  • IotStartup startup listet kopf- und kopflose Anwendungen auf, die für den Start registriert sind
  • IotStartup startup [MyApp] Listet spitzen- und kopflose Anwendungen auf, die für den Start registriert wurden, die dem Muster entsprechen MyApp
  • IotStartup startup headed [MyApp] listet für den Start registrierte Anwendungen auf, die übereinstimmen MyApp
  • IotStartup startup headless [Task1] Listet für den Start registrierte Anwendungen ohne Kopf auf, die übereinstimmen Task1
  • IotStartup run [MyApp] Start-App identifiziert durch MyApp
  • IotStartup stop [MyApp] Beenden der App, die durch identifiziert wird MyApp
  • Weitere Hilfe: IotStartup help

Ändern von Einstellungen für Region und Benutzer oder Sprache

Das IoTSettings Tool ändert die Region, die Benutzersprache oder die Sprachsprache. Dies ist ein Befehlszeilentool, das über eine Anwendung mit der ProcessLauncher-API aufgerufen werden kann. Diese Befehle müssen als Standardkonto und nicht als Administrator ausgeführt werden.

  • IotSettings del account {all | username} löscht alle MSA- oder Azure AD-Konten auf dem System oder einem bestimmten Konto. Bestimmte Konten haben die Form username@provider.com
  • IotSettings del diagnostics löscht Diagnoseinformationen in der Cloud für das aktuelle Gerät. Beachten Sie, dass dadurch der Verlauf bis zum Zeitpunkt des Aufrufs entfernt wird. Neue Diagnose Informationen werden weiterhin protokolliert.
  • IotSettings list account listet alle MSA- oder Azure AD-Konten auf, die beim Gerät angemeldet wurden.
  • IotSettings list uilanguage listet alle Benutzeroberflächensprachen auf
  • IotSettings list speechlanguage listet alle Sprachsprachen auf.
  • IotSettings get uilanguage zeigt die aktuelle Ui-Sprache an.
  • IotSettings get speechlanguage zeigt die aktuelle Sprachsprache an.
  • IotSettings get region zeigt die aktuelle Region an.
  • IotSettings set uilanguage language\_tag - (e.g. fr-CA) legt die Standardsprache der Benutzeroberfläche Französisch (Kanadier) fest.
  • IotSettings set speechlanguage language\_tag - (e.g. fr-CA) legt die Sprache Französisch-Kanadier fest)
  • IotSettings set region region\_code - (e.g. CA) legt die Standardregion auf Kanada fest)
  • IotSettings set bluetoothpref {sink | source} Gibt die Bluetooth-Rollenpräferenz an, die ausgewählt werden soll, wenn Geräte, die sowohl mit IOT_BLUETOOTH_A2DP_SOURCE- als auch mit IOT_BLUETOOTH_A2DP_SINK Features erstellt wurden, eine Verbindung mit einem anderen Gerät herstellen, das auch beide Rollen unterstützt.
  • IotSettings get bluetoothpref gibt die aktuelle Bluetooth-Rolleneinstellung für Geräte zurück, die sowohl mit IOT_BLUETOOTH_A2DP_SOURCE als auch mit IOT_BLUETOOTH_A2DP_SINK erstellt wurden. Der Standardwert ist source.

Tipp

IoTSettings -list uiLanguage gibt die Liste der unterstützten Benutzeroberflächensprache zurück (in der Version des Windows IoT Core-Images wurde es für ausgeführt)

Ändern des Standardaudiogeräts und der Lautstärke

Das IoTCoreAudioControlTool Tool steuert audiobezogene Optionen, z. B. das Festlegen von Standardaufnahme- und Wiedergabegeräten und das Ändern der Lautstärke. Um eine vollständige Liste der Parameter zu finden, führen Sie aus IoTCoreAudioControlTool h.

Manuelles Installieren von . APPX-Dateien

DeployAppx ermöglicht das Installieren und Entfernen in . APPX-Pakete in Entwicklungsszenarien. Die richtige Methode zum Installieren von . APPX-Pakete in Produktionsimages verwenden ein Bereitstellungspaket, wie im Thema Installieren der App dokumentiert. DeployAppx unterstützt auch abfragen. APPX-Paketinformationen.

  • DeployAppx install MyApp.appx installiert . APPX und das Zertifikat mit demselben Namen, falls gefunden.
  • DeployAppx install force MyApp.appx erzwingt die Deinstallation der aktuell installierten . APPX mit demselben Paketnamen, wenn vor der Installation des neuen gefunden wird. APPX. Dies ist nützlich für die Installation von . APPX mit der gleichen oder niedrigeren Versionsnummer wie die aktuell installierte . APPX.
  • DeployAppx install retry MyApp.appx Versuchen Sie erneut, das zu installieren. APPX 10 mal bei Fehler mit einer Verzögerung von 2 Sekunden zwischen den Versuchen.
  • DeployAppx uninstall App_1.0.1.0_x86__publisherid123 deinstallieren Sie die APPX-Datei mit dem vollständigen Namen des entsprechenden Pakets.
  • DeployAppx uninstall MyApp.appx deinstallieren Sie alle installierten . APPX mit einem übereinstimmenden Paketfamiliennamen.
  • DeployAppx getpackages listet die vollständigen Namen des installierten Pakets auf.
  • DeployAppx getpackageid IotCoreDefaultApp.appx gibt den Paketnamen, den Paketfamiliennamen und den vollständigen Paketnamen für aus. 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 nicht unterstützt

Allgemeine Befehlszeilenhilfsprogramme

Aktualisieren des Kontokennworts

Es wird dringend empfohlen, das Standardkennwort für das Administratorkonto zu aktualisieren. Dazu können Sie den folgenden Befehl ausführen: net user Administrator [new password] wobei [new password] ein sicheres Kennwort Ihrer Wahl darstellt.

Erstellen lokaler Benutzerkonten

Wenn Sie anderen Zugriff auf Ihr Windows IoT Core-Gerät gewähren möchten, können Sie mithilfe von PS zusätzliche lokale Benutzerkonten erstellen, indem Sie in net user [username] [password] /addeingeben. Wenn Sie diesen Benutzer anderen Gruppen hinzufügen möchten, z. B. der Administratorgruppe, verwenden Sie net localgroup Administrators [username] /add.

Festlegen des Kennworts

Um das Kennwort für ein Konto auf Ihrem Gerät zu ändern, führen Sie aus net user [account-username] [new-password] , um das Kontokennwort zu ändern.

Abfragen und Festlegen des Gerätenamens

Geben Sie einfach ein hostname, um Ihren aktuellen Gerätenamen zu identifizieren. Um den Namen Ihres Windows IoT Core-Geräts zu ändern, geben Sie ein SetComputerName [new machinename]. Möglicherweise müssen Sie Ihr Gerät neu starten, damit die Namensänderung wirksam wird.

Grundlegende Netzwerkkonfiguration

Viele der grundlegenden Netzwerkkonfigurationsprogramme, mit denen Sie möglicherweise bereits vertraut sind, sind in Windows IoT Core verfügbar, einschließlich Befehlen wie ping.exe, , netsh.exenetstat.exe, tracert.exeipconfig.exe, und arp.exe.

Kopieren von Hilfsprogrammen

Microsoft stellt vertraute Tools bereit, einschließlich sfpcopy.exe sowie xcopy.exe.

Prozessverwaltung

Um derzeit ausgeführte Prozesse anzuzeigen, können Sie entweder get-process oder alternativ tlist.exeausprobieren. Um einen ausgeführten Prozess zu beenden, geben Sie ein kill.exe [pid or process name].

Startoption festlegen (headless vs. headless boot)

Windows IoT Core-Geräte können auf den Gerätemodus "Head" (wenn Anzeigefunktionen erforderlich) oder "headless" (wenn keine Anzeige erforderlich oder verfügbar ist) festgelegt werden. Um diese Einstellung zu ändern, verwenden Sie setbootoption.exe [headed | headless].

Hinweis

Wenn Sie diese Einstellung ändern, ist ein Neustart erforderlich, damit die Änderung wirksam wird.

Taskplaner

Verwenden Sie den Befehl, um die schtasks.exe aktuelle Liste der geplanten Aufgaben anzuzeigen. Sie können neue Aufgaben mit dem /create Switch erstellen oder Bedarfsgesteuerte Aufgaben mit dem /run Switch ausführen. Eine vollständige Liste der unterstützten Parameter finden Sie unter schtasks.exe /?

Gerätetreiber

Das Gerätekonsolen-Hilfsprogramm ist nützlich, um installierte Geräte und Treiber zu identifizieren und zu verwalten. Eine vollständige Liste der Parameter finden Sie unter devcon.exe /?

Zugriff auf die Registrierung

Wenn Sie auf die Registrierung zugreifen müssen, um Einstellungen anzuzeigen oder zu ändern, verwenden Sie den reg.exe /? Befehl für die vollständige Liste der unterstützten Parameter.

Dienste

Die Verwaltung von Windows-Diensten kann über den net.exe Befehl erfolgen. Um eine Liste der ausgeführten Dienste anzuzeigen, geben Sie ein net start. Um einen bestimmten Dienst zu starten oder zu beenden, geben Sie ein net [start | stop] [service name]. Alternativ können Sie auch den Dienststeuerungs-Manager über sc.exe den Befehl verwenden.

Startkonfiguration

Sie können änderungen an der Startkonfiguration Ihres Windows IoT Core-Geräts vornehmen, indem Sie verwenden bcdedit.exe. Für instance können Sie die Testsignierung mit dem bcdedit –set testsigning on Befehl aktivieren.

Gerät herunterfahren/neu starten

Um Ihr Gerät herunterzufahren, geben Sie ein shutdown /s /t 0. Um das Gerät neu zu starten, verwenden Sie stattdessen den /r Schalter mit dem Befehl shutdown /r /t 0.

Anzeigen und Ändern von Anzeigeeinstellungen

Das SetDisplayResolution-Tool kann verwendet werden, um die aktuellen Anzeigeeinstellungen aufzulisten und die Liste der unterstützten Werte anzuzeigen. Es kann auch verwendet werden, um die Auflösung, Aktualisierungsrate und/oder Ausrichtung der Anzeige an werte anzupassen, die von Ihrer Plattform unterstützt werden. Das Hilfsprogramm akzeptiert die folgenden Befehlszeilenargumente:

  • SetDisplayResolution Listet die aktuelle Anzeigeauflösung auf.
  • SetDisplayResolution -list Listet unterstützte Anzeigeauflösungen auf.
  • SetDisplayResolution -orientation:[n] Ändern Sie die Anzeigeausrichtung, wobei n=0,90,180 oder 270 ist.
  • SetDisplayResolution [width] [height] Ändern der Breite und Höhe in Pixel
  • SetDisplayResolution [width] [height] [refreshrate] Ändern von Breite, Höhe und Aktualisierungsrate, wobei Breite und Höhe in Pixel und Aktualisierungsrate in Hz angegeben sind
  • SetDisplayResolution [width] [height] [refreshrate] [orientation] Ändern Sie Breite, Höhe, Aktualisierung und Bildschirmausrichtung, wobei Breite und Höhe in Pixeln, Aktualisierung in Hz und Die Ausrichtung eine von 0, 90, 180 oder 270 ist.

Screenshot erstellen

Sie können den Screenshot Ihres Windows IoTCore-Geräts erstellen, indem Sie verwenden ScreenCapture.exe. Mit run ScreenCapture c:\folder\screencap.jpg wird beispielsweise der Screenshot erstellt und in screencap.jpg Datei gespeichert.

Abrufen von Informationen zu Netzwerkadaptern

Führen GetAdapterInfo Sie das Tool aus, um die Liste aller verfügbaren Netzwerkadapter anzuzeigen.

Festlegen von Ordnerberechtigungen für UWP-Apps

Universal Windows-Apps können nicht auf alle Ordner auf Ihrem Gerät zugreifen. Um einen Ordner für eine UWP-App zugänglich zu machen, können Sie das Tool verwenden FolderPermissions . Führen Sie beispielsweise aus FolderPermissions c:\test -e , um UWP-Apps Zugriff auf den Ordner zu c:\test gewähren. Beachten Sie, dass dies nur mit nativen Win32-APIs funktioniert, z. B. CreateFile2 und nicht mit WinRT-APIs wie StorageFolder, StorageFile usw.

Arbeiten mit seriellen Ports

Mit MinComm können Sie über die Befehlszeile mit seriellen Ports arbeiten. Es wird als Beispielprojekt im Repository ms-iot-Beispiele bereitgestellt.

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