Partage via

image

  • Article

Important

Il s’agit de la documentation Azure Sphere (héritée). Azure Sphere (hérité) prend sa retraite le 27 septembre 2027 et les utilisateurs doivent migrer vers Azure Sphere (intégré) pour l’instant. Utilisez le sélecteur de version situé au-dessus du TOC pour afficher la documentation Azure Sphere (intégrée).

Gère les images Azure Sphere sur le disque.

Operation Description
add Charge une nouvelle image.
télécharger Télécharge une image.
show Affiche les informations de l’image spécifiée.

add

Charge une nouvelle image sur votre locataire Azure Sphere.

Paramètres obligatoires

Paramètre Type Description
--image Chaîne Spécifie le chemin d’accès à l’image à charger.

Paramètres facultatifs

Paramètre Type Description
-t, --tenant GUID ou nom Spécifie le locataire dans lequel effectuer cette opération. Remplace le locataire sélectionné par défaut. Vous pouvez spécifier l’ID de locataire ou le nom du locataire.
--temporaire Boolean Marque le package d’images comme temporaire. Ce paramètre s’utilise durant le processus de fabrication.
--force Boolean Force le chargement d’images à l’aide d’une API bêta.
-r, --regional-data-boundary Chaîne Limite de données régionales pour cette image. Valeurs autorisées : EU, None. La valeur par défaut est None. Si aucune valeur n’est spécifiée, la valeur par défaut est utilisée. Pour plus d’informations, consultez Configurer les vidages sur incident - Considérations relatives à Pivacy
Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre Description
--debug Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere image add --image C:\sample\quickstart_steps\QuickStart-AzureSphereBlink1\QuickStart-AzureSphereBlink1\out\ARM-Debug\QuickStart-AzureSphereBlink1.imagepackage --temporary
Uploading image from file 'C:\sample\quickstart_steps\QuickStart-AzureSphereBlink1\QuickStart-AzureSphereBlink1\out\ARM-Debug\QuickStart-AzureSphereBlink1.imagepackage':
 --> Image ID:       d788fdd1-28eb-4477-9818-a4734289f2f1
 --> Component ID:   99d419ef-296d-43b0-ade1-809efe3a7aba
 --> Component name: 'QuickStart-AzureSphereBlink1'
Retaining temporary state for uploaded image.
Successfully uploaded image with ID 'd788fdd1-28eb-4477-9818-a4734289f2f1' and name 'QuickStart-AzureSphereBlink1' to component with ID '99d419ef-296d-43b0-ade1-809efe3a7aba'.

télécharger

Télécharge une image existante à partir de votre locataire Azure Sphere.

Paramètres obligatoires

Paramètre Type Description
-i, --image Chaîne Spécifie l’ID de l’image à télécharger. Exécutez la commande azsphere image add pour obtenir l’ID d’image.
--destination Chaîne Spécifie le chemin et le nom de fichier à utiliser pour enregistrer l’image. Le chemin d’accès au fichier peut être un chemin absolu ou relatif.

Paramètres facultatifs

Paramètre Type Description
-t, --tenant GUID ou nom Spécifie le locataire dans lequel effectuer cette opération. Remplace le locataire sélectionné par défaut. Vous pouvez spécifier l’ID de locataire ou le nom du locataire.
Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre Description
--debug Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere image download --image d788fdd1-28eb-4477-9818-a4734289f2f1 --destination AzureSphereBlink1.image
Getting the image with ID 'd788fdd1-28eb-4477-9818-a4734289f2f1'.
 ---------
 Result
 =========
 Succeeded
 ---------

show

Affiche les détails d’une image existante à partir de votre locataire Azure Sphere.

Paramètres obligatoires

Paramètre Type Description
-i, --image GUID Spécifie l’ID de l’image pour lequel obtenir les détails. Exécutez la commande azsphere image add pour obtenir l’ID d’image.

Paramètres facultatifs

Paramètre Type Description
-t, --tenant GUID ou nom Spécifie le locataire dans lequel effectuer cette opération. Remplace le locataire sélectionné par défaut. Vous pouvez spécifier l’ID de locataire ou le nom du locataire.
Paramètres globaux

Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :

Paramètre Description
--debug Augmente la détail de journalisation pour afficher tous les journaux de débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.
-h, --help Imprime les informations de référence cli sur les commandes et leurs arguments et listes disponibles sous-groupes et commandes.
--only-show-errors Affiche uniquement les erreurs, en supprimant les avertissements.
-o, --output Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’homme) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez le format de sortie pour les commandes CLI Azure Sphere.
--query Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interrogez la sortie de commande Azure CLI.
--verbose Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez --debug pour les journaux de débogage complets.

Remarque

Si vous utilisez Azure Sphere Classic CLI, consultez les paramètres globaux pour plus d’informations sur les options disponibles.

Exemple

azsphere image show --image d788fdd1-28eb-4477-9818-a4734289f2f1
------------------------------------ ------------------------------------ ---------------------------- ------------- ------------  ---------------------
ImageId                              ComponentId                          Name                         SigningStatus ImageType     RegionalDataBoundary
========================================================================================================================================================
d788fdd1-28eb-4477-9818-a4734289f2f1 99d419ef-296d-43b0-ade1-809efe3a7aba QuickStart-AzureSphereBlink1 Succeeded     Applications  None
------------------------------------ ------------------------------------ ---------------------------- ------------- ------------  ---------------------