Spravovat tenanty
Důležité
Toto je dokumentace k Azure Sphere (starší verze). Azure Sphere (starší verze) se vyřazuje 27. září 2027 a uživatelé musí do této doby migrovat do Azure Sphere (integrované). K zobrazení dokumentace k Azure Sphere (integrované) použijte selektor verzí umístěný nad obsahem.
Klient služby Azure Sphere nabízí bezpečný způsob, jakým může vaše organizace vzdáleně spravovat zařízení Azure Sphere odděleně od ostatních zařízení zákazníků. Vaše organizace musí vytvořit tenanta Azure Sphere a potom v tomto tenantovi deklarovat každé ze svých zařízení, abyste mohli tato zařízení spravovat vzdáleně a zabezpečeně.
Požadavky
- Nainstalujte sadu Azure Sphere SDK pro Windows nebo Linux.
- Musíte mít nezařazené zařízení, které nebylo dříve použito k vytvoření tenanta.
Vytvoření tenanta Azure Sphere
Tenant Azure Sphere izoluje vaše zařízení Azure Sphere a poskytuje způsob, jak organizovat a nasazovat aplikace. Účet, který vytvoří tenanta, se automaticky přiřadí roli správce tenanta.
Tip
- Po vytvoření tenanta ho nejde odstranit a zařízení se nedají migrovat mezi tenanty. Pokud už váš tým nebo organizace má tenanta Azure Sphere, zvažte místo vytvoření dalšího tenanta žádost o přístup.
Vytvoření tenanta Azure Sphere:
Připojte zařízení Azure Sphere k počítači přes USB.
Otevřete Rozhraní příkazového řádku Azure Sphere pomocí PowerShellu, příkazového řádku Windows nebo příkazového prostředí Linuxu.
Přihlaste se k rozhraní příkazového řádku podle zde uvedených pokynů.
Pokud chcete vytvořit tenanta, zadejte následující příkaz:
azsphere tenant create --name <tenant-name or tenant-ID>
Nahraďte <název> tenanta názvem, který můžou rozpoznat jiní uživatelé, například Contoso Ltd nebo Contoso Myčka. Při pojmenování tenanta používejte pouze alfanumerické znaky a mezery. Pokud zahrnete mezery, uzavřete název do uvozovek. Název nesmí začínat mezerou nebo nesmí být delší než 50 znaků. Speciální znaky nejsou povoleny. V názvech se rozlišují malá a velká písmena.
Když vytvoříte tenanta, služba zabezpečení Azure Sphere zaznamená ID zařízení připojeného zařízení. Každé ID zařízení je možné použít k vytvoření pouze jednoho tenanta Azure Sphere.
Pokud už váš účet má přístup k tenantovi Azure Sphere, příkaz selže a doporučí vám použít existujícího tenanta. Pokud jste si jistí, že chcete vytvořit nového tenanta, můžete pomocí parametru --force-additional
vynutit vytvoření nového tenanta Azure Sphere.
Příkaz azsphere tenant create vytvoří tenanta, ale ne deklaruje zařízení do tenanta. Další informace najdete v tématu Deklarace zařízení.
Pokud chcete vytvořit tenanta pomocí rozhraní API, použijte operaci Tenants – Vytvořit .
Zobrazení a výběr výchozího tenanta
Spuštěním příkazu azsphere tenant show-selected ověřte, že se má vybraný tenant použít jako výchozí na tomto počítači.
Pokud chcete upravit nebo vybrat výchozího tenanta, spusťte příkaz azsphere tenant select.
Tip
Pokud se odhlásíte a znovu se přihlásíte ke službě zabezpečení Azure Sphere, může se zobrazit výzva k výběru výchozího tenanta. Přihlaste se pomocí účtu, který chcete použít ke správě zařízení Azure Sphere.
Výpis tenantů
Dostupné tenanty Azure Sphere můžete zobrazit pomocí následujících možností:
Spuštěním následujícího příkazu zobrazte seznam dostupných tenantů Azure Sphere.
azsphere tenant list
Pokud chcete zobrazit seznam tenanta pomocí rozhraní API, použijte operaci Tenants – Get .
Aktualizace existujícího tenanta
K přejmenování existujícího tenanta Azure Sphere můžete použít Rozhraní příkazového řádku Azure Sphere nebo veřejné rozhraní API Azure Sphere. Při pojmenování tenanta použijte alfanumerické znaky. Speciální znaky nejsou povoleny. Název nesmí překročit 50 znaků a rozlišují se malá a velká písmena.
Pokud chcete tenanta aktualizovat pomocí rozhraní příkazového řádku, spusťte příkaz:
azsphere tenant update --tenant a323c263-2aa3-2559-aabb-a3fc32631900 --new-name Tenant2
Tip
Pokud není vybraný výchozí tenant, může se zobrazit zpráva. V seznamu vyberte požadovaného tenanta a zkuste příkaz zopakovat.
Pokud chcete aktualizovat tenanta pomocí rozhraní API, použijte operaci Tenants – Patch .
Zpráva o chybě stahování pro tenanta
Pokud chcete získat zprávy o chybách pro všechna zařízení v rámci tenanta, použijte příkaz azsphere tenant download-error-report.