Windows 10 IoT Core Utils de Linha de Comando

Artigo
04/03/2023

Deseja definir algumas das configurações em seu dispositivo? As ferramentas abaixo estão disponíveis à sua disposição. Use o PowerShell para executar esses comandos depois de se conectar ao seu dispositivo.

Observação

Essas ferramentas não são pré-carregadas– você precisará incluir as IDs de recurso apropriadas para obter essas ferramentas na imagem.

Utils de linha de comando específicos do IoT Core

Configurando o aplicativo de inicialização

Use o editor de inicialização para configurar aplicativos de inicialização em seu dispositivo Windows IoT Core. Execute IotStartup com qualquer uma das seguintes opções:

IotStartup list lista aplicativos instalados
IotStartup list headed lista aplicativos de cabeça dura instalados
IotStartup list headless lista aplicativos sem cabeça instalados
IotStartup list [MyApp] listar aplicativos instalados que correspondem ao padrão MyApp
IotStartup add adiciona aplicativos cabeçalho e sem cabeça
IotStartup add headed [MyApp] adiciona aplicativos cabeça-dura que correspondem ao padrão MyApp. O padrão deve corresponder apenas a um aplicativo.
IotStartup add headless [Task1] adiciona aplicativos sem cabeça que correspondem ao padrão Task1
IotStartup remove remove aplicativos cabeçalho e sem cabeça
IotStartup remove headed [MyApp] remove aplicativos cabeça-dura que correspondem ao padrão MyApp
IotStartup remove headless [Task1] remove aplicativos sem cabeça que correspondem ao padrão Task1
IotStartup startup lista aplicativos com cabeçalho e sem cabeça registrados para inicialização
IotStartup startup [MyApp] lista aplicativos com cabeçalho e sem cabeça registrados para inicialização que correspondem ao padrão MyApp
IotStartup startup headed [MyApp] lista aplicativos de cabeça dura registrados para inicialização que correspondem MyApp
IotStartup startup headless [Task1] lista aplicativos sem cabeça registrados para inicialização que correspondem Task1
IotStartup run [MyApp] iniciar aplicativo identificado por MyApp
IotStartup stop [MyApp] parar aplicativo identificado por MyApp
Para obter mais ajuda, tente IotStartup help

Alterar as configurações para a região e o idioma do usuário ou da fala

A IoTSettings ferramenta altera a região, o idioma do usuário ou a linguagem de fala. Essa é uma ferramenta de linha de comando que pode ser invocada de um aplicativo usando a API ProcessLauncher. Esses comandos devem ser executados como conta padrão, não como administrador.

IotSettings del account {all | username}exclui todas as contas msa ou Azure AD no sistema ou em uma conta específica. Contas específicas tomam o formulário username@provider.com
IotSettings del diagnostics exclui informações de diagnóstico na nuvem para o dispositivo atual. Observe que isso remove o histórico até o momento da invocação. Novas informações de diagnóstico continuarão a ser registradas.
IotSettings list accountlista todas as contas msa ou Azure AD que foram assinadas no dispositivo.
IotSettings list uilanguage lista todos os idiomas da interface do usuário
IotSettings list speechlanguage lista todos os idiomas de fala
IotSettings get uilanguage exibe a linguagem de interface do usuário atual
IotSettings get speechlanguage exibe a linguagem de fala atual
IotSettings get region exibe a região atual
IotSettings set uilanguage language\_tag - (e.g. fr-CA) define o idioma padrão da interface do usuário em francês canadense)
IotSettings set speechlanguage language\_tag - (e.g. fr-CA) define a linguagem de fala francês canadense)
IotSettings set region region\_code - (e.g. CA) define a região padrão para o Canadá)
IotSettings set bluetoothpref {sink | source} Especifica a preferência de função Bluetooth a ser selecionada quando dispositivos criados com recursos IOT_BLUETOOTH_A2DP_SOURCE e IOT_BLUETOOTH_A2DP_SINK se conectam a outro dispositivo que também dá suporte a ambas as funções.
IotSettings get bluetoothpref retorna a preferência de função Bluetooth atual para dispositivos criados com IOT_BLUETOOTH_A2DP_SOURCE e IOT_BLUETOOTH_A2DP_SINK. O padrão é a origem.

