Compartilhar via


login

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).

Faz logon no Serviço de Segurança do Azure Sphere. Por padrão, todos os comandos azsphere se aplicam ao locatário e à identidade de logon 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 Active Directory (AAD) para verificar sua identidade. AAD usa SSO (Logon Único), cujo padrão normalmente é uma identidade existente em seu computador. Se essa identidade não for válida para uso com seu locatário do Azure Sphere, comandos azsphere poderão falhar. Para obter mais informações, consulte Conectar uma conta da Microsoft.

Use logon para entrar explicitamente nos Serviços de Segurança do Azure Sphere. Após o êxito, essa identidade é usada para comandos azsphere subsequentes. Na maioria dos casos, você só deve precisar entrar uma vez.

Parâmetros opcionais

Parâmetro Tipo Descrição
--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. Confira fluxo de código de 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 Descrição
--debug Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help 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, --output Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query 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 Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

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ê deve ver uma caixa de diálogo solicitando 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.