テナントの管理

  • [アーティクル]

Azure Sphere テナントは、organizationが他の顧客のデバイスから分離して Azure Sphere デバイスをリモートで管理するための安全な方法を提供します。 organizationは、Azure Sphere テナントを作成し、その各デバイスをそのテナントに要求して、それらのデバイスをリモートで安全に管理できるようにする必要があります。

前提 条件

  • Windows または Linux 用の Azure Sphere SDK をインストールします。
  • 以前にテナントの作成に使用されていない解放されていないデバイスが必要です。

Azure Sphere テナントを作成する

Azure Sphere テナントは、Azure Sphere デバイスを分離し、アプリケーションを整理してデプロイする方法を提供します。 テナントを作成するアカウントには、テナントの管理者ロールが自動的に割り当てられます。

ヒント

  • テナントを作成した後は削除できず、テナント間でデバイスを移行することはできません。 チームまたはorganizationに既に Azure Sphere テナントがある場合は、追加のテナントを作成するのではなく、そのテナントへのアクセスを要求することを検討してください。

Azure Sphere テナントを作成するには:

  1. USB を使用して Azure Sphere デバイスをコンピューターに接続します。

  2. PowerShell、Windows コマンド プロンプト、または Linux コマンド シェルを使用して Azure Sphere CLI を開き、次のコマンドを入力します。

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

    tenant-name> は、"Contoso Ltd" や "Contoso Dishwasher Division" など、他のユーザーが認識できる名前に置き換えます<。テナントに名前を付けた場合は、英数字とスペースのみを使用します。 スペースを含める場合は、名前を引用符で囲みます。 名前は、スペースで始まるか、50 文字を超えてはなりません。 特殊文字は使用できません。 名前では大文字と小文字が区別されます。

テナントを作成すると、Azure Sphere Security Service によって、接続されているデバイスのデバイス ID が記録されます。 各デバイス ID を使用して、Azure Sphere テナントを 1 つだけ作成できます。

パラメーターを --force-additional 使用して、新しい Azure Sphere テナントを強制的に作成できます。 このコマンドは、現在のアカウントを使用して、接続されているデバイスを使用して新しい Azure Sphere テナントを作成することが確実な場合にのみ使用します。 以前に 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 コマンドを使用します。