Share via

Windows 10 IoT Core utilidades de la línea de comandos

  • Artículo

¿Desea configurar algunas de las opciones en el dispositivo? Las siguientes herramientas están disponibles a su disposición. Use PowerShell para ejecutar estos comandos después de conectarse al dispositivo.

Nota

Estas herramientas no se cargan previamente; deberá incluir los identificadores de características adecuados para obtener estas herramientas en la imagen.

Utilidades de línea de comandos específicas de IoT Core

Configuración de la aplicación de inicio

Use el editor de inicio para configurar aplicaciones de inicio en el dispositivo Windows IoT Core. Ejecute IotStartup con cualquiera de las siguientes opciones:

  • IotStartup list enumera las aplicaciones instaladas
  • IotStartup list headed listas de aplicaciones dirigidas instaladas
  • IotStartup list headless enumera las aplicaciones sin encabezado instaladas
  • IotStartup list [MyApp] enumeración de aplicaciones instaladas que coinciden con el patrón MyApp
  • IotStartup add agrega aplicaciones dirigidas y sin cabeza
  • IotStartup add headed [MyApp] agrega aplicaciones dirigidas que coinciden con el patrón MyApp. El patrón solo debe coincidir con una aplicación.
  • IotStartup add headless [Task1] agrega aplicaciones sin encabezado que coinciden con el patrón Task1
  • IotStartup remove quita aplicaciones de encabezado y sin cabeza
  • IotStartup remove headed [MyApp] quita las aplicaciones dirigidas que coinciden con el patrón MyApp
  • IotStartup remove headless [Task1] quita aplicaciones sin encabezado que coinciden con el patrón Task1
  • IotStartup startup listas dirigidas y aplicaciones sin encabezado registradas para el inicio
  • IotStartup startup [MyApp] listas dirigidas y aplicaciones sin encabezado registradas para el inicio que coinciden con el patrón MyApp
  • IotStartup startup headed [MyApp] listas de aplicaciones dirigidas registradas para el inicio que coinciden MyApp
  • IotStartup startup headless [Task1] enumera las aplicaciones sin encabezado registradas para el inicio que coinciden Task1
  • IotStartup run [MyApp] iniciar la aplicación identificada por MyApp
  • IotStartup stop [MyApp] detener la aplicación identificada por MyApp
  • Para obtener más ayuda, pruebe IotStartup help

Cambio de la configuración de la región y el idioma de usuario o voz

La IoTSettings herramienta cambia la región, el idioma del usuario o el idioma de voz. Se trata de una herramienta de línea de comandos que se puede invocar desde una aplicación mediante processLauncher API. Estos comandos deben ejecutarse como cuenta predeterminada, no como administrador.

  • IotSettings del account {all | username} elimina todas las cuentas de MSA o Azure AD en el sistema o en una cuenta específica. Las cuentas específicas tienen el formato username@provider.com
  • IotSettings del diagnostics elimina información de diagnóstico en la nube para el dispositivo actual. Tenga en cuenta que esto quita el historial hasta el momento de la invocación. Se seguirá registrando la nueva información de diagnóstico.
  • IotSettings list account enumera todas las cuentas de MSA o Azure AD que han iniciado sesión en el dispositivo.
  • IotSettings list uilanguage enumera todos los idiomas de la interfaz de usuario
  • IotSettings list speechlanguage enumera todos los idiomas de voz
  • IotSettings get uilanguage muestra el idioma actual de la interfaz de usuario
  • IotSettings get speechlanguage muestra el idioma de voz actual
  • IotSettings get region muestra la región actual
  • IotSettings set uilanguage language\_tag - (e.g. fr-CA) establece el idioma predeterminado de la interfaz de usuario francés canadiense)
  • IotSettings set speechlanguage language\_tag - (e.g. fr-CA) establece el idioma de voz francés canadiense)
  • IotSettings set region region\_code - (e.g. CA) establece la región predeterminada en Canadá)
  • IotSettings set bluetoothpref {sink | source} Especifica la preferencia de rol bluetooth que se debe seleccionar cuando los dispositivos creados con IOT_BLUETOOTH_A2DP_SOURCE y las características de IOT_BLUETOOTH_A2DP_SINK se conectan a otro dispositivo que también admite ambos roles.
  • IotSettings get bluetoothpref devuelve la preferencia de rol Bluetooth actual para los dispositivos creados con IOT_BLUETOOTH_A2DP_SOURCE y IOT_BLUETOOTH_A2DP_SINK. El valor predeterminado es source.

