Partilhar via


dispositivo az sphere

Gerir dispositivos do Azure Sphere.

Operação Descrição
az sphere device rescan-attached Mostrar o número de dispositivos ligados.
az sphere device list-attached Listar todos os dispositivos anexados.
az sphere device show-attached Mostrar os detalhes do dispositivo anexado.
az sphere device list Liste todos os dispositivos no seu catálogo, produto ou grupo de dispositivos.
az sphere device show-count Mostrar o número de dispositivos no seu catálogo, produto ou grupo de dispositivos.
az sphere device show Mostrar detalhes de um dispositivo existente no seu grupo de recursos e catálogo.
az sphere device assign Atribua um dispositivo a um grupo de dispositivos no seu grupo de recursos e catálogo.
az sphere device unassign Anular a atribuição de um dispositivo a partir de um grupo de dispositivos no seu grupo de recursos e catálogo.
az sphere device restart Reinicie o dispositivo ligado.
az sphere device claim Reclame um dispositivo no seu grupo de recursos e catálogo.
az sphere device recover Utilize o modo de recuperação para carregar o novo firmware para o dispositivo ligado.
az sphere device show-os-version Mostrar a versão do sistema operativo no dispositivo anexado.
az sphere device show-deployment-status Mostrar o estado de implementação do sistema operativo num dispositivo.
az sphere device enable-development "Ative um dispositivo para desenvolvimento ao ativar o sideload e a depuração no dispositivo anexado e ao atribuí-lo a um grupo de dispositivos que desativa as atualizações da aplicação a partir da cloud. Por predefinição, este será o grupo Dispositivo de desenvolvimento do produto do dispositivo, mas podem ser especificados outros grupos de dispositivos. Não para utilização em cenários de fabrico
az sphere device enable-cloud-test "Ative um dispositivo para testar o carregamento na cloud ao desativar o desenvolvimento e a depuração no dispositivo anexado e ao atribuí-lo a um grupo de dispositivos que permite atualizações de aplicações a partir da cloud. Por predefinição, este será o grupo de dispositivos Teste de Campo do produto do dispositivo, mas podem ser especificados outros grupos de dispositivos. Não para utilização em cenários de fabrico

Comandos

az sphere device rescan-attached

Mostrar o número de dispositivos ligados.

Parâmetros Necessários

Parâmetro Descrição
--catalog -c O Catálogo do Azure Sphere no qual deve efetuar esta operação. Especifique o nome do Catálogo do Azure Sphere. Pode configurar o Catálogo do Azure Sphere predefinido com az config set defaults.sphere.catalog=<name>. Valores de: az sphere catalog list.
--resource-group -r Nome do grupo de recursos do Azure. Pode configurar o grupo predefinido com az config set defaults.group=<name>. Valores de: az group list.

Exemplos

Mostrar o número de dispositivos ligados.

az sphere device rescan-attached

az sphere device list-attached

Listar todos os dispositivos anexados.

Parâmetros Necessários

Parâmetro Descrição
--catalog -c O Catálogo do Azure Sphere no qual deve efetuar esta operação. Especifique o nome do Catálogo do Azure Sphere. Pode configurar o Catálogo do Azure Sphere predefinido com az config set defaults.sphere.catalog=<name>. Valores de: az sphere catalog list.
--resource-group -r Nome do grupo de recursos do Azure. Pode configurar o grupo predefinido com az config set defaults.group=<name>. Valores de: az group list.

Exemplos

Listar todos os dispositivos anexados.

az sphere device list-attached

az sphere device show-attached

Mostrar os detalhes do dispositivo anexado.

Parâmetros Necessários

Parâmetro Descrição
--catalog -c O Catálogo do Azure Sphere no qual deve efetuar esta operação. Especifique o nome do Catálogo do Azure Sphere. Pode configurar o Catálogo do Azure Sphere predefinido com az config set defaults.sphere.catalog=<name>. Valores de: az sphere catalog list.
--resource-group -r Nome do grupo de recursos do Azure. Pode configurar o grupo predefinido com az config set defaults.group=<name>. Valores de: az group list.