Dica

IoTSettings -list uiLanguage retornará a lista de linguagem de interface do usuário com suporte (na versão da imagem de núcleo do Windows IoT em que ela foi executada)

Alterar o dispositivo de áudio e o volume padrão

A IoTCoreAudioControlTool ferramenta controla opções relacionadas ao áudio, como definir dispositivos de captura e reprodução padrão e alterar o volume. Para obter uma lista completa de parâmetros, execute IoTCoreAudioControlTool h.

Instalando manualmente . Arquivos APPX

DeployAppx habilita a instalação e a remoção no . Pacotes APPX em cenários de desenvolvimento. O método correto para instalar o . Os pacotes APPX em imagens de produção são para usar um pacote de provisionamento, conforme documentado no assunto Instalar seu aplicativo . DeployAppx também dá suporte à consulta . Informações do pacote APPX.

DeployAppx install MyApp.appx instala o . APPX e o certificado com o mesmo nome, se encontrado.
DeployAppx install force MyApp.appx força a desinstalação do atualmente instalado. APPX com o mesmo nome de pacote se encontrado antes de instalar o novo . APPX. Isso é útil para instalar um . APPX com o mesmo número de versão ou menor que o atualmente instalado. APPX.
DeployAppx install retry MyApp.appx tente instalar novamente o . APPX 10 vezes em caso de falha com atraso de 2 segundos entre tentativas.
DeployAppx uninstall App_1.0.1.0_x86__publisherid123 desinstale o .appx com o nome completo do pacote correspondente.
DeployAppx uninstall MyApp.appx desinstale qualquer instalado. APPX com um nome de família de pacotes correspondente.
DeployAppx getpackages lista os nomes completos do pacote instalado.
DeployAppx getpackageid IotCoreDefaultApp.appx imprime o nome do pacote, o nome da família do pacote e o nome completo do pacote para o . 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 Linha de Comando Geral

Atualizar senha da conta

É altamente recomendável que você atualize a senha padrão para a conta de Administrador. Para fazer isso, você pode emitir o seguinte comando: net user Administrator [new password] em que [new password] representa uma senha forte de sua escolha.

Criar contas de usuário local

Se você quiser dar a outras pessoas acesso ao seu dispositivo Windows IoT Core, poderá criar contas de usuário locais adicionais usando PS digitando em net user [username] [password] /add. Se você quiser adicionar esse usuário a outros grupos, como o grupo Administrador, use net localgroup Administrators [username] /add.

Definir senha

Para alterar a senha em uma conta em seu dispositivo, execute net user [account-username] [new-password] para alterar a senha da conta.

Consultar e definir o nome do dispositivo

Para identificar o nome do dispositivo atual, basta digitar hostname. Para alterar o nome do dispositivo Windows IoT Core, digite SetComputerName [new machinename]. Talvez seja necessário reiniciar o dispositivo para que a alteração de nome entre em vigor.

Configuração de rede básica

Muitos dos utilitários básicos de configuração de rede com os quais você já pode estar familiarizado estão disponíveis no Windows IoT Core, incluindo comandos como ping.exe, , netstat.exenetsh.exe, ipconfig.exe, tracert.exee arp.exe.

Copiar utilitários

A Microsoft está fornecendo ferramentas familiares, incluindo sfpcopy.exe também xcopy.exe.

Gerenciamento de processo

Para exibir os processos em execução no momento, você pode tentar get-process ou, como alternativa, tlist.exe. Para interromper um processo em execução, digite kill.exe [pid or process name].

Definir opção de inicialização (inicialização sem cabeça versus cabeçalho)

