Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretó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).
Gerencia certificados de autoridade de certificação (CA) para o locatário atual do Azure Sphere. Para obter mais informações, consulte Gerenciar certificado de autoridade de certificação do locatário.
| Operação | Descrição |
|---|---|
| fazer download | Baixa o certificado de autoridade de certificação para o locatário atual do Azure Sphere como um arquivo de .cer X.509. |
| cadeia de download | Baixa a cadeia de certificados de autoridade de certificação para o locatário atual do Azure Sphere como um arquivo .p7b PKCS#7. |
| à prova de download | Baixa um certificado de prova de posse para o locatário atual do Azure Sphere como um arquivo .cer X.509. |
| lista | Lista todos os certificados para o locatário atual do Azure Sphere. |
fazer download
Baixa um certificado de autoridade de certificação válido para o locatário atual do Azure Sphere como um arquivo de .cer X.509.
Observação
Você não pode baixar um certificado CA expirado para seu locatário do Azure Sphere da CLI do Azure Sphere. Embora os metadados desses certificados ainda estejam disponíveis ao exibir a lista de certificados, as solicitações para o corpo do certificado resultarão em uma resposta "nula" ou "não encontrada".
Parâmetros obrigatórios
| Parâmetro | Tipo | Descrição |
|---|---|---|
| --destino | fio | Especifica o caminho e o nome do arquivo no qual salvar o certificado de autoridade de certificação do locatário. O caminho do arquivo pode ser um caminho absoluto ou relativo, mas deve ter a extensão .cer. |
Parâmetros opcionais
| Parâmetro | Tipo | Descrição |
|---|---|---|
| --índice | Inteiro | Especifica o índice do certificado a ser baixado. Executar azsphere ca-certificate list para listar os certificados e os valores de índice. Se nenhum índice for fornecido, o certificado ativo será baixado. Você pode especificar o valor do índice ou a impressão digital. |
| --Impressão digital | fio | Especifica a impressão digital do certificado a ser baixado. Executar azsphere ca-certificate list para listar os certificados e os valores de impressão digital. Se nenhuma impressão digital for fornecida, o certificado ativo será baixado. Você pode especificar o valor do índice ou a impressão digital. |
| -t, --inquilino | GUID ou nome | Especifica o locatário no qual executar essa operação. Substitui o locatário padrão selecionado. Você pode especificar a ID do locatário ou o nome do locatário. |
Parâmetros Globais
Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:
| Parâmetro | Descrição |
|---|---|
| --depurar | 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, --saída | 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. |
| --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 Consultar a CLI do Azure para obter mais informações e exemplos. |
| --prolixo | 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. |
Exemplo
Exemplo para especificar o índice para baixar um certificado válido:
azsphere ca-certificate download --destination ca-cert.cer --index 1
Exemplo para especificar a impressão digital para baixar um certificado válido:
azsphere ca-certificate download --destination ca-cert.cer --thumbprint <value>
Você deve ver uma saída como a abaixo:
Succeeded
cadeia de download
Baixa a cadeia de certificados de autoridade de certificação para o locatário atual do Azure Sphere como um arquivo .p7b PKCS#7.
Parâmetros obrigatórios
| Parâmetro | Tipo | Descrição |
|---|---|---|
| --destino | fio | Especifica o caminho e o nome do arquivo nos quais salvar a cadeia de certificados de autoridade de certificação do locatário. Você pode fornecer um caminho relativo ou absoluto e deve usar uma extensão .p7b. |
Parâmetros opcionais
| Parâmetro | Tipo | Descrição |
|---|---|---|
| --índice | Inteiro | Especifica o índice do certificado a ser baixado. Executar azsphere ca-certificate list para listar os certificados e os valores de índice. Se nenhum índice for fornecido, o certificado ativo será baixado. Você pode especificar o valor do índice ou a impressão digital. |
| --Impressão digital | fio | Especifica a impressão digital do certificado a ser baixado. Executar azsphere ca-certificate list para listar os certificados e os valores de impressão digital. Se nenhuma impressão digital for fornecida, o certificado ativo será baixado. Você pode especificar o valor do índice ou a impressão digital. |
| -t, --inquilino | GUID ou nome | Especifica o locatário no qual executar essa operação. Substitui o locatário padrão selecionado. Você pode especificar a ID do locatário ou o nome do locatário. |
Parâmetros Globais
Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:
| Parâmetro | Descrição |
|---|---|
| --depurar | 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, --saída | 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. |
| --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 Consultar a CLI do Azure para obter mais informações e exemplos. |
| --prolixo | 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. |
Exemplo
azsphere ca-certificate download-chain --destination CA-cert-chain.p7b --index 1
Succeeded
à prova de download
Baixa um certificado de prova de posse para o locatário atual do Azure Sphere, para uso com um código fornecido e como um arquivo .cer X.509. Esse certificado faz parte do processo de autenticação e atestado do dispositivo. Para obter mais informações sobre como usar dispositivos do Azure Sphere com o Azure IoT, consulte Usar o Azure IoT com o Azure Sphere.
Parâmetros obrigatórios
| Parâmetro | Tipo | Descrição |
|---|---|---|
| --destino | fio | Especifica o caminho e o nome do arquivo nos quais salvar o certificado de prova de posse. O caminho do arquivo pode ser um caminho absoluto ou relativo, mas deve usar uma extensão .cer. |
| --código de verificação | fio | Especifica o código de verificação para o Serviço de Segurança do Azure Sphere usar ao gerar o certificado. |
Parâmetros opcionais
| Parâmetro | Tipo | Descrição |
|---|---|---|
| --índice | Inteiro | Especifica o índice do certificado a ser baixado. Executar azsphere ca-certificate list para listar os certificados e os valores de índice. Se nenhum índice for fornecido, o certificado ativo será baixado. Você pode especificar o valor do índice ou a impressão digital. |
| --Impressão digital | fio | Especifica a impressão digital do certificado a ser baixado. Executar azsphere ca-certificate list para listar os certificados e os valores de impressão digital. Se nenhuma impressão digital for fornecida, o certificado ativo será baixado. Você pode especificar o valor do índice ou a impressão digital. |
| -t, --inquilino | GUID ou nome | Especifica o locatário no qual executar essa operação. Substitui o locatário padrão selecionado. Você pode especificar a ID do locatário ou o nome do locatário. |
Parâmetros Globais
Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:
| Parâmetro | Descrição |
|---|---|
| --depurar | 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, --saída | 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. |
| --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 Consultar a CLI do Azure para obter mais informações e exemplos. |
| --prolixo | 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. |
Exemplo
azsphere ca-certificate download-proof --destination validation.cer --verification-code 123412341234 --index 1
Succeeded
lista
Lista todos os certificados do locatário atual.
Parâmetros opcionais
| Parâmetro | Tipo | Descrição |
|---|---|---|
| -t, --inquilino | GUID ou nome | Especifica o locatário no qual executar essa operação. Substitui o locatário padrão selecionado. Você pode especificar a ID do locatário ou o nome do locatário. |
Parâmetros Globais
Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:
| Parâmetro | Descrição |
|---|---|
| --depurar | 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, --saída | 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. |
| --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 Consultar a CLI do Azure para obter mais informações e exemplos. |
| --prolixo | 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. |
Exemplo
Se o inquilino padrão não for selecionado, uma mensagem poderá ser exibida para definir o inquilino padrão.
azsphere ca-certificate list
----- ---------------------------------------- --------------------------------------------------------------- ------ ----------------- -----------------
Index Thumbprint CertificateDetails Status StartDate EndDate
=========================================================================================================================================================
1 <value> CN: Microsoft Azure Sphere <tenant-ID> Active 09/06/2020 17:39:40 09/06/2022 17:39:40
O: Microsoft Corporation
L: Redmond
ST: Washington
C: US
----- ---------------------------------------- --------------------------------------------------------------- ------ ----------------- -----------------
2 <value> CN: Microsoft Azure Sphere <tenant-ID> Ready 29/04/2020 22:51:47 29/04/2022 22:51:47
O: Microsoft Corporation
L: Redmond
ST: Washington
C: US
----- ---------------------------------------- --------------------------------------------------------------- ------ ----------------- -----------------