Parâmetros Opcionais

Parâmetro Descrição
--device -d O dispositivo no qual executar o comando quando vários dispositivos estão ligados. Especifique o ID, o endereço IP ou o ID de Ligação Local de um dispositivo ligado. Valores de: az sphere device list

Exemplos

Mostrar detalhes do dispositivo anexado.

az sphere device show-attached

Mostrar detalhes do dispositivo especificado.

az sphere device show-attached --device <DeviceIdValue>

az sphere device list

Liste todos os dispositivos no seu catálogo, produto ou grupo de dispositivos.

Parâmetros Necessários

Parâmetro Descrição
--catalog -c O Catálogo do Azure Sphere no qual deve efetuar esta operação. Especifique o nome do Catálogo do Azure Sphere. Pode configurar o Catálogo do Azure Sphere predefinido com az config set defaults.sphere.catalog=<name>. Valores de: az sphere catalog list.
--resource-group -r Nome do grupo de recursos do Azure. Pode configurar o grupo predefinido com az config set defaults.group=<name>. Valores de: az group list.

Parâmetros Opcionais

Parâmetro Descrição
--product -p O nome do produto. Valores de: az sphere product list
--device-group -dg O grupo de dispositivos a mostrar. Valores de: az sphere device

Exemplos

Listar todos os dispositivos num grupo de recursos e catálogo.

az sphere device list --resource-group MyResourceGroup --catalog MyCatalog

Listar todos os dispositivos num grupo de recursos, catálogo e produto.

az sphere device list --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct

Listar todos os dispositivos num grupo de recursos, catálogo, produto e grupo de dispositivos.

az sphere device list --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup

az sphere device show-count

Mostrar o número de dispositivos no seu catálogo, produto ou grupo de dispositivos.

Parâmetros Necessários

Parâmetro Descrição
--catalog -c O Catálogo do Azure Sphere no qual deve efetuar esta operação. Especifique o nome do Catálogo do Azure Sphere. Pode configurar o Catálogo do Azure Sphere predefinido com az config set defaults.sphere.catalog=<name>. Valores de: az sphere catalog list.
--resource-group -r Nome do grupo de recursos do Azure. Pode configurar o grupo predefinido com az config set defaults.group=<name>. Valores de: az group list.

Parâmetros Opcionais

Parâmetro Descrição
--product -p O nome do produto. Valores de: az sphere product list
--device-group -dg O grupo de dispositivos a mostrar. Valores de: az sphere device

Exemplos

Mostrar o número de dispositivos num grupo de recursos e catálogo.

az sphere device show-count --resource-group MyResourceGroup --catalog MyCatalog

Mostrar o número de dispositivos num grupo de recursos, catálogo e produto.

az sphere device show-count --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct

Mostrar o número de dispositivos num grupo de recursos, catálogo, produto e grupo de dispositivos.

az sphere device show-count --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup

az sphere device show

Mostrar detalhes de um dispositivo existente no seu grupo de recursos e catálogo.

Parâmetros Necessários

Parâmetro Descrição
--catalog -c O Catálogo do Azure Sphere no qual deve efetuar esta operação. Especifique o nome do Catálogo do Azure Sphere. Pode configurar o Catálogo do Azure Sphere predefinido com az config set defaults.sphere.catalog=<name>. Valores de: az sphere catalog list.
--resource-group -r Nome do grupo de recursos do Azure. Pode configurar o grupo predefinido com az config set defaults.group=<name>. Valores de: az group list.

Parâmetros Opcionais

Parâmetro Descrição
--device -d O dispositivo no qual executar o comando quando vários dispositivos estão ligados. Especifique o ID, o endereço IP ou o ID de Ligação Local de um dispositivo ligado. Valores de: az sphere device list

Exemplos

Mostrar detalhes de um dispositivo com o grupo de recursos, o nome do catálogo e o ID do dispositivo.

az sphere device show --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>

az sphere device assign

