Gerenciar produtos
Um produto identifica um MCU do Azure Sphere que é incorporado a um dispositivo conectado para executar uma função específica. Como fabricante, você cria um produto para cada modelo de um dispositivo conectado, como uma máquina de lavar louça ou uma cafeteira. Por exemplo, a Contoso cria um produto para suas máquinas de lavar louça DW100 e atribui esse produto a cada lava-louça DW100 durante a fabricação. Cada produto tem um GUID exclusivo dentro do locatário e não pode ser alterado.
Cada dispositivo conectado tem um único produto, mas um único produto pode ser associado a muitos dispositivos. Cada produto tem um nome que deve ser exclusivo dentro de seu locatário, juntamente com uma descrição. O nome e a descrição do produto fornecem uma maneira legível pelo homem de distinguir um produto de outro. O nome e a descrição do produto podem ser modificados com a frequência que desejar.
Listar produtos
Liste todos os produtos no locatário do Azure Sphere usando o comando azsphere product list ou usando a API Pública do Azure Sphere.
Para listar todos os produtos:
azsphere product list
Uma mensagem poderá ser exibida se o locatário padrão não estiver selecionado. Selecione o locatário necessário na lista e tente novamente o comando.
Para listar todos os produtos em um locatário do Azure Sphere:
Selecione o ícone Explorer do Azure Sphere na Barra de Atividades do Visual Studio Code para abrir o Azure Sphere Explorer. Se o painel Locatário mostrar Logon para ver locatários, faça logon no Azure Sphere e selecione Atualizar para ver os locatários disponíveis.
Expanda o locatário no qual você está interessado.
Expanda o nó do produto.
Selecione Exibir>outrasExplorer do Windows >Azure Sphere para abrir Explorer do Azure Sphere. Se o painel Locatário mostrar Logon para ver locatários, faça logon no Azure Sphere e selecione Atualizar para ver os locatários disponíveis.
Expanda o locatário no qual você está interessado.
Expanda o nó do produto.
Criar um produto
Crie um produto no locatário do Azure Sphere usando o comando azsphere product create ou usando a API Pública do Azure Sphere.
Para criar um produto:
azsphere product create --name <product-name>
Substitua <o nome> do produto por um nome legível para o produto, como DW100. Os nomes dos produtos 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.
Por padrão, quando você cria um novo produto, o Azure Sphere cria automaticamente cinco grupos de dispositivos para uso na criação de implantações. Os cinco grupos de dispositivos padrão são Desenvolvimento, Teste de Campo, Produção, Avaliação do sistema operacional de teste de campo e Avaliação do sistema operacional de produção. Para criar o produto sem os grupos de dispositivos padrão, use o comando:
azsphere product create --name <product-name> --no-default-device-groups
Um locatário pode conter muitos produtos, pode ser útil fornecer uma descrição de cada um deles. Você pode adicionar uma descrição a um produto da seguinte maneira:
azsphere product create --name <product-name> --description <product-description>
Para criar um produto:
Para o locatário no qual você está interessado, clique com o botão direito do mouse no nó Produto e selecione Novo Produto.
Especifique um nome para o produto e pressione Enter. Os nomes dos produtos 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 .
Quando você cria um produto no Azure Sphere Explorer, os cinco grupos de dispositivos padrão são criados automaticamente. Se você quiser criar um produto sem grupos de dispositivos, use o comando azsphere product create ou a API Pública do Azure Sphere e especifique --no-default-device-groups.
Você pode criar um produto no Azure Sphere Explorer, mas não excluí-lo. Para excluir produtos, use o comando azsphere product delete ou a API Pública do Azure Sphere.
Para criar um produto:
Para o locatário no qual você está interessado, clique com o botão direito do mouse no nó Produto e selecione Novo Produto.
Especifique um nome para o produto e pressione Enter ou clique emAplicar. Os nomes dos produtos 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 .
Quando você cria um produto no Azure Sphere Explorer, os cinco grupos de dispositivos padrão são criados automaticamente. Se você quiser criar um produto sem grupos de dispositivos, use o comando azsphere product create ou a API Pública do Azure Sphere e especifique --no-default-device-groups.
Você pode criar um produto no Azure Sphere Explorer, mas não excluí-lo. Para excluir produtos, use o comando azsphere product delete ou a API Pública do Azure Sphere.
Atualizar um produto
Modifique o nome ou a descrição de um produto a qualquer momento usando o comando azsphere product update ou usando a API Pública do Azure Sphere. Para atualizar o nome e a descrição de um produto:
azsphere product update --product <product-name> --new-name <new-product-name> --new-description <new-product-description>
Excluir um produto
Exclua um produto a qualquer momento usando o comando azsphere product delete ou usando a API Pública do Azure Sphere.
Um produto só pode ser excluído quando:
- O usuário tem permissões de administrador para o locatário.
- O produto está vazio e os grupos de dispositivos não têm dispositivos nele. O comando azsphere product device list lista todos os dispositivos em um produto. Execute azsphere device update --device-group para mover o dispositivo para um grupo de dispositivos diferente ou azsphere device-group delete para excluir um grupo de dispositivos.
Para excluir um produto:
azsphere product delete --product <product-name>
Para o locatário no qual você está interessado, expanda o nó Produto.
Para renomear o produto, clique com o botão direito do mouse no nome do produto e selecione Renomear, especifique um novo nome de produto e pressione Enter.
Para atualizar a descrição, clique com o botão direito do mouse no nome do produto e selecione Atualizar Descrição, especifique uma nova descrição e pressione Enter.
Para o locatário no qual você está interessado, expanda o nó Produto.
Para renomear o produto, selecione o nome do produto e pressione F2 ou clique com o botão direito do mouse no nome do produto e selecione Renomear, especifique um novo nome do produto e pressione Enter ou clique emAplicar.
Para atualizar a descrição, expanda o produto, selecione Descrição e pressione F2 ou clique com o botão direito do mouse em Descrição e selecione Modificar, especifique uma nova descrição e pressione Enter ou clique emAplicar.
Mostrar detalhes do produto
Exiba os detalhes de um produto em seu locatário usando o comando azsphere product show ou usando a API Pública do Azure Sphere.
azsphere product show --product <product-name>
Para exibir os detalhes de um produto em seu locatário:
Selecione o ícone Explorer do Azure Sphere na Barra de Atividades do Visual Studio Code para abrir o Azure Sphere Explorer. Se o painel Locatário mostrar Logon para ver locatários, faça logon no Azure Sphere e selecione Atualizar para ver os locatários disponíveis.
Para o locatário no qual você está interessado, expanda o nó Produto.
Expanda o produto no qual você está interessado.
Selecione Exibir>outrasExplorer do Windows >Azure Sphere para abrir Explorer do Azure Sphere. Se o painel Locatário mostrar Logon para ver locatários, faça logon no Azure Sphere e selecione Atualizar para ver os locatários disponíveis.
Para o locatário no qual você está interessado, expanda o nó Produto.
Expanda o produto no qual você está interessado.