ca-certificate
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 o certificado de autoridade de certificação para o locatário atual do Azure Sphere como um arquivo de .cer X.509.
Parâmetros obrigatórios
| Parâmetro | Tipo | Descrição |
|---|---|---|
| --destino | String | 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 | String | 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 |
|---|---|
| --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
Exemplo para especificar o índice para baixar um certificado necessário:
azsphere ca-certificate download --destination ca-cert.cer --index 1
Exemplo para especificar a impressão digital para baixar um certificado necessário:
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 | String | 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 | String | 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 |
|---|---|
| --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 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 | String | 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 | String | 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 | String | 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 |
|---|---|
| --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 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 |
|---|---|
| --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
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
----- ---------------------------------------- --------------------------------------------------------------- ------ ----------------- -----------------