Atribua um dispositivo a um grupo de dispositivos no seu grupo de recursos e catálogo.

Parâmetros Necessários

Parâmetro Descrição
--device -d O dispositivo no qual executar o comando quando vários dispositivos estão ligados. Especifique o ID, o endereço IP ou o ID de Ligação Local de um dispositivo ligado. Valores de: az sphere device list
--target-product O nome do produto de destino. Valores de: az sphere product list
--target-device-group O nome do grupo de dispositivos de destino. Valores de: az sphere device
--catalog -c O Catálogo do Azure Sphere no qual deve efetuar esta operação. Especifique o nome do Catálogo do Azure Sphere. Pode configurar o Catálogo do Azure Sphere predefinido com az config set defaults.sphere.catalog=<name>. Valores de: az sphere catalog list.
--resource-group -r Nome do grupo de recursos do Azure. Pode configurar o grupo predefinido com az config set defaults.group=<name>. Valores de: az group list.

Exemplos

Atribua um dispositivo com o grupo de recursos, o nome do catálogo, o nome do produto de destino, o nome do grupo de dispositivos de destino e o ID do dispositivo.

az sphere device assign --resource-group MyResourceGroup --catalog MyCatalog --target-product MyProduct --target-device-group MyCurrentDeviceGroup --device <DeviceIdValue>

az sphere device unassign

Anular a atribuição de um dispositivo a partir de um grupo de dispositivos no seu grupo de recursos e catálogo.

Parâmetros Necessários

Parâmetro Descrição
--device -d O dispositivo no qual executar o comando quando vários dispositivos estão ligados. Especifique o ID, o endereço IP ou o ID de Ligação Local de um dispositivo ligado. Valores de: az sphere device list
--catalog -c O Catálogo do Azure Sphere no qual deve efetuar esta operação. Especifique o nome do Catálogo do Azure Sphere. Pode configurar o Catálogo do Azure Sphere predefinido com az config set defaults.sphere.catalog=<name>. Valores de: az sphere catalog list.
--resource-group -r Nome do grupo de recursos do Azure. Pode configurar o grupo predefinido com az config set defaults.group=<name>. Valores de: az group list.

Exemplos

Anular a atribuição de um dispositivo com o grupo de recursos, o nome do catálogo e o ID do dispositivo.

az sphere device unassign --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>

az sphere device restart

Reinicie o dispositivo ligado.

Parâmetros Necessários

Parâmetro Descrição
--catalog -c O Catálogo do Azure Sphere no qual deve efetuar esta operação. Especifique o nome do Catálogo do Azure Sphere. Pode configurar o Catálogo do Azure Sphere predefinido com az config set defaults.sphere.catalog=<name>. Valores de: az sphere catalog list.
--resource-group -r Nome do grupo de recursos do Azure. Pode configurar o grupo predefinido com az config set defaults.group=<name>. Valores de: az group list.

Parâmetros Opcionais

Parâmetro Descrição
--device -d O dispositivo no qual executar o comando quando vários dispositivos estão ligados. Especifique o ID, o endereço IP ou o ID de Ligação Local de um dispositivo ligado. Valores de: az sphere device list

Exemplos

Reinicie o dispositivo ligado.

az sphere device restart

Reinicie um dispositivo especificado.

az sphere device restart --device <DeviceIdValue>

az sphere device claim

Reclame um dispositivo no seu grupo de recursos e catálogo.

Parâmetros Necessários

Parâmetro Descrição
--catalog -c O Catálogo do Azure Sphere no qual deve efetuar esta operação. Especifique o nome do Catálogo do Azure Sphere. Pode configurar o Catálogo do Azure Sphere predefinido com az config set defaults.sphere.catalog=<name>. Valores de: az sphere catalog list.
--resource-group -r Nome do grupo de recursos do Azure. Pode configurar o grupo predefinido com az config set defaults.group=<name>. Valores de: az group list.

Parâmetros Opcionais

