Verwalten von Mandanten

Wichtig

Dies ist die Dokumentation zu Azure Sphere (Legacy). Azure Sphere (Legacy) wird am 27. September 2027 eingestellt, und Benutzer müssen bis zu diesem Zeitpunkt zu Azure Sphere (integriert) migrieren. Verwenden Sie die Versionsauswahl oberhalb des Inhaltsverzeichniss, um die Dokumentation zu Azure Sphere (Integriert) anzuzeigen.

Ein Azure Sphere-Mandant bietet Ihrer Organisation eine sichere Methode zur Remoteverwaltung ihrer Azure Sphere-Geräte unabhängig von den Geräten anderer Kunden. Ihre Organisation muss einen Azure Sphere-Mandanten erstellen und dann jedes Ihrer Geräte in diesem Mandanten anfordern, damit Sie diese Geräte remote und sicher verwalten können.

Voraussetzungen

• Installieren Sie das Azure Sphere SDK für Windows oder für Linux.
• Sie müssen über ein nicht beanspruchtes Gerät verfügen, das zuvor nicht zum Erstellen eines Mandanten verwendet wurde.

Erstellen eines Azure Sphere-Mandanten

Ein Azure Sphere-Mandant isoliert Ihre Azure Sphere-Geräte und bietet ihnen die Möglichkeit, Anwendungen zu organisieren und bereitzustellen. Dem Konto, mit dem der Mandant erstellt wird, wird automatisch die Administratorrolle für den Mandanten zugewiesen.

Tipp

• Nachdem ein Mandant erstellt wurde, kann er nicht gelöscht werden, und Geräte können nicht zwischen Mandanten migriert werden. Wenn Ihr Team oder Ihre Organisation bereits über einen Azure Sphere-Mandanten verfügt, erwägen Sie, den Zugriff darauf anzufordern, anstatt einen zusätzlichen Mandanten zu erstellen.

So erstellen Sie einen Azure Sphere-Mandanten:

1. Schließen Sie ein Azure Sphere-Gerät per USB an Ihren Computer an.

2. Öffnen Sie eine Azure Sphere CLI mit PowerShell, Windows-Eingabeaufforderung oder Linux-Befehlsshell.

3. Melden Sie sich bei der CLI an, folgen Sie den Anweisungen hier.

4. Um den Mandanten zu erstellen, geben Sie den folgenden Befehl ein:

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

   Ersetzen Sie <den Mandantennamen> durch einen Namen, den andere Benutzer erkennen können, z. B. "Contoso Ltd" oder "Contoso-Geschirrspülungsabteilung". Wenn Sie Ihren Mandanten benennen, verwenden Sie nur alphanumerische Zeichen und Leerzeichen. Wenn Sie Leerzeichen einfügen, schließen Sie den Namen in Anführungszeichen ein. Der Name darf nicht mit einem Leerzeichen beginnen oder 50 Zeichen überschreiten. Sonderzeichen sind nicht zulässig. Bei Namen wird die Groß-/Kleinschreibung beachtet.

Wenn Sie einen Mandanten erstellen, erfasst der Azure Sphere-Sicherheitsdienst die Geräte-ID des angeschlossenen Geräts. Pro Geräte-ID kann immer nur ein einzelner Azure Sphere-Mandant erstellt werden.

Wenn Ihr Konto bereits Zugriff auf einen Azure Sphere-Mandanten hat, schlägt der Befehl fehl und weist Sie auf, den vorhandenen Mandanten zu verwenden. Wenn Sie sicher sind, dass Sie einen neuen Mandanten erstellen möchten, können Sie den --force-additional Parameter verwenden, um zu erzwingen, dass ein neuer Azure Sphere-Mandant erstellt wird.

Der Azsphere-Mandant-Create-Befehl erstellt einen Mandanten, beansprucht jedoch nicht das Gerät im Mandanten. Weitere Informationen finden Sie unter Anspruch auf Ihr Gerät.

Um einen Mandanten mithilfe der API zu erstellen, verwenden Sie den Mandanten - Create-Vorgang .

Anzeigen und Auswählen des Standardmandanten

Führen Sie azsphere-Mandant aus, um zu überprüfen, ob der ausgewählte Mandant als Standard auf diesem PC verwendet werden soll.

Um den Standardmandanten zu ändern oder auszuwählen, führen Sie azsphere-Mandantenauswahl aus.

Tipp

Wenn Sie sich abmelden und sich erneut beim Azure Sphere Security Service anmelden, werden Sie möglicherweise aufgefordert, den Standardmandanten auszuwählen. Melden Sie sich unbedingt mit dem Konto an, das Sie zum Verwalten Ihrer Azure Sphere-Geräte verwenden möchten.

Hiermit listen Sie Mandanten auf.

Sie können die verfügbaren Azure Sphere-Mandanten mithilfe der folgenden Optionen auflisten:

Azure Sphere CLI

Führen Sie den folgenden Befehl aus, um die verfügbaren Azure Sphere-Mandanten auflisten zu können.

azsphere tenant list

Um einen Mandanten mithilfe der API auflisten zu können, verwenden Sie die Mandanten - Get-Operation .

Visual Studio Code

So listen Sie Mandanten in Visual Studio Code auf:

Wählen Sie das Azure Sphere Explorer-Symbol in der Aktivitätsleiste von Visual Studio Code aus, um Azure Sphere Explorer zu öffnen.

Wenn im Mandantenbereich "Anmelden" angezeigt wird , um Mandanten anzuzeigen, melden Sie sich bei Azure Sphere an, und wählen Sie "Aktualisieren" aus, um die verfügbaren Mandanten anzuzeigen.

Visual Studio

So listen Sie Mandanten in Visual Studio auf:

Wählen Sie "Andere Windows>Azure Sphere Explorer anzeigen>" aus, um Azure Sphere Explorer zu öffnen.

Wenn im Mandantenbereich "Anmelden" angezeigt wird , um Mandanten anzuzeigen, melden Sie sich bei Azure Sphere an, und wählen Sie "Aktualisieren" aus, um die verfügbaren Mandanten anzuzeigen.

Aktualisieren eines vorhandenen Mandanten

Sie können die Azure Sphere CLI oder die öffentliche Azure Sphere-API verwenden, um einen vorhandenen Azure Sphere-Mandanten umzubenennen. Verwenden Sie bei der Benennung Ihres Mandanten alphanumerische Zeichen. Sonderzeichen sind nicht zulässig. Der Name darf 50 Zeichen nicht überschreiten und die Groß-/Kleinschreibung wird beachtet.

Führen Sie den Befehl aus, um einen Mandanten mithilfe der CLI zu aktualisieren:

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

Tipp

Eine Meldung wird möglicherweise angezeigt, wenn der Standardmandant nicht ausgewählt ist. Wählen Sie den erforderlichen Mandanten aus der Liste aus, und wiederholen Sie den Befehl.

Um einen Mandanten mithilfe der API zu aktualisieren, verwenden Sie den Mandanten - Patchvorgang .

Downloadfehlerbericht für Mandanten

Um Fehlerberichte für alle Geräte innerhalb eines Mandanten zu erhalten, verwenden Sie den Befehl "azsphere tenant download-error-report".