ca-certificate
Importante
Questa è la documentazione di Azure Sphere (legacy). Azure Sphere (legacy) viene ritirato il 27 settembre 2027 e gli utenti devono eseguire la migrazione ad Azure Sphere (integrato) entro questo periodo. Usare il selettore di versione posizionato sopra il sommario per visualizzare la documentazione di Azure Sphere (integrata).
Gestisce i certificati dell'autorità di certificazione (CA) per il tenant di Azure Sphere corrente. Per altre informazioni, vedere Gestire il certificato della CA tenant.
| Operazione | Descrizione |
|---|---|
| download | Scarica il certificato della CA per il tenant di Azure Sphere corrente come file di .cer X.509. |
| catena di download | Scarica la catena di certificati CA per il tenant di Azure Sphere corrente come file PKCS#7 .p7b. |
| download-proof | Scarica un certificato di verifica del possesso per il tenant di Azure Sphere corrente come file X.509 .cer. |
| list | Elenca tutti i certificati per il tenant di Azure Sphere corrente. |
download
Scarica il certificato della CA per il tenant di Azure Sphere corrente come file di .cer X.509.
Parametri obbligatori
| Parametro | Tipo | Descrizione |
|---|---|---|
| --destinazione | String | Specifica il percorso e il nome file in corrispondenza del quale salvare il certificato della CA tenant. Il percorso del file può essere un percorso assoluto o relativo, ma deve avere l'estensione .cer. |
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| --indice | Intero | Specifica l'indice del certificato da scaricare. Eseguire azsphere ca-certificate list per elencare i certificati e i valori di indice. Se non viene specificato alcun indice, viene scaricato il certificato attivo. È possibile specificare il valore di indice o l'identificazione personale. |
| --Identificazione personale | String | Specifica l'identificazione personale del certificato da scaricare. Eseguire azsphere ca-certificate list per elencare i certificati e i valori di identificazione personale. Se non viene specificata alcuna identificazione personale, viene scaricato il certificato attivo. È possibile specificare il valore di indice o l'identificazione personale. |
| -t, --tenant | GUID o nome | Specifica il tenant in cui eseguire questa operazione. Esegue l'override del tenant selezionato predefinito. È possibile specificare l'ID tenant o il nome del tenant. |
Parametri globali
Per l'interfaccia della riga di comando di Azure Sphere sono disponibili i parametri globali seguenti:
| Parametro | Descrizione |
|---|---|
| --debug | Aumenta il livello di dettaglio della registrazione per visualizzare tutti i log di debug. Se si rilevano bug, fornire l'output generato con il flag --debug attivato quando si invia la segnalazione. |
| -h, --help | Stampa informazioni di riferimento sull'interfaccia della riga di comando sui comandi e sui relativi argomenti ed elenchi di sottogruppi e comandi disponibili. |
| --only-show-errors | Visualizza solo gli errori, eliminando gli avvisi. |
| -o, --output | Modifica il formato di output. I formati di output disponibili sono json, jsonc (JSON colorato), tsv (valori delimitati da tabulazioni), tabella (tabelle ASCII leggibili) e yaml. Per impostazione predefinita, l'output dell'interfaccia della riga di comando è in formato table. Per altre informazioni sui formati di output disponibili, vedere Formato di output per i comandi dell'interfaccia della riga di comando di Azure Sphere. |
| --query | Usa il linguaggio di query JMESPath per filtrare l'output restituito dai servizi di sicurezza di Azure Sphere. Per altre informazioni ed esempi, vedere Esercitazione su JMESPath e Eseguire query sull'output dei comandi dell'interfaccia della riga di comando di Azure. |
| --verbose | Stampa informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili. Usare --debug per i log di debug completi. |
Nota
Se si usa l'interfaccia della riga di comando classica di Azure Sphere, vedere Parametri globali per altre informazioni sulle opzioni disponibili.
Esempio
Esempio per specificare l'indice per scaricare un certificato obbligatorio:
azsphere ca-certificate download --destination ca-cert.cer --index 1
Esempio per specificare l'identificazione personale per scaricare un certificato obbligatorio:
azsphere ca-certificate download --destination ca-cert.cer --thumbprint <value>
Verrà visualizzato un output simile al seguente:
Succeeded
catena di download
Scarica la catena di certificati CA per il tenant di Azure Sphere corrente come file PKCS#7 .p7b.
Parametri obbligatori
| Parametro | Tipo | Descrizione |
|---|---|---|
| --destinazione | String | Specifica il percorso e il nome file in corrispondenza del quale salvare la catena di certificati della CA tenant. È possibile specificare un percorso relativo o assoluto e usare un'estensione p7b. |
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| --indice | Intero | Specifica l'indice del certificato da scaricare. Eseguire azsphere ca-certificate list per elencare i certificati e i valori di indice. Se non viene specificato alcun indice, viene scaricato il certificato attivo. È possibile specificare il valore di indice o l'identificazione personale. |
| --Identificazione personale | String | Specifica l'identificazione personale del certificato da scaricare. Eseguire azsphere ca-certificate list per elencare i certificati e i valori di identificazione personale. Se non viene specificata alcuna identificazione personale, viene scaricato il certificato attivo. È possibile specificare il valore di indice o l'identificazione personale. |
| -t, --tenant | GUID o nome | Specifica il tenant in cui eseguire questa operazione. Esegue l'override del tenant selezionato predefinito. È possibile specificare l'ID tenant o il nome del tenant. |
Parametri globali
Per l'interfaccia della riga di comando di Azure Sphere sono disponibili i parametri globali seguenti:
| Parametro | Descrizione |
|---|---|
| --debug | Aumenta il livello di dettaglio della registrazione per visualizzare tutti i log di debug. Se si rilevano bug, fornire l'output generato con il flag --debug attivato quando si invia la segnalazione. |
| -h, --help | Stampa informazioni di riferimento sull'interfaccia della riga di comando sui comandi e sui relativi argomenti ed elenchi di sottogruppi e comandi disponibili. |
| --only-show-errors | Visualizza solo gli errori, eliminando gli avvisi. |
| -o, --output | Modifica il formato di output. I formati di output disponibili sono json, jsonc (JSON colorato), tsv (valori delimitati da tabulazioni), tabella (tabelle ASCII leggibili) e yaml. Per impostazione predefinita, l'output dell'interfaccia della riga di comando è in formato table. Per altre informazioni sui formati di output disponibili, vedere Formato di output per i comandi dell'interfaccia della riga di comando di Azure Sphere. |
| --query | Usa il linguaggio di query JMESPath per filtrare l'output restituito dai servizi di sicurezza di Azure Sphere. Per altre informazioni ed esempi, vedere Esercitazione su JMESPath e Eseguire query sull'output dei comandi dell'interfaccia della riga di comando di Azure. |
| --verbose | Stampa informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili. Usare --debug per i log di debug completi. |
Nota
Se si usa l'interfaccia della riga di comando classica di Azure Sphere, vedere Parametri globali per altre informazioni sulle opzioni disponibili.
Esempio
azsphere ca-certificate download-chain --destination CA-cert-chain.p7b --index 1
Succeeded
download-proof
Scarica un certificato di verifica del possesso per il tenant di Azure Sphere corrente, per l'uso con un codice fornito e come file X.509 .cer. Questo certificato fa parte del processo di autenticazione e attestazione del dispositivo. Per altre informazioni sull'uso di dispositivi Azure Sphere con Azure IoT, vedere Usare Azure IoT con Azure Sphere.
Parametri obbligatori
| Parametro | Tipo | Descrizione |
|---|---|---|
| --destinazione | String | Specifica il percorso e il nome file in corrispondenza del quale salvare il certificato di verifica del possesso. Il percorso file può essere un percorso assoluto o relativo, ma deve usare un'estensione .cer. |
| --verification-code | String | Specifica il codice di verifica da usare per il servizio di sicurezza di Azure Sphere durante la generazione del certificato. |
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| --indice | Intero | Specifica l'indice del certificato da scaricare. Eseguire azsphere ca-certificate list per elencare i certificati e i valori di indice. Se non viene specificato alcun indice, viene scaricato il certificato attivo. È possibile specificare il valore di indice o l'identificazione personale. |
| --Identificazione personale | String | Specifica l'identificazione personale del certificato da scaricare. Eseguire azsphere ca-certificate list per elencare i certificati e i valori di identificazione personale. Se non viene specificata alcuna identificazione personale, viene scaricato il certificato attivo. È possibile specificare il valore di indice o l'identificazione personale. |
| -t, --tenant | GUID o nome | Specifica il tenant in cui eseguire questa operazione. Esegue l'override del tenant selezionato predefinito. È possibile specificare l'ID tenant o il nome del tenant. |
Parametri globali
Per l'interfaccia della riga di comando di Azure Sphere sono disponibili i parametri globali seguenti:
| Parametro | Descrizione |
|---|---|
| --debug | Aumenta il livello di dettaglio della registrazione per visualizzare tutti i log di debug. Se si rilevano bug, fornire l'output generato con il flag --debug attivato quando si invia la segnalazione. |
| -h, --help | Stampa informazioni di riferimento sull'interfaccia della riga di comando sui comandi e sui relativi argomenti ed elenchi di sottogruppi e comandi disponibili. |
| --only-show-errors | Visualizza solo gli errori, eliminando gli avvisi. |
| -o, --output | Modifica il formato di output. I formati di output disponibili sono json, jsonc (JSON colorato), tsv (valori delimitati da tabulazioni), tabella (tabelle ASCII leggibili) e yaml. Per impostazione predefinita, l'output dell'interfaccia della riga di comando è in formato table. Per altre informazioni sui formati di output disponibili, vedere Formato di output per i comandi dell'interfaccia della riga di comando di Azure Sphere. |
| --query | Usa il linguaggio di query JMESPath per filtrare l'output restituito dai servizi di sicurezza di Azure Sphere. Per altre informazioni ed esempi, vedere Esercitazione su JMESPath e Eseguire query sull'output dei comandi dell'interfaccia della riga di comando di Azure. |
| --verbose | Stampa informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili. Usare --debug per i log di debug completi. |
Nota
Se si usa l'interfaccia della riga di comando classica di Azure Sphere, vedere Parametri globali per altre informazioni sulle opzioni disponibili.
Esempio
azsphere ca-certificate download-proof --destination validation.cer --verification-code 123412341234 --index 1
Succeeded
list
Elenca tutti i certificati per il tenant corrente.
Parametri facoltativi
| Parametro | Tipo | Descrizione |
|---|---|---|
| -t, --tenant | GUID o nome | Specifica il tenant in cui eseguire questa operazione. Esegue l'override del tenant selezionato predefinito. È possibile specificare l'ID tenant o il nome del tenant. |
Parametri globali
Per l'interfaccia della riga di comando di Azure Sphere sono disponibili i parametri globali seguenti:
| Parametro | Descrizione |
|---|---|
| --debug | Aumenta il livello di dettaglio della registrazione per visualizzare tutti i log di debug. Se si rilevano bug, fornire l'output generato con il flag --debug attivato quando si invia la segnalazione. |
| -h, --help | Stampa informazioni di riferimento sull'interfaccia della riga di comando sui comandi e sui relativi argomenti ed elenchi di sottogruppi e comandi disponibili. |
| --only-show-errors | Visualizza solo gli errori, eliminando gli avvisi. |
| -o, --output | Modifica il formato di output. I formati di output disponibili sono json, jsonc (JSON colorato), tsv (valori delimitati da tabulazioni), tabella (tabelle ASCII leggibili) e yaml. Per impostazione predefinita, l'output dell'interfaccia della riga di comando è in formato table. Per altre informazioni sui formati di output disponibili, vedere Formato di output per i comandi dell'interfaccia della riga di comando di Azure Sphere. |
| --query | Usa il linguaggio di query JMESPath per filtrare l'output restituito dai servizi di sicurezza di Azure Sphere. Per altre informazioni ed esempi, vedere Esercitazione su JMESPath e Eseguire query sull'output dei comandi dell'interfaccia della riga di comando di Azure. |
| --verbose | Stampa informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili. Usare --debug per i log di debug completi. |
Nota
Se si usa l'interfaccia della riga di comando classica di Azure Sphere, vedere Parametri globali per altre informazioni sulle opzioni disponibili.
Esempio
Se il tenant predefinito non è selezionato, potrebbe essere visualizzato un messaggio per impostare il tenant predefinito.
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
----- ---------------------------------------- --------------------------------------------------------------- ------ ----------------- -----------------