Sugerencia

IoTSettings -list uiLanguage devolverá la lista del lenguaje de interfaz de usuario admitido (en la versión de la imagen principal de Windows IoT en la que se ha ejecutado).

Cambiar el volumen y el dispositivo de audio predeterminados

La IoTCoreAudioControlTool herramienta controla las opciones relacionadas con el audio, como establecer dispositivos de captura y reproducción predeterminados y cambiar el volumen. Para obtener una lista completa de parámetros, ejecute IoTCoreAudioControlTool h.

Instalación manual de . Archivos APPX

DeployAppx permite instalar y quitar en . Paquetes APPX en escenarios de desarrollo. Método correcto para instalar . Los paquetes APPX en imágenes de producción son usar un paquete de aprovisionamiento como se documenta en el asunto Instalar la aplicación . DeployAppx también admite la consulta de . Información del paquete APPX.

  • DeployAppx install MyApp.appx instala . APPX y el certificado del mismo nombre si se encuentra.
  • DeployAppx install force MyApp.appx fuerza la desinstalación del objeto instalado actualmente. APPX con el mismo nombre de paquete si se encuentra antes de instalar el nuevo . APPX. Esto es útil para instalar un . APPX con el mismo número de versión o inferior que el instalado actualmente. APPX.
  • DeployAppx install retry MyApp.appx vuelva a intentar instalar . APPX 10 veces en caso de error con un retraso de 2 segundos entre intentos.
  • DeployAppx uninstall App_1.0.1.0_x86__publisherid123 desinstale .appx con el nombre completo del paquete coincidente.
  • DeployAppx uninstall MyApp.appx desinstale cualquier instalado . APPX con un nombre de familia de paquete coincidente.
  • DeployAppx getpackages enumera los nombres completos del paquete instalado.
  • DeployAppx getpackageid IotCoreDefaultApp.appx imprime el nombre del paquete, el nombre de familia del paquete y el nombre completo del paquete para . 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 no admitido

Utilidades generales de la línea de comandos

Actualización de la contraseña de la cuenta

Se recomienda encarecidamente actualizar la contraseña predeterminada para la cuenta de administrador. Para ello, puede emitir el siguiente comando: net user Administrator [new password] donde [new password] representa una contraseña segura de su elección.

Crear cuentas de usuario locales

Si desea conceder a otros usuarios acceso al dispositivo Windows IoT Core, puede crear cuentas de usuario locales adicionales mediante PS escribiendo .net user [username] [password] /add Si desea agregar este usuario a otros grupos, como el grupo Administrador, use net localgroup Administrators [username] /add.

Establecimiento de la contraseña

Para cambiar la contraseña en una cuenta del dispositivo, ejecute net user [account-username] [new-password] para cambiar la contraseña de la cuenta.

Consulta y establecimiento del nombre del dispositivo

Para identificar el nombre actual del dispositivo, simplemente escriba hostname. Para cambiar el nombre del dispositivo Windows IoT Core, escriba SetComputerName [new machinename]. Es posible que tenga que reiniciar el dispositivo para que el cambio de nombre surta efecto.

Configuración de red básica

Muchas de las utilidades básicas de configuración de red con las que ya está familiarizado están disponibles en Windows IoT Core, incluidos comandos como ping.exe, , netstat.exenetsh.exe, ipconfig.exe, tracert.exey arp.exe.

Copiar utilidades

Microsoft proporciona herramientas conocidas, entre las que se incluyen sfpcopy.exe , así como xcopy.exe.

Administración de procesos

Para ver los procesos que se están ejecutando actualmente, puede probar get-process o, como alternativa, tlist.exe. Para detener un proceso en ejecución, escriba kill.exe [pid or process name].

Establecer opción de arranque (arranque sin cabeza frente a arranque)

