Gerenciar grupos de dispositivos
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 no locatário do Azure Sphere usando o comando azsphere device-group list ou usando o Grupo de Dispositivos – Listar API.
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 o Grupo de Dispositivos – Criar API.
Para criar um grupo de dispositivos:
azsphere device-group create --product <product-name> --name <device-group-name> --description <device-group-description>
Os nomes para 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, inclua-o entre aspas.
Você pode incluir os seguintes parâmetros opcionais:
--os-feed
especifica o tipo de feed do sistema operacional a ser usado para atualizações do sistema operacional.--application-update
define a política de atualizações de aplicativo para esse grupo de dispositivos.
Para o locatário no qual você está interessado, expanda o nó Produto.
Para o produto no qual 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 para 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 no qual 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 emAplicar. Os nomes para 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 de atualização do grupo de dispositivos do azsphere ou usando o Grupo de Dispositivos – API de 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 no qual você está interessado, expanda o nó do produto para mostrar seus 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 do dispositivo e selecione Renomear, digite um novo nome e pressione Enter. Os nomes para 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 do dispositivo 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 no 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, está reservada para uso interno no momento. 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 no qual você está interessado, expanda o nó do produto para mostrar seus 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 do dispositivo e selecione Renomear, digite um novo nome e pressione Enter ou clique emAplicar. Os nomes para 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 Modificar, digite uma nova descrição e pressione Enter ou clique emAplicar.
Para atualizar o tipo de feed do sistema operacional, expanda o grupo de dispositivos, selecione Tipo de feed do sistema operacional e pressione F2 ou clique com o botão direito do mouse no 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 emAplicar. (A terceira opção, NoUpdates, está reservada para uso interno no momento. 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 nome> do produto/<grupo de dispositivos:>
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 no locatário do Azure Sphere usando o comando azsphere device-group delete ou usando o Grupo de Dispositivos – Excluir API.
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 nome> do produto/<grupo de dispositivos:>
azsphere device-group delete --device-group <device-group-id>
azsphere device-group delete --device-group <product-name/device-group-name>