Gerenciar grupos de dispositivo
Importante
Esta é a documentação do Azure Sphere (herdado). O Azure Sphere (herdado) será desativado em 27 de setembro de 2027 e os usuários devem migrar para o Azure Sphere (integrado) até esse momento. Use o seletor de versão localizado acima do sumário para exibir a documentação do Azure Sphere (Integrado).
Este tópico documenta como gerenciar seus grupos de dispositivos usando a CLI ou o Azure Sphere Explorer. As etapas neste tópico pressupõem que você esteja familiarizado com os conceitos de locatários, produtos e grupos de dispositivos do Azure Sphere.
Listar grupos de dispositivos
Liste todos os grupos de dispositivos em seu locatário do Azure Sphere usando o comando azsphere device-group list ou usando a API Device Group – List.
Para listar todos os grupos de dispositivos:
azsphere device-group list
Liste os grupos de dispositivos em um produto específico usando o comando azsphere product device-group list ou usando a API Product - List Groups.
azsphere product device-group list --product <product-name>
Expanda o nó Locatário para o locatário no qual você está interessado.
Expanda o nó Locatário para o locatário no qual você está interessado.
Para exibir os produtos e grupos de dispositivos de um locatário:
Expanda o nó Locatário para o locatário no qual você está interessado.
Se não houver produtos listados, crie um produto.
Se o dispositivo já estiver associado a um produto e atribuído a um grupo, você poderá atualizar seu grupo de dispositivos a qualquer momento.
Para exibir os produtos e grupos de dispositivos de um locatário:
Expanda o nó Locatário para o locatário no qual você está interessado.
Se não houver produtos listados, crie um produto.
Se o dispositivo já estiver associado a um produto e atribuído a um grupo, você poderá atualizar seu grupo de dispositivos a qualquer momento.
Criar um grupo de dispositivos
Crie um grupo de dispositivos usando o comando azsphere device-group create ou usando a API Device Group – Create.
Para criar um grupo de dispositivos:
azsphere device-group create --product <product-name> --name <device-group-name> --description <device-group-description>
Os nomes dos grupos de dispositivos podem conter apenas caracteres alfanuméricos e espaços. Eles não podem exceder 50 caracteres. Se o nome ou a descrição incluir espaços, coloque-o entre aspas.
Você pode incluir os seguintes parâmetros opcionais:
--os-feedespecifica o tipo de feed do sistema operacional a ser usado para atualizações do sistema operacional.--application-updatedefine a política de atualizações de aplicativos para esse grupo de dispositivos.
Para o locatário no qual você está interessado, expanda o nó Produto.
Para o produto em que você está interessado, clique com o botão direito do mouse e selecione Novo Grupo de Dispositivos.
Especifique um nome para o grupo de dispositivos e pressione Enter. Os nomes dos grupos de dispositivos podem conter apenas caracteres alfanuméricos e espaços. Eles não podem exceder 50 caracteres. Se você especificar um nome inválido, um erro será relatado na janela Saída .
Você pode criar um grupo de dispositivos no Visual Studio Code, mas não excluí-lo. Para excluir um grupo de dispositivos, use o comando azsphere device-group delete ou a API Pública do Azure Sphere.
Para o locatário no qual você está interessado, expanda o nó Produto.
Para o produto em que você está interessado, clique com o botão direito do mouse e selecione Novo Grupo de Dispositivos.
Especifique um nome para o grupo de dispositivos e pressione Enter ou clique em Aplicar. Os nomes dos grupos de dispositivos podem conter apenas caracteres alfanuméricos e espaços. Eles não podem exceder 50 caracteres. Se você especificar um nome inválido, um erro será relatado na janela Saída .
Você pode criar um grupo de dispositivos no Visual Studio, mas não excluí-lo. Para excluir produtos, use o comando azsphere device-group delete ou a API Pública do Azure Sphere.
Atualizar o grupo de dispositivos
Você pode modificar o nome ou a descrição de um grupo de dispositivos usando o comando azsphere device-group update ou usando a API Device Group - Patch.
Para atualizar o nome e a descrição de um grupo de dispositivos:
azsphere device-group update --device-group <device group ID or product-name/device-group-name> --new-name <new-device-group-name> --new-description <new-device-group-description>
Você também pode atualizar os os-feed parâmetros e application-update usando o comando azsphere device-group update .
Para o locatário no qual você está interessado, expanda o nó Produto.
Para o produto em que você está interessado, expanda o nó do produto para mostrar os grupos de dispositivos incluídos. Você pode renomear o grupo de dispositivos ou atualizar sua descrição, tipo de feed do sistema operacional ou política de atualização:
Para renomear um grupo de dispositivos, clique com o botão direito do mouse no nome do grupo de dispositivos e selecione Renomear, digite um novo nome e pressione Enter. Os nomes dos grupos de dispositivos podem conter apenas caracteres alfanuméricos e espaços. Eles não podem exceder 50 caracteres. Se você especificar um nome inválido, um erro será relatado na janela Saída .
Para atualizar a descrição do grupo de dispositivos, clique com o botão direito do mouse no nome do grupo de dispositivos e selecione Atualizar Descrição, digite uma nova descrição e pressione Enter.
Para atualizar o tipo de feed do sistema operacional, expanda o grupo de dispositivos, clique com o botão direito do mouse em Tipo de feed do sistema operacional, selecione Atualizar e escolha Varejo ou RetailEval no menu.
Para alterar a política de atualização, expanda o grupo de dispositivos, clique com o botão direito do mouse em Atualizar política, selecione Atualizar e escolha No3rdPartyAppUpdates ou UpdateAll no menu. (A terceira opção, NoUpdates, atualmente está reservado para uso interno. Se você escolher essa opção, um erro será relatado na janela Saída .)
Mova um dispositivo para um grupo de dispositivos diferente usando o comando azsphere device update ou usando a API Devices – Move.
Para o locatário no qual você está interessado, expanda o nó Produto.
Para o produto em que você está interessado, expanda o nó do produto para mostrar os grupos de dispositivos incluídos. Você pode renomear o grupo de dispositivos ou atualizar sua descrição, tipo de feed do sistema operacional ou política de atualização:
Para renomear um grupo de dispositivos, selecione o nome do grupo de dispositivos e pressione F2 ou clique com o botão direito do mouse no nome do grupo de dispositivos e selecione Renomear, digite um novo nome e pressione Enter ou clique em Aplicar. Os nomes dos grupos de dispositivos podem conter apenas caracteres alfanuméricos e espaços. Eles não podem exceder 50 caracteres. Se você especificar um nome inválido, um erro será relatado na janela Saída .
Para atualizar a descrição do grupo de dispositivos, expanda o grupo de dispositivos, selecione Descrição e pressione F2 ou clique com o botão direito do mouse em Descrição e selecione Modificar, digite uma nova descrição e pressione Enter ou clique em Aplicar.
Para atualizar o tipo de feed do sistema operacional, expanda o grupo de dispositivos, selecione o tipo de feed do sistema operacional e pressione F2 ou clique com o botão direito do mouse em Tipo de feed do sistema operacional e selecione Modificar, escolha Varejo ou RetailEval no menu e pressione Enter ou clique em Aplicar.
Para alterar a política de atualização, expanda o grupo de dispositivos, selecione Atualizar política e pressione F2 ou clique com o botão direito do mouse em Atualizar política e selecione Modificar, escolha No3rdPartyAppUpdates ou UpdateAll no menu e pressione Enter ou clique em Aplicar. (A terceira opção, NoUpdates, atualmente está reservado para uso interno. Se você escolher essa opção, um erro será relatado na janela Saída ).
Mova um dispositivo para um grupo de dispositivos diferente usando o comando azsphere device update ou usando a API Devices – Move.
Mover um dispositivo para um grupo de dispositivos diferente
Mova um dispositivo para um grupo de dispositivos diferente usando o comando azsphere device update ou usando a API Devices – Move.
Especifique a ID do grupo de dispositivos ou uma combinação do nome do produto e do nome do grupo de dispositivos no <formato product-name>/<device-group-name> :
azsphere device update --device-group <device-group-id>
azsphere device update --device-group <product-name/device-group-name>
Excluir um grupo de dispositivos
Exclua um grupo de dispositivos especificado em seu locatário do Azure Sphere usando o comando azsphere device-group delete ou usando o Grupo de Dispositivos – API de Exclusão.
Um grupo de dispositivos só pode ser excluído quando:
- O usuário tem permissões de administrador para o locatário.
- O grupo de dispositivos está vazio e não tem dispositivos nele. O comando azsphere device-group device list lista todos os dispositivos em um grupo de dispositivos. Execute azsphere device update --device-group para mover o dispositivo para um grupo de dispositivos diferente.
Especifique a ID do grupo de dispositivos ou uma combinação do nome do produto e do nome do grupo de dispositivos no <formato product-name>/<device-group-name> :
azsphere device-group delete --device-group <device-group-id>
azsphere device-group delete --device-group <product-name/device-group-name>