テナントを管理する
重要
これは Azure Sphere (レガシ) のドキュメントです。 Azure Sphere (レガシ) は 2027 年 9 月 27 日に 再提供されておりユーザーは現時点で Azure Sphere (統合) に移行する必要があります。 TOC の上にある Version セレクターを使用して、Azure Sphere (統合) のドキュメントを表示します。
Azure Sphere テナントを使用すると、組織は自分たちの Azure Sphere デバイスを他のお客様のデバイスから切り離して、安全にリモートで管理することができます。 組織は Azure Sphere テナントを作成し、各デバイスをそのテナントに要求する必要があります。これにより、これらのデバイスをリモートで安全に管理できるようになります。
前提条件
- Azure Sphere SDK for Windows または Linux の場合をインストールします。
- 以前にテナントの作成に使用されていない、未請求のデバイスが必要です。
Azure Sphere テナントを作成する
Azure Sphere テナントは、Azure Sphere デバイスを分離し、アプリケーションを整理してデプロイする方法を提供します。 テナントを作成するアカウントには、自動的に、テナントの管理者のロールが割り当てられます。
ヒント
- 一度作成されたテナントは削除できず、テナント間でデバイスを移行することはできません。 チームまたは組織に既に Azure Sphere テナントがある場合は、追加のテナントを作成するのではなく、そのテナントへのアクセスを要求することを検討してください。
Azure Sphere テナントを作成するには:
Azure Sphere デバイスを USB でコンピューターに接続します。
PowerShell、Windows コマンド プロンプト、または Linux コマンド シェルを使用して Azure Sphere CLI を開きます。
テナントを作成するには、次のコマンドを入力します。
azsphere tenant create --name <tenant-name or tenant-ID><テナント名>を、"Contoso Ltd" や "Contoso Dishwasher Division" など、他のユーザーが認識できる名前に置き換えます。テナントに名前を付けるとき、英数字とスペースのみを使用します。 スペースを含める場合は、名前を引用符で囲みます。 名前はスペースで始まるか、50 文字を超えてはなりません。 特殊文字は使用できません。 名前は大文字と小文字が区別されます。
テナントの作成時に、Azure Sphere Security Service によって、接続されているデバイスのデバイス ID が記録されます。 デバイス ID ごとに、1 つの Azure Sphere テナントを作成できます。
アカウントに既に Azure Sphere テナントへのアクセス権がある場合、コマンドは失敗し、既存のテナントを使用することをお勧めします。 新しいテナントを作成することが確実な場合は、 --force-additional パラメーターを使用して、新しい Azure Sphere テナントを強制的に作成できます。
azsphere tenant create コマンドはテナントを作成しますが、デバイスをテナントに要求しません。 詳細については、「 デバイスを作成する」を参照してください。
API を使用してテナントを作成するには、 Tenants - Create 操作を使用します。
既定のテナントを表示して選択する
azsphere tenant show-selected を実行して、選択したテナントがこの PC の既定値として使用されることを確認します。
既定のテナントを変更または選択するには、 azsphere tenant select を実行します。
ヒント
ログアウトして Azure Sphere Security Service にもう一度ログインすると、既定のテナントを選択するように求められる場合があります。 必ず、Azure Sphere デバイスの管理に使用するアカウントでサインインしてください。
テナントを一覧表示します。
次のオプションを使用して、使用可能な Azure Sphere テナントを一覧表示できます。
次のコマンドを実行して、使用可能な Azure Sphere テナントを一覧表示します。
azsphere tenant list
API を使用してテナントを一覧表示するには、 Tenants - Get 操作を使用します。
既存のテナントを更新する
Azure Sphere CLI または Azure Sphere パブリック API を使用して、既存の Azure Sphere テナントの名前を変更できます。 テナントに名前を付けるときは、英数字を使用してください。 特殊文字は使用できません。 名前は 50 文字を超えてはなりません。大文字と小文字は区別されます。
CLI を使用してテナントを更新するには、次のコマンドを実行します。
azsphere tenant update --tenant a323c263-2aa3-2559-aabb-a3fc32631900 --new-name Tenant2
ヒント
既定のテナントが選択されていない場合は、メッセージが表示されることがあります。 一覧から必要なテナントを選択し、コマンドを再試行します。
API を使用してテナントを更新するには、 Tenants - Patch 操作を使用します。
テナントのエラー レポートをダウンロードする
テナント内のすべてのデバイスのエラー レポートを取得するには、 azsphere tenant download-error-report コマンドを使用します。