Os dispositivos Windows IoT Core podem ser definidos como cabeçalho (quando recursos de exibição são necessários) ou sem cabeça (quando uma exibição não é necessária ou disponível) modo de dispositivo. Para alterar essa configuração, use setbootoption.exe [headed | headless].

Observação

Alterar essa configuração exigirá uma reinicialização para que a alteração entre em vigor.

Agendador de tarefas

Para exibir a lista atual de tarefas agendadas, use o schtasks.exe comando . Você pode criar novas tarefas com a opção /create ou executar tarefas sob demanda com a opção /run . Para obter uma lista completa de parâmetros com suporte, use schtasks.exe /?

Drivers de dispositivo

O utilitário de console do dispositivo é útil para identificar e gerenciar drivers e dispositivos instalados. Para obter uma lista completa de parâmetros, use devcon.exe /?

Acesso ao Registro

Se você precisar acessar o registro para exibir ou modificar as configurações, use o reg.exe /? Comando para obter a lista completa de parâmetros com suporte.

Serviços

O gerenciamento de serviços do Windows pode ser feito por meio do net.exe comando . Para ver uma lista de serviços em execução, digite net start. Para iniciar ou parar um serviço específico, digite net [start | stop] [service name]. Como alternativa, você também pode usar o gerenciador de controle de serviço por meio sc.exe do comando .

Configuração da inicialização

Você pode fazer alterações na configuração de inicialização do dispositivo Windows IoT Core usando bcdedit.exe. Por exemplo, você pode habilitar a atribuição de teste com bcdedit –set testsigning on o comando .

Desligar/reiniciar dispositivo

Para desligar o dispositivo, digite shutdown /s /t 0. Para reiniciar o dispositivo, use a opção /r com o comando shutdown /r /t 0.

Exibindo e alterando as configurações de exibição

A ferramenta SetDisplayResolution pode ser usada para listar as configurações de exibição atuais e mostrar a lista de valores com suporte. Ele ainda pode ser usado para ajustar a resolução, a taxa de atualização e/ou a orientação da tela para valores compatíveis com sua plataforma. O utilitário aceita os seguintes argumentos de linha de comando:

SetDisplayResolution Lista a resolução de exibição atual.
SetDisplayResolution -list Lista resoluções de exibição com suporte.
SetDisplayResolution -orientation:[n] Altere a orientação de exibição, em que n=0,90,180 ou 270.
SetDisplayResolution [width] [height] Alterar a largura e a altura em pixels
SetDisplayResolution [width] [height] [refreshrate] Alterar largura, altura e taxa de atualização em que largura e altura estão em pixels e taxa de atualização no Hz
SetDisplayResolution [width] [height] [refreshrate] [orientation] Alterar largura, altura, taxa de atualização e orientação da tela em que largura e altura estão em pixels, a taxa de atualização em Hz e a orientação é de 0, 90, 180 ou 270.

Captura de tela

Você pode tirar a captura de tela do seu dispositivo Windows IoTCore usando ScreenCapture.exe. Por exemplo, a execução ScreenCapture c:\folder\screencap.jpg fará a captura de tela e a salvará em screencap.jpg arquivo.

Obter informações sobre adaptadores de rede

Para exibir a lista de todos os adaptadores de rede disponíveis, execute GetAdapterInfo a ferramenta.

Definir permissões de pasta para aplicativos UWP

Nem todas as pastas do dispositivo podem ser acessadas por aplicativos universais do Windows. Para tornar uma pasta acessível a um aplicativo UWP, você pode usar FolderPermissions a ferramenta . Por exemplo, execute FolderPermissions c:\test -e para dar aos aplicativos UWP acesso à c:\test pasta. Observe que isso funcionará apenas com apis nativas do Win32, por exemplo. CreateFile2 e não com apis do WinRT como StorageFolder, StorageFile etc.

Trabalhar com portas seriais

MinComm permite que você trabalhe com portas seriais na linha de comando. Ele é fornecido como um projeto de exemplo no repositório de exemplos 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

Compartilhar via