início de sessão
Importante
Esta é a documentação do Azure Sphere (Legado). O Azure Sphere (Legado) 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).
Efetua logon no Serviço de Segurança do Azure Sphere. Por padrão, todos os comandos azsphere se aplicam à identidade de login e ao locatário do usuário atual. O comando login permite que você use uma identidade diferente.
Quando você usa o azsphere, o Serviço de Segurança do Azure Sphere usa o Microsoft Azure Ative Directory (AAD) para verificar sua identidade. O AAD usa o Single Sign-On (SSO), que normalmente assume como padrão uma identidade existente no seu PC. Se essa identidade não for válida para uso com seu locatário do Azure Sphere, os comandos azsphere poderão falhar. Para obter mais informações, consulte Conectar uma conta da Microsoft.
Use o logon para entrar explicitamente nos Serviços de Segurança do Azure Sphere. Após o sucesso, essa identidade é usada para comandos azsphere subsequentes. Na maioria dos casos, só terá de iniciar sessão uma vez.
Parâmetros opcionais
| Parâmetro | Tipo | Description |
|---|---|---|
| --use-device-code | String | Fornece um mecanismo de login alternativo com base no código do dispositivo. Se a CLI não conseguir iniciar um navegador, isso será usado para autenticação. Consulte o fluxo de código do dispositivo para obter detalhes sobre essa forma de autenticação. |
Parâmetros globais
Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:
| Parâmetro | Description |
|---|---|
| --depuração | Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros. |
| -h, --ajuda | Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis. |
| --only-show-errors | Mostra apenas erros, suprimindo avisos. |
| -o, --saída | Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere. |
| --consulta | Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Query Azure CLI para obter mais informações e exemplos. |
| --verborrágico | Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos. |
Nota
Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.
Exemplo
azsphere login
---------------------
Name
=====================
bob@contoso.com
---------------------
Em resposta, você verá uma caixa de diálogo que solicita que você faça login. Se a lista incluir a identidade que você usa para o Azure Sphere, escolha essa identidade. Caso contrário, insira as credenciais apropriadas.