Locataire
Gère un locataire Azure Sphere.
Important
Les commandes azsphere tenant download-ca-certificate, azsphere tenant download-ca-certificate-chainet azsphere tenant download-validation-certificate sont obsolètes. Utilisez azsphere ca-certificate download, azsphere ca-certificate download-chain, azsphere ca-certificate download-proofet azsphere ca-certificate list à la place.
Dans l’interface CLI Azure Sphere, le locataire par défaut n’est pas automatiquement sélectionné lors de la création d’un locataire. Vous devez exécuter la commande azsphere tenant select pour sélectionner le locataire par défaut à utiliser pour l’utilisateur actuel sur le PC. Cela permet de s’assurer que le locataire par défaut est le bon à utiliser lors de l’exécution d’une opération ponctuelle que vous ne pouvez pas annuler, comme la revendication de l’appareil.
| Opération | Description |
|---|---|
| Créer | Crée un locataire. |
| download-error-report | Retourne des informations d’erreur pour les appareils au sein du locataire actuel. |
| Liste | Répertorie les locataires Azure Sphere disponibles. |
| Sélectionnez | Sélectionne le locataire Azure Sphere par défaut à utiliser sur cet ordinateur. |
| show-selected | Affiche le locataire Azure Sphere par défaut pour cet ordinateur. |
| mettre à jour | Mises à jour les détails du locataire, tels que le nom du locataire. |
Créer
Crée un locataire Azure Sphere. Un appareil attaché est nécessaire pour exécuter cette commande. Pour plus d’informations, consultez Créer un locataire Azure Sphere.
Si vous avez déjà un locataire et que vous êtes certain d’en vouloir un autre, utilisez le --force-additional paramètre . Actuellement, vous ne pouvez pas supprimer un locataire Azure Sphere.
Une fois le locataire créé, exécutez azsphere tenant select pour sélectionner le locataire par défaut à utiliser pour l’utilisateur actuel sur ce PC. Vous pouvez ajouter des rôles pour les utilisateurs dans le locataire Azure Sphere actuel à l’aide de la commande azsphere role add .
La commande azsphere tenant create fonctionne avec un appareil Azure Sphere attaché localement. Si vous essayez la commande sans appareil attaché, vous recevrez une erreur. L’ID d’appareil est enregistré lorsque vous créez un locataire, et un seul locataire peut être créé par appareil.
Paramètres requis
| Paramètre | Type | Description |
|---|---|---|
| -n, --name | String | Spécifie un nom pour le locataire. Lorsque vous nommez votre locataire, utilisez des caractères alphanumériques. Les caractères spéciaux ne sont pas autorisés. Le nom ne doit pas dépasser 50 caractères et respecte la casse. |
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| -d, --device | String | Spécifie l’appareil sur lequel exécuter la commande lorsque plusieurs appareils sont attachés. Ce paramètre est obligatoire lorsque plusieurs appareils sont attachés. L’appareil actuellement attaché est utilisé par défaut. Vous pouvez spécifier l’ID d’appareil, l’adresse IP ou l’ID de connexion locale de l’appareil attaché. Azure Sphere CLI prend en charge plusieurs appareils MT3620 sur Windows, mais vous ne pouvez connecter qu’un seul appareil à la fois sur Linux. Pour cette raison, ce paramètre est pris en charge pour Windows, mais pas pour Linux. Une erreur est retournée si vous utilisez ce paramètre avec la commande sur Linux. |
| --force-additional | Boolean | Force la création d’un locataire Azure Sphere. Utilisez cette commande uniquement si vous êtes certain de vouloir utiliser le compte actuel pour créer un locataire Azure Sphere à l’aide de l’appareil attaché. |
| --disable-confirm-prompt | Boolean | Désactive l’invite de confirmation de l’utilisateur. |
Paramètres globaux
Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :
| Paramètre | Description |
|---|---|
| --Debug | Augmente le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez Paramètres globaux pour plus d’informations sur les options disponibles.
Exemple
azsphere tenant create --name MyTenant
Utilisez les --force-additional paramètres et --disable-confirm-prompt si vous êtes certain de vouloir utiliser ce compte pour créer un locataire Azure Sphere à l’aide de l’appareil attaché. Un appareil précédemment utilisé pour créer un locataire Azure Sphere ne peut pas être utilisé pour créer un locataire.
azsphere tenant create --name MyTenant --force-additional
You have logged in with the following account:
bob@contoso.com
Do you want to use this account to create a new Azure Sphere tenant using the attached device?
You cannot change the tenant name 'MyTenant1' once it has been created.
Enter 'yes' to continue. Enter anything else to exit.
yes
> verbose: TraceId: c761ba73-761e-4df2-94f5-3f87384d71b7
Created a new Azure Sphere tenant:
--> Tenant Name: MyTenant1
--> Tenant ID: 768c2cd6-059a-49ad-9f53-89f5271cea15
Please use 'azsphere tenant select --tenant MyTenant' to select the created tenant.
Pointe
Une fois que vous avez créé un locataire, veillez à exécuter azsphere tenant select pour sélectionner le locataire par défaut à utiliser pour l’utilisateur actuel sur ce PC.
download-error-report
Retourne des informations sur les erreurs signalées par les appareils au sein du locataire actuel.
Cette commande extrait les données d’événement du cloud Azure Sphere Security Service et ne nécessite pas de connexion physique à un appareil particulier. La commande azsphere tenant download-error-report fonctionne dans le contexte du locataire actuel et retourne des rapports d’erreurs pour tous les appareils de ce locataire.
Note
Le téléchargement des événements récemment signalés peut prendre jusqu’à 24 heures. Pour plus d’informations, consultez Collecter et interpréter des données d’erreur.
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| --Destination | String | Spécifie le chemin d’accès et le nom du fichier de sortie. |
| -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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez Paramètres globaux pour plus d’informations sur les options disponibles.
Exemple
azsphere tenant download-error-report --destination c:\error-report.csv --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb
Liste
Répertorie les locataires Azure Sphere.
Paramètres globaux
Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :
| Paramètre | Description |
|---|---|
| --Debug | Augmente le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez Paramètres globaux pour plus d’informations sur les options disponibles.
Exemple
azsphere tenant list
------------------------------------ --------------------- -------------
Id Name Roles
========================================================================
143adbc9-1bf0-4be2-84a2-084a331d81cb MyTenant Administrator
Contributor
------------------------------------ --------------------- -------------
Sélectionnez
Sélectionne le locataire Azure Sphere par défaut à utiliser pour l’utilisateur actuel sur ce PC.
Pour afficher le locataire par défaut actuel, utilisez azsphere tenant show-selected.
Paramètres requis
| 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez Paramètres globaux pour plus d’informations sur les options disponibles.
Exemple
azsphere tenant select --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb
------------------------------------ --------------------- -------------
Id Name Roles
========================================================================
143adbc9-1bf0-4be2-84a2-084a331d81cb MyTenant Administrator
Contributor
------------------------------------ --------------------- -------------
show-selected
Affiche les détails du locataire Azure Sphere par défaut pour l’utilisateur actuel sur ce PC.
Il s’agit du locataire sélectionné avec la commande azsphere tenant select .
Paramètres globaux
Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :
| Paramètre | Description |
|---|---|
| --Debug | Augmente le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez Paramètres globaux pour plus d’informations sur les options disponibles.
Exemple
azsphere tenant show-selected
------------------------------------ --------------------- -------------
Id Name Roles
========================================================================
143adbc9-1bf0-4be2-84a2-084a331d81cb MyTenant Administrator
Contributor
------------------------------------ --------------------- -------------
mettre à jour
Mises à jour les détails d’un locataire, tels que le nom du locataire.
Paramètres requis
| Paramètre | Type | Description |
|---|---|---|
| -n, --new-name | String | Spécifie un nouveau nom pour le locataire. Lorsque vous nommez votre locataire, utilisez des caractères alphanumériques. Les caractères spéciaux ne sont pas autorisés. Le nom ne doit pas dépasser 50 caractères et respecte la casse. |
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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --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’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | 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 interroger la sortie de la 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 pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez Paramètres globaux pour plus d’informations sur les options disponibles.
Exemple
azsphere tenant update --tenant a323c263-2aa3-2559-aabb-a3fc32631900 --new-name Tenant2
------------------------------------ --------------------- -------------
Id Name Roles
========================================================================
a323c263-2aa3-2559-aabb-a3fc32631900 Tenant2 Administrator
Contributor
------------------------------------ --------------------- -------------
Pointe
Si vous n’avez pas sélectionné de locataire par défaut, une liste de locataires disponibles s’affiche. Définissez votre locataire par défaut en sélectionnant l’une des options.