Управление клиентами

Клиент Azure Sphere предоставляет организациям безопасный способ удаленного управления устройствами Azure Sphere в изоляции от устройств других клиентов. Ваша организация должна создать клиент Azure Sphere, а затем запросить каждое из своих устройств в этом клиенте, чтобы вы могли управлять этими устройствами удаленно и безопасно.

Необходимые условия

• Установите пакет SDK Azure Sphere для Windows или Linux.
• Необходимо невостребованное устройство, которое ранее не использовалось для создания клиента.

Создание клиента Azure Sphere

Клиент Azure Sphere изолирует устройства Azure Sphere и предоставляет способ организации и развертывания приложений. Учетной записи, создающей клиент, автоматически назначается роль администратора клиента.

Совет

• После создания клиента его нельзя удалить, а устройства нельзя перенести между клиентами. Если у вашей команды или организации уже есть клиент Azure Sphere, рассмотрите возможность запроса доступа к нему, а не создания дополнительного клиента.

Чтобы создать клиент Azure Sphere, выполните приведенные далее действия.

1. Подключите устройство Azure Sphere к компьютеру с помощью USB.

2. Откройте Azure Sphere CLI с помощью PowerShell, командной строки Windows или командной оболочки Linux и введите следующую команду:

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

   Замените <имя> клиента именем, которое могут распознавать другие пользователи, например Contoso Ltd или Contoso Посудомоечная машина. При присвоении имени клиенту используйте только буквенно-цифровые символы и пробелы. Если вы включаете пробелы, заключите имя в кавычки. Имя не должно начинаться с пробела или превышать 50 символов. Специальные символы не допускаются. В именах учитывается регистр.

При создании клиента служба безопасности Azure Sphere записывает идентификатор подключенного устройства. Каждый идентификатор устройства можно использовать для создания только одного клиента Azure Sphere.

Параметр можно использовать для --force-additional принудительного создания нового клиента Azure Sphere. Используйте эту команду, только если вы уверены, что хотите использовать текущую учетную запись для создания нового клиента Azure Sphere с помощью подключенного устройства. Устройство, которое ранее использовалось для создания клиента Azure Sphere, не может использоваться для создания нового клиента.

Команда azsphere tenant create создает клиент, но не запрашивает устройство в клиенте. Дополнительные сведения см. в разделе Утверждение устройства.

Чтобы создать клиент с помощью API, используйте операцию Tenants — Create .

Отображение и выбор клиента по умолчанию

Выполните команду azsphere tenant show-selected , чтобы убедиться, что выбранный клиент должен использоваться по умолчанию на этом компьютере.

Чтобы изменить или выбрать клиент по умолчанию, выполните команду azsphere tenant select.

Совет

При выходе и повторном входе в службу безопасности Azure Sphere может появиться запрос на выбор клиента по умолчанию. Обязательно войдите с учетной записью, которую вы хотите использовать для управления устройствами Azure Sphere.

Вывод списка клиентов

Список доступных клиентов Azure Sphere можно получить с помощью следующих параметров:

Azure Sphere CLI

Выполните следующую команду, чтобы получить список доступных клиентов Azure Sphere.

azsphere tenant list

Чтобы получить список клиента, использующего API, используйте операцию Tenants — Get .

Visual Studio Code

Чтобы получить список клиентов в Visual Studio Code, выполните следующие действия:

Щелкните значок Обозреватель Azure Sphere на панели действий Visual Studio Code, чтобы открыть azure Sphere Обозреватель.

Если на панели арендатора отображается вход для просмотра клиентов, войдите в Azure Sphere и нажмите кнопку Обновить , чтобы просмотреть доступные клиенты.

Visual Studio

Чтобы получить список клиентов в Visual Studio, выполните следующие действия:

Выберите Просмотреть>другие Обозреватель Windows>Azure Sphere, чтобы открыть Обозреватель Azure Sphere.

Если на панели арендатора отображается вход для просмотра клиентов, войдите в Azure Sphere и нажмите кнопку Обновить , чтобы просмотреть доступные клиенты.

Обновление существующего клиента

Вы можете использовать Azure Sphere CLI или общедоступный API Azure Sphere для переименования существующего клиента Azure Sphere. При именовании клиента используйте буквенно-цифровые символы. Специальные символы не допускаются. Имя не должно превышать 50 символов и учитывает регистр.

Чтобы обновить клиент с помощью интерфейса командной строки, выполните команду:

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

Совет

Если клиент по умолчанию не выбран, может отобразиться сообщение. Выберите требуемый клиент из списка и повторите команду.

Чтобы обновить клиент с помощью API, используйте операцию "Клиенты — исправление ".

Скачивание отчета об ошибке для клиента

Чтобы получить отчеты об ошибках для всех устройств в клиенте, используйте команду azsphere tenant download-error-report .