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. Sua organização deve criar um locatário do Azure Sphere e, em seguida, declarar cada um de seus dispositivos nesse locatário, para que você possa gerenciar esses dispositivos remotamente e com segurança.
Pré-requisitos
- Instale o SDK do Azure Sphere para Windows ou para Linux.
- Você deve ter um dispositivo não declarado 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.
Ponta
- 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 do Azure Sphere ao computador por USB.
Abra uma CLI do Azure Sphere usando o PowerShell, o Prompt de Comando do Windows ou o shell de comando do Linux e insira 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 somente 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 maiúsculas de minúsculas.
Quando você cria um locatário, o Serviço de Segurança do Azure Sphere registra a ID do dispositivo anexado. Cada ID de dispositivo pode ser usada para criar apenas um locatário do Azure Sphere.
Você pode usar o parâmetro --force-additional para forçar a criação de um novo locatário do Azure Sphere. Use esse comando somente se tiver certeza de que deseja usar a conta atual para criar um novo locatário do Azure Sphere usando o dispositivo anexado. Um dispositivo que foi usado anteriormente para criar um locatário do Azure Sphere não pode ser usado para criar um novo locatário.
O comando azsphere tenant create cria um locatário, mas não reivindica o dispositivo no locatário. Para obter mais informações, consulte Solicitar seu dispositivo.
Para criar um locatário usando a API, use a operação Locatários – Criar.
Mostrar e selecionar o locatário padrão
Execute azsphere tenant show-selected para verificar se o locatário selecionado deve ser usado como o padrão neste computador.
Para modificar ou selecionar o locatário padrão, execute azsphere tenant select.
Ponta
Se você fizer logon e fizer logon novamente no Serviço de Segurança do Azure Sphere, poderá ser solicitado a selecionar o locatário padrão. Entre 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:
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 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
Ponta
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 Tenants - 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 .