Gerenciar locatários

Um locatário do Azure Sphere fornece uma maneira segura para sua organização gerenciar remotamente seus dispositivos do Azure Sphere isoladamente dos dispositivos de outros clientes. A organização precisa criar um locatário do Azure Sphere e, em seguida, declarar cada um de seus dispositivos nesse locatário, para que seja possível gerenciá-los remotamente e com segurança.

Pré-requisitos

• Instale o SDK do Azure Sphere para Windows ou Linux.
• Você deve ter um dispositivo não reivindicado que não tenha sido usado anteriormente para criar um locatário.

Criar um locatário do Azure Sphere

Um locatário do Azure Sphere isola seus dispositivos do Azure Sphere e fornece uma maneira de organizar e implantar aplicativos. A conta que cria o locatário recebe automaticamente a função de administrador para o locatário.

Dica

• Depois que um locatário é criado, ele não pode ser excluído e os dispositivos não podem ser migrados entre locatários. Se sua equipe ou organização já tiver um locatário do Azure Sphere, considere solicitar acesso a ele em vez de criar um locatário adicional.

Para criar um locatário do Azure Sphere:

1. Conecte um dispositivo com Azure Sphere ao seu computador via USB.

2. Abra uma CLI do Azure Sphere usando o PowerShell, o Prompt de Comando do Windows ou o shell de comando do Linux.

3. Faça login na CLI, seguindo as instruções aqui.

4. Para criar o locatário, digite o seguinte comando:

   azsphere tenant create --name <tenant-name or tenant-ID>
   

   Substitua <o nome> do locatário por um nome que outros usuários possam reconhecer, como "Contoso Ltd" ou "Contoso Dishwasher Division". Ao nomear seu locatário, use apenas caracteres alfanuméricos e espaços. Se você incluir espaços, coloque o nome entre aspas. O nome não deve começar com um espaço ou exceder 50 caracteres. Caracteres especiais não são permitidos. Os nomes diferenciam minúsculas e maiúsculas.

Quando você cria um locatário, o Serviço de Segurança do Azure Sphere registra a identificação do dispositivo conectado. Cada identificação do dispositivo pode ser usada para criar apenas um locatário do Azure Sphere.

Se sua conta já tiver acesso a um locatário do Azure Sphere, o comando falhará, aconselhando-o a usar o locatário existente. Se você tiver certeza de que deseja criar um novo locatário, poderá usar o --force-additional parâmetro para forçar a criação de um novo locatário do Azure Sphere.

O comando azsphere tenant create cria um locatário, mas não declara o dispositivo no locatário. Para obter mais informações, consulte Reivindicar seu dispositivo.

Para criar um locatário usando a API, use a operação Locatários - Criar .

Mostrar e selecionar locatário padrão

Execute azsphere tenant show-selected para verificar se o locatário selecionado deve ser usado como padrão neste PC.

Para modificar ou selecionar o locatário padrão, execute azsphere tenant select.

Dica

Se você fizer logout e logon novamente no Serviço de Segurança do Azure Sphere, poderá ser solicitado que você selecione o locatário padrão. Certifique-se de entrar com a conta que você deseja usar para gerenciar seus dispositivos do Azure Sphere.

Listar locatários

Você pode listar os locatários do Azure Sphere disponíveis usando as seguintes opções:

Azure Sphere CLI

Execute o comando a seguir para listar os locatários do Azure Sphere disponíveis.

azsphere tenant list

Para listar um locatário usando a API, use a operação Locatários - Obter .

Visual Studio Code

Para listar locatários no Visual Studio Code:

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 Logon para ver locatários, faça logon no Azure Sphere e selecione Atualizar para ver os locatários disponíveis.

Visual Studio

Para listar locatários no Visual Studio:

Selecione Exibir>Outro Windows>Azure Sphere Explorer 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.

Atualizar um locatário existente

Você pode usar a CLI do Azure Sphere ou a API Pública do Azure Sphere para renomear um locatário existente do Azure Sphere. Ao nomear seu locatário, use caracteres alfanuméricos. Caracteres especiais não são permitidos. O nome não deve exceder 50 caracteres e diferencia maiúsculas de minúsculas.

Para atualizar um locatário usando a CLI, execute o comando:

azsphere tenant update --tenant a323c263-2aa3-2559-aabb-a3fc32631900 --new-name Tenant2

Dica

Uma mensagem pode 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 atualizar um locatário usando a API, use a operação Locatários - Patch .

Baixar relatório de erros para locatário

Para obter relatórios de erros para todos os dispositivos em um locatário, use o comando azsphere tenant download-error-report.