Parâmetro Descrição
--device -d O dispositivo no qual executar o comando quando vários dispositivos estão ligados. Especifique o ID, o endereço IP ou o ID de Ligação Local de um dispositivo ligado. Valores de: az sphere device list
--product -p O nome do produto. Valores de: az sphere product list
--device-group -dg O grupo de dispositivos a mostrar. Valores de: az sphere device

Exemplos

Reclame um dispositivo com o grupo de recursos, o nome do catálogo e o ID do dispositivo.

az sphere device claim --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>

Reclame um dispositivo com o grupo de recursos, o nome do catálogo, o nome do produto, o nome do grupo de dispositivos e o ID do dispositivo.

az sphere device claim --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup --device <DeviceIdValue>

az sphere device recover

Utilize o modo de recuperação para carregar o novo firmware para o dispositivo ligado.

Parâmetros Necessários

Parâmetro Descrição
--catalog -c O Catálogo do Azure Sphere no qual deve efetuar esta operação. Especifique o nome do Catálogo do Azure Sphere. Pode configurar o Catálogo do Azure Sphere predefinido com az config set defaults.sphere.catalog=<name>. Valores de: az sphere catalog list.
--resource-group -r Nome do grupo de recursos do Azure. Pode configurar o grupo predefinido com az config set defaults.group=<name>. Valores de: az group list.

Parâmetros Opcionais

Parâmetro Descrição
--device -d O dispositivo no qual executar o comando quando vários dispositivos estão ligados. Especifique o ID, o endereço IP ou o ID de Ligação Local de um dispositivo ligado. Valores de: az sphere device list
--capability Nome de ficheiro de uma imagem de capacidade de dispositivo a aplicar ao dispositivo durante a recuperação. (Caminho).
--images Pasta que contém os pacotes de imagens para escrever no dispositivo. Se não for especificado, as imagens mais recentes do SO são transferidas e utilizadas. (Caminho).

Exemplos

Recuperar um dispositivo ligado.

az sphere device recover

Recuperar um dispositivo anexado com capacidades e imagens específicas.

az sphere device recover --capability myCapability.cap --images myImagesFolder

az sphere device show-os-version

Mostrar a versão do sistema operativo no dispositivo anexado.

Parâmetros Necessários

Parâmetro Descrição
--catalog -c O Catálogo do Azure Sphere no qual deve efetuar esta operação. Especifique o nome do Catálogo do Azure Sphere. Pode configurar o Catálogo do Azure Sphere predefinido com az config set defaults.sphere.catalog=<name>. Valores de: az sphere catalog list.
--resource-group -r Nome do grupo de recursos do Azure. Pode configurar o grupo predefinido com az config set defaults.group=<name>. Valores de: az group list.

Parâmetros Opcionais

Parâmetro Descrição
--device -d O dispositivo no qual executar o comando quando vários dispositivos estão ligados. Especifique o ID, o endereço IP ou o ID de Ligação Local de um dispositivo ligado. Valores de: az sphere device list

Exemplos

Mostrar a versão do sistema operativo no dispositivo anexado.

az sphere device show-os-version

Mostrar a versão do sistema operativo num dispositivo especificado.

az sphere device show-os-version --device <DeviceIdValue>

az sphere device show-deployment-status

Mostrar o estado de implementação do sistema operativo num dispositivo.

Parâmetros Necessários

Parâmetro Descrição
--catalog -c O Catálogo do Azure Sphere no qual deve efetuar esta operação. Especifique o nome do Catálogo do Azure Sphere. Pode configurar o Catálogo do Azure Sphere predefinido com az config set defaults.sphere.catalog=<name>. Valores de: az sphere catalog list.
--resource-group -r Nome do grupo de recursos do Azure. Pode configurar o grupo predefinido com az config set defaults.group=<name>. Valores de: az group list.

Parâmetros Opcionais

Parâmetro Descrição
--device -d O dispositivo no qual executar o comando quando vários dispositivos estão ligados. Especifique o ID, o endereço IP ou o ID de Ligação Local de um dispositivo ligado. Valores de: az sphere device list

