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 aufIotStartup list headed
Listet installierte Spitzenanwendungen aufIotStartup list headless
Listet installierte headless-Anwendungen auf.IotStartup list [MyApp]
Auflisten installierter Anwendungen, die dem Muster entsprechenMyApp
IotStartup add
fügt Kopf- und Kopflose Anwendungen hinzuIotStartup add headed [MyApp]
fügt Spitzenanwendungen hinzu, die dem MusterMyApp
entsprechen. Das Muster darf nur mit einer Anwendung übereinstimmen.IotStartup add headless [Task1]
Fügt kopflose Anwendungen hinzu, die dem Muster entsprechenTask1
IotStartup remove
entfernt Kopf- und Kopflose AnwendungenIotStartup remove headed [MyApp]
Entfernt Kopfanwendungen, die dem Muster entsprechenMyApp
IotStartup remove headless [Task1]
Entfernt kopflose Anwendungen, die dem Muster entsprechenTask1
IotStartup startup
listet kopf- und kopflose Anwendungen auf, die für den Start registriert sindIotStartup startup [MyApp]
Listet spitzen- und kopflose Anwendungen auf, die für den Start registriert wurden, die dem Muster entsprechenMyApp
IotStartup startup headed [MyApp]
listet für den Start registrierte Anwendungen auf, die übereinstimmenMyApp
IotStartup startup headless [Task1]
Listet für den Start registrierte Anwendungen ohne Kopf auf, die übereinstimmenTask1
IotStartup run [MyApp]
Start-App identifiziert durchMyApp
IotStartup stop [MyApp]
Beenden der App, die durch identifiziert wirdMyApp
- 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.comIotSettings 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 aufIotSettings 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] /add
eingeben. 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.exe
netstat.exe
, tracert.exe
ipconfig.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.exe
ausprobieren. 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 PixelSetDisplayResolution [width] [height] [refreshrate]
Ändern von Breite, Höhe und Aktualisierungsrate, wobei Breite und Höhe in Pixel und Aktualisierungsrate in Hz angegeben sindSetDisplayResolution [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