ca-certificaat
Beheert certificeringsinstantiecertificaten (CA) voor de huidige Azure Sphere-tenant. Zie Tenant-CA-certificaat beheren voor meer informatie.
| Bewerking | Beschrijving |
|---|---|
| Downloaden | Downloadt het CA-certificaat voor de huidige Azure Sphere-tenant als een X.509 CER-bestand. |
| download-keten | Downloadt de CA-certificaatketen voor de huidige Azure Sphere-tenant als een PKCS#7 .p7b-bestand. |
| download-proof | Downloadt een bewijs van bezit voor de huidige Azure Sphere-tenant als een X.509 CER-bestand. |
| Lijst | Lijst met alle certificaten voor de huidige Azure Sphere-tenant. |
Downloaden
Downloadt het CA-certificaat voor de huidige Azure Sphere-tenant als een X.509 CER-bestand.
Vereiste parameters
| Parameter | Type | Beschrijving |
|---|---|---|
| --Bestemming | Tekenreeks | Hiermee geeft u het pad en de bestandsnaam op waarop het CA-certificaat van de tenant moet worden opgeslagen. Het bestandspad kan een absoluut of relatief pad zijn, maar moet de extensie .cer hebben. |
Optionele parameters
| Parameter | Type | Beschrijving |
|---|---|---|
| --Index | Geheel getal | Hiermee geeft u de index van het certificaat te downloaden. Voer uit azsphere ca-certificate list om de certificaten en de indexwaarden weer te geven. Als er geen index wordt opgegeven, wordt het actieve certificaat gedownload. U kunt de indexwaarde of vingerafdruk opgeven. |
| --Vingerafdruk | Tekenreeks | Hiermee geeft u de vingerafdruk van het certificaat te downloaden. Voer uit azsphere ca-certificate list om de certificaten en de vingerafdrukwaarden weer te geven. Als er geen vingerafdruk wordt opgegeven, wordt het actieve certificaat gedownload. U kunt de indexwaarde of vingerafdruk opgeven. |
| -t, --tenant | GUID of naam | Hiermee geeft u de tenant op waarin deze bewerking moet worden uitgevoerd. Overschrijft de standaard geselecteerde tenant. U kunt de tenant-id of tenantnaam opgeven. |
Globale parameters
De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:
| Parameter | Beschrijving |
|---|---|
| --Debug | Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport. |
| -h, --help | Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten. |
| --only-show-errors | Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt. |
| -o, --output | Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen. |
| --Query | Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden. |
| --Uitgebreide | Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken. |
Opmerking
Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.
Voorbeeld
Voorbeeld van het opgeven van een index voor het downloaden van een vereist certificaat:
azsphere ca-certificate download --destination ca-cert.cer --index 1
Voorbeeld van het opgeven van vingerafdruk voor het downloaden van een vereist certificaat:
azsphere ca-certificate download --destination ca-cert.cer --thumbprint <value>
U ziet de uitvoer als volgt:
Succeeded
download-keten
Downloadt de CA-certificaatketen voor de huidige Azure Sphere-tenant als een PKCS#7 .p7b-bestand.
Vereiste parameters
| Parameter | Type | Beschrijving |
|---|---|---|
| --Bestemming | Tekenreeks | Hiermee geeft u het pad en de bestandsnaam op waarop de ca-certificaatketen van de tenant moet worden opgeslagen. U kunt een relatief of absoluut pad opgeven en moet de extensie .p7b gebruiken. |
Optionele parameters
| Parameter | Type | Beschrijving |
|---|---|---|
| --Index | Geheel getal | Hiermee geeft u de index van het certificaat te downloaden. Voer uit azsphere ca-certificate list om de certificaten en de indexwaarden weer te geven. Als er geen index wordt opgegeven, wordt het actieve certificaat gedownload. U kunt de indexwaarde of vingerafdruk opgeven. |
| --Vingerafdruk | Tekenreeks | Hiermee geeft u de vingerafdruk van het certificaat te downloaden. Voer uit azsphere ca-certificate list om de certificaten en de vingerafdrukwaarden weer te geven. Als er geen vingerafdruk wordt opgegeven, wordt het actieve certificaat gedownload. U kunt de indexwaarde of vingerafdruk opgeven. |
| -t, --tenant | GUID of naam | Hiermee geeft u de tenant op waarin deze bewerking moet worden uitgevoerd. Overschrijft de standaard geselecteerde tenant. U kunt de tenant-id of tenantnaam opgeven. |
Globale parameters
De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:
| Parameter | Beschrijving |
|---|---|
| --Debug | Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport. |
| -h, --help | Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten. |
| --only-show-errors | Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt. |
| -o, --output | Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen. |
| --Query | Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden. |
| --Uitgebreide | Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken. |
Opmerking
Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.
Voorbeeld
azsphere ca-certificate download-chain --destination CA-cert-chain.p7b --index 1
Succeeded
download-proof
Downloadt een bewijs van bezit voor de huidige Azure Sphere-tenant, voor gebruik met een opgegeven code en als een X.509.cer-bestand. Dit certificaat maakt deel uit van het apparaatverificatie- en attestation-proces. Zie Azure IoT gebruiken met Azure Sphere voor meer informatie over het gebruik van Azure Sphere-apparaten met Azure IoT.
Vereiste parameters
| Parameter | Type | Beschrijving |
|---|---|---|
| --Bestemming | Tekenreeks | Hiermee geeft u het pad en de bestandsnaam op waarop het bewijs van bezit moet worden opgeslagen. Het bestandspad kan een absoluut of relatief pad zijn, maar moet de extensie .cer gebruiken. |
| --verification-code | Tekenreeks | Hiermee geeft u de verificatiecode voor de Azure Sphere Security Service te gebruiken bij het genereren van het certificaat. |
Optionele parameters
| Parameter | Type | Beschrijving |
|---|---|---|
| --Index | Geheel getal | Hiermee geeft u de index van het certificaat te downloaden. Voer uit azsphere ca-certificate list om de certificaten en de indexwaarden weer te geven. Als er geen index wordt opgegeven, wordt het actieve certificaat gedownload. U kunt de indexwaarde of vingerafdruk opgeven. |
| --Vingerafdruk | Tekenreeks | Hiermee geeft u de vingerafdruk van het certificaat te downloaden. Voer uit azsphere ca-certificate list om de certificaten en de vingerafdrukwaarden weer te geven. Als er geen vingerafdruk wordt opgegeven, wordt het actieve certificaat gedownload. U kunt de indexwaarde of vingerafdruk opgeven. |
| -t, --tenant | GUID of naam | Hiermee geeft u de tenant op waarin deze bewerking moet worden uitgevoerd. Overschrijft de standaard geselecteerde tenant. U kunt de tenant-id of tenantnaam opgeven. |
Globale parameters
De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:
| Parameter | Beschrijving |
|---|---|
| --Debug | Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport. |
| -h, --help | Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten. |
| --only-show-errors | Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt. |
| -o, --output | Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen. |
| --Query | Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden. |
| --Uitgebreide | Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken. |
Opmerking
Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.
Voorbeeld
azsphere ca-certificate download-proof --destination validation.cer --verification-code 123412341234 --index 1
Succeeded
Lijst
Een lijst met alle certificaten voor de huidige tenant.
Optionele parameters
| Parameter | Type | Beschrijving |
|---|---|---|
| -t, --tenant | GUID of naam | Hiermee geeft u de tenant op waarin deze bewerking moet worden uitgevoerd. Overschrijft de standaard geselecteerde tenant. U kunt de tenant-id of tenantnaam opgeven. |
Globale parameters
De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:
| Parameter | Beschrijving |
|---|---|
| --Debug | Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport. |
| -h, --help | Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten. |
| --only-show-errors | Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt. |
| -o, --output | Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen. |
| --Query | Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden. |
| --Uitgebreide | Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken. |
Opmerking
Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.
Voorbeeld
Als de standaardtenant niet is geselecteerd, wordt er mogelijk een bericht weergegeven om de standaardtenant in te stellen.
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
----- ---------------------------------------- --------------------------------------------------------------- ------ ----------------- -----------------