Gérer les locataires

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).

Un locataire Azure Sphere offre une façon sécurisée à votre organisation de gérer à distance ses appareils Azure Sphere séparément des appareils d’autres clients. Votre organisation doit créer un locataire Azure Sphere, puis revendiquer chacun de ses appareils dans ce locataire, pour vous permettre de gérer ces appareils à distance et de façon sécurisée.

Prérequis

• Installez le Kit de développement logiciel (SDK) Azure Sphere pour Windows ou Linux.
• Vous devez disposer d’un appareil non revendiqué qui n’a pas été utilisé précédemment pour créer un locataire.

Créer un locataire Azure Sphere

Un locataire Azure Sphere isole vos appareils Azure Sphere et vous permet d’organiser et de déployer des applications. Le compte qui crée le locataire se voit automatiquement attribuer le rôle d’administrateur pour le locataire.

Conseil

• Une fois qu’un locataire est créé, il ne peut pas être supprimé et les appareils ne peuvent pas être migrés entre les locataires. Si votre équipe ou votre organisation dispose déjà d’un locataire Azure Sphere, envisagez de demander l’accès à celui-ci plutôt que de créer un locataire supplémentaire.

Pour créer un locataire Azure Sphere :

1. Connectez un appareil Azure Sphere à votre ordinateur par USB.

2. Ouvrez une interface CLI Azure Sphere à l’aide de PowerShell, d’une invite de commandes Windows ou d’un interpréteur de commandes Linux.

3. Connectez-vous à l’interface CLI en suivant les instructions fournies ici.

4. Pour créer le locataire, entrez la commande suivante :

   azsphere tenant create --name <tenant-name or tenant-ID>
   

   Remplacez <le nom> du locataire par un nom que d’autres utilisateurs peuvent reconnaître, tels que « Contoso Ltd » ou « Contoso Lave-vaisselle Division ». Lorsque vous nommez votre locataire, utilisez uniquement des caractères alphanumériques et des espaces. Si vous incluez des espaces, placez le nom entre guillemets. Le nom ne doit pas commencer par un espace ou dépasser 50 caractères. Les caractères spéciaux ne sont pas autorisés. Les noms respectent la casse.

Quand vous créez un locataire, le service de sécurité Azure Sphere enregistre l’ID de l’appareil attaché. Chaque ID d’appareil peut être utilisé pour créer un seul locataire Azure Sphere.

Si votre compte a déjà accès à un locataire Azure Sphere, la commande échoue, vous conseillant d’utiliser le locataire existant. Si vous êtes sûr de vouloir créer un locataire, vous pouvez utiliser le paramètre pour forcer la --force-additional création d’un nouveau locataire Azure Sphere.

La commande azsphere tenant create crée un locataire, mais ne revendique pas l’appareil dans le locataire. Pour plus d’informations, consultez Revendication de votre appareil.

Pour créer un locataire à l’aide de l’API, utilisez l’opération Tenants - Créer .

Afficher et sélectionner le locataire par défaut

Exécutez azsphere tenant show-selected pour vérifier que le locataire sélectionné doit être utilisé comme valeur par défaut sur ce PC.

Pour modifier ou sélectionner le locataire par défaut, exécutez azsphere tenant select.

Conseil

Si vous vous déconnectez et reconnectez-vous au service de sécurité Azure Sphere, vous pouvez être invité à sélectionner le locataire par défaut. Veillez à vous connecter avec le compte que vous souhaitez utiliser pour gérer vos appareils Azure Sphere.

Répertorier les locataires

Vous pouvez répertorier les locataires Azure Sphere disponibles à l’aide des options suivantes :

Interface DE ligne de commande Azure Sphere

Exécutez la commande suivante pour répertorier les locataires Azure Sphere disponibles.

azsphere tenant list

Pour répertorier un locataire à l’aide de l’API, utilisez l’opération Tenants - Get .

Visual Studio Code

Pour répertorier les locataires dans Visual Studio Code :

Sélectionnez l’icône Explorateur Azure Sphere dans la barre d’activité de Visual Studio Code pour ouvrir l’Explorateur Azure Sphere.

Si le volet Locataire affiche Se connecter pour afficher les locataires, connectez-vous à Azure Sphere et sélectionnez Actualiser pour afficher les locataires disponibles.

Visual Studio

Pour répertorier les locataires dans Visual Studio :

Sélectionnez Afficher>d’autres Explorateurs Windows>Azure Sphere pour ouvrir l’Explorateur Azure Sphere.

Si le volet Locataire affiche Se connecter pour afficher les locataires, connectez-vous à Azure Sphere et sélectionnez Actualiser pour afficher les locataires disponibles.

Mettre à jour un locataire existant

Vous pouvez utiliser Azure Sphere CLI ou l’API publique Azure Sphere pour renommer un locataire Azure Sphere existant. Lorsque vous nommez votre client, 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.

Pour mettre à jour un locataire à l’aide de l’interface CLI, exécutez la commande :

azsphere tenant update --tenant a323c263-2aa3-2559-aabb-a3fc32631900 --new-name Tenant2

Conseil

Un message peut s’afficher si le locataire par défaut n’est pas sélectionné. Sélectionnez le locataire requis dans la liste et réessayez la commande.

Pour mettre à jour un locataire à l’aide de l’API, utilisez l’opération Tenants - Patch .

Télécharger le rapport d’erreurs pour le locataire

Pour obtenir des rapports d’erreurs pour tous les appareils d’un locataire, utilisez la commande azsphere tenant download-error-report.