Los dispositivos Windows IoT Core se pueden establecer en encabezado (cuando se requieren funcionalidades de visualización) o sin encabezado (cuando no se requiere o está disponible) el modo de dispositivo. Para cambiar esta configuración, use setbootoption.exe [headed | headless].

Nota

Cambiar esta configuración requerirá un reinicio para que el cambio surta efecto.

Programador de tareas

Para ver la lista actual de tareas programadas, use el schtasks.exe comando . Puede crear nuevas tareas con el /create modificador o ejecutar tareas a petición con el /run modificador. Para obtener una lista completa de los parámetros admitidos, use schtasks.exe /?

Controladores de dispositivo

La utilidad de consola del dispositivo es útil para identificar y administrar los controladores y dispositivos instalados. Para obtener una lista completa de parámetros, use devcon.exe /?

Acceso al Registro

Si necesita acceder al Registro para ver o modificar la configuración, use el reg.exe /? comando para obtener la lista completa de parámetros admitidos.

Servicios

La administración de servicios de Windows se puede realizar mediante el net.exe comando . Para ver una lista de servicios en ejecución, escriba net start. Para iniciar o detener un servicio específico, escriba net [start | stop] [service name]. Como alternativa, también puede usar el administrador de control de servicio mediante el sc.exe comando .

Configuración de arranque

Puede realizar cambios en la configuración de arranque del dispositivo Windows IoT Core mediante bcdedit.exe. Por ejemplo, puede habilitar testsigning con bcdedit –set testsigning on el comando .

Apagar o reiniciar el dispositivo

Para apagar el dispositivo, escriba shutdown /s /t 0. Para reiniciar el dispositivo, use el /r modificador en su lugar con el comando shutdown /r /t 0.

Visualización y cambio de la configuración de visualización

La herramienta SetDisplayResolution se puede usar para enumerar la configuración de visualización actual y mostrar la lista de valores admitidos. También se puede usar para ajustar la resolución de la pantalla, la frecuencia de actualización o la orientación a los valores admitidos por la plataforma. La utilidad acepta los argumentos de la línea de comandos siguientes:

  • SetDisplayResolution Enumera la resolución de visualización actual.
  • SetDisplayResolution -list Enumera las resoluciones de visualización admitidas.
  • SetDisplayResolution -orientation:[n] Cambie la orientación de la pantalla, donde n=0,90,180 o 270.
  • SetDisplayResolution [width] [height] Cambiar el ancho y el alto en píxeles
  • SetDisplayResolution [width] [height] [refreshrate] Cambiar ancho, alto y frecuencia de actualización donde el ancho y el alto están en píxeles y la velocidad de actualización en Hz
  • SetDisplayResolution [width] [height] [refreshrate] [orientation] Cambie el ancho, el alto, la velocidad de actualización y la orientación de la pantalla donde el ancho y el alto están en píxeles, la velocidad de actualización en Hz y la orientación es de 0, 90, 180 o 270.

Captura de pantalla de toma de pantalla

Puede tomar la captura de pantalla del dispositivo Windows IoTCore mediante ScreenCapture.exe. Por ejemplo, ejecutará ScreenCapture c:\folder\screencap.jpg la captura de pantalla y la guardará en screencap.jpg archivo.

Obtener información sobre los adaptadores de red

Para ver la lista de todos los adaptadores de red disponibles, ejecute GetAdapterInfo la herramienta .

Establecer permisos de carpeta para aplicaciones para UWP

No todas las carpetas del dispositivo son accesibles para las aplicaciones universales de Windows. Para que una carpeta sea accesible para una aplicación para UWP, puedes usar FolderPermissions la herramienta . Por ejemplo, ejecute FolderPermissions c:\test -e para conceder a las aplicaciones para UWP acceso a la c:\test carpeta. Tenga en cuenta que esto solo funcionará con api nativas de Win32 para, por ejemplo, . CreateFile2 y no con api de WinRT como StorageFolder, StorageFile, etc.

Trabajar con puertos serie

MinComm permite trabajar con puertos serie desde la línea de comandos. Se proporciona como un proyecto de ejemplo en el repositorio de ejemplos 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