Gerenciar locatários
Um locatário do Azure Sphere fornece uma maneira segura de 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, reivindicar 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 reclamado 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 do 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 podem 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, inclua 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 são sensíveis a 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 do dispositivo pode ser usada para criar apenas um locatário do Azure Sphere.
Você pode usar o --force-additional parâmetro 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 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 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 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á solicitar a seleção do 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 Locatários – Obter .
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 é sensível ao caso.
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 tente novamente o comando.
Para atualizar um locatário usando a API, use a operação Locatários – Patch .
Baixar relatório de erro para locatário
Para obter relatórios de erro para todos os dispositivos dentro de um locatário, use o comando download-error-report do locatário do azsphere .