Gerenciar produtos
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).
Um produto identifica um MCU do Azure Sphere 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 cafeteira. Por exemplo, a Contoso cria um produto para suas lavadoras de louça DW100 e atribui esse produto a cada lavadora de louça DW100 durante a fabricação. Cada produto tem um GUID que é 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 vários 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 oferecem uma maneira legível de distinguir um produto de outro. O nome e a descrição do produto poderão ser modificados sempre que você desejar.
Listar produtos
Liste todos os produtos em seu 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 repita o comando.
Para listar todos os produtos em um locatário do Azure Sphere:
Selecione o ícone do Azure Sphere Explorer na Barra de Atividades do Visual Studio Code para abrir o Azure Sphere Explorer. Se o painel Locatário mostrar Fazer logon para ver os 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>Outro Windows>Azure Sphere Explorer para abrir o Azure Sphere Explorer. Se o painel Locatário mostrar Fazer logon para ver os 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 em seu 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 <product-name> por um nome legível para o seu 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, coloque-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 inquilino pode conter muitos produtos, pode ser útil fornecer uma descrição de cada um. 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 em Aplicar. 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. 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 de produto e pressione Enter ou clique em Aplicar.
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 em Aplicar.
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 do Azure Sphere Explorer na Barra de Atividades do Visual Studio Code para abrir o Azure Sphere Explorer. Se o painel Locatário mostrar Fazer logon para ver os 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 em que você está interessado.
Selecione Exibir>Outro Windows>Azure Sphere Explorer para abrir o Azure Sphere Explorer. Se o painel Locatário mostrar Fazer logon para ver os 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 em que você está interessado.