Gerenciar locatários
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 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:
Conecte um dispositivo com Azure Sphere ao seu computador via USB.
Abra uma CLI do Azure Sphere usando o PowerShell, o Prompt de Comando do Windows ou o shell de comando do Linux.
Faça login na CLI, seguindo as instruções aqui.
Para criar o locatário, insira o seguinte comando:
azsphere tenant create --name <tenant-name or tenant-ID>Substitua <tenant-name> 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 você a usar o locatário existente. Se você tiver certeza de que deseja criar um novo locatário, poderá usar o parâmetro para forçar a criação de um novo locatário do --force-additional Azure Sphere.
O comando azsphere tenant create cria um locatário, mas não reivindica 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 computador.
Para modificar ou selecionar o locatário padrão, execute azsphere tenant select.
Dica
Se você fizer logoff e logon novamente no Serviço de Segurança do Azure Sphere, poderá ser solicitado a selecionar 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 disponíveis do Azure Sphere usando as seguintes opções:
Execute o comando a seguir para listar os locatários disponíveis do Azure Sphere.
azsphere tenant list
Para listar um locatário usando a API, use a operação Tenants – Get .
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 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 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.