Exemplos

Mostrar o estado de implementação do sistema operativo com o grupo de recursos, o nome do catálogo e o ID do dispositivo.

az sphere device show-deployment-status --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>

az sphere device enable-development

"Ative um dispositivo para desenvolvimento ao ativar o sideload e a depuração no dispositivo anexado e ao atribuí-lo a um grupo de dispositivos que desativa as atualizações da aplicação a partir da cloud. Por predefinição, este será o grupo Dispositivo de desenvolvimento do produto do dispositivo, mas podem ser especificados outros grupos de dispositivos. Não para utilização em cenários de fabrico

Parâmetros Necessários

Parâmetro Descrição
--catalog -c O Catálogo do Azure Sphere no qual deve efetuar esta operação. Especifique o nome do Catálogo do Azure Sphere. Pode configurar o Catálogo do Azure Sphere predefinido com az config set defaults.sphere.catalog=<name>. Valores de: az sphere catalog list.
--resource-group -r Nome do grupo de recursos do Azure. Pode configurar o grupo predefinido com az config set defaults.group=<name>. Valores de: az group list.

Parâmetros Opcionais

Parâmetro Descrição
--device -d O dispositivo no qual executar o comando quando vários dispositivos estão ligados. Especifique o ID, o endereço IP ou o ID de Ligação Local de um dispositivo ligado. Valores de: az sphere device list
--enable-rt-core-debugging -r Instale os controladores necessários para depurar aplicações em execução num núcleo em tempo real. Requer permissões de administrador.
--product -p O nome do produto. Valores de: az sphere product list
--device-group -dg O grupo de dispositivos a mostrar. Valores de: az sphere device

Exemplos

Ative um dispositivo para desenvolvimento ao ativar o sideload e a depuração com o grupo de recursos, o nome do catálogo, o ID do dispositivo e o grupo de dispositivos de Desenvolvimento predefinido.

az sphere device enable-development --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>

Ative um dispositivo para desenvolvimento ao ativar o sideload e a depuração com o grupo de recursos, o nome do catálogo, o nome do produto, o nome do grupo de dispositivos e o ID do dispositivo.

az sphere device enable-development --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup --device <DeviceIdValue>

az sphere device enable-cloud-test

"Ative um dispositivo para testar o carregamento na cloud ao desativar o desenvolvimento e a depuração no dispositivo anexado e ao atribuí-lo a um grupo de dispositivos que permite atualizações de aplicações a partir da cloud. Por predefinição, este será o grupo de dispositivos Teste de Campo do produto do dispositivo, mas podem ser especificados outros grupos de dispositivos. Não para utilização em cenários de fabrico

Parâmetros Necessários

Parâmetro Descrição
--catalog -c O Catálogo do Azure Sphere no qual deve efetuar esta operação. Especifique o nome do Catálogo do Azure Sphere. Pode configurar o Catálogo do Azure Sphere predefinido com az config set defaults.sphere.catalog=<name>. Valores de: az sphere catalog list.
--resource-group -r Nome do grupo de recursos do Azure. Pode configurar o grupo predefinido com az config set defaults.group=<name>. Valores de: az group list.

Parâmetros Opcionais

Parâmetro Descrição
--device -d O dispositivo no qual executar o comando quando vários dispositivos estão ligados. Especifique o ID, o endereço IP ou o ID de Ligação Local de um dispositivo ligado. Valores de: az sphere device list
--product -p O nome do produto. Valores de: az sphere product list
--device-group -dg O grupo de dispositivos a mostrar. Valores de: az sphere device

Exemplos

Ative um dispositivo para testar a cloud com o grupo de recursos, o nome do catálogo, o ID do dispositivo e o grupo de dispositivos de Teste de Campo predefinido.

az sphere device enable-cloud-test --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>

Ative um dispositivo para testar a cloud com o grupo de recursos, o nome do catálogo, o nome do produto, o nome do grupo de dispositivos e o ID do dispositivo.

az sphere device enable-cloud-test --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup --device <DeviceIdValue>