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

Клиент 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 с помощью PowerShell, командной строки Windows или командной оболочки Linux.

3. Войдите в ИНТЕРФЕЙС командной строки, следуя инструкциям здесь.

4. Чтобы создать клиент, введите следующую команду:

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

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

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

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

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

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

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

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

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

Совет

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

Перечисление клиентов

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

Интерфейс командной строки Azure Sphere

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

azsphere tenant list

Чтобы получить список клиентов с помощью API, используйте операцию 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 или общедоступный API Azure Sphere для переименования существующего клиента Azure Sphere. Имя вашего клиента должно содержать буквы и цифры. Использовать специальные знаки не допускается. Имя не должно превышать 50 символов и учитывает регистр.

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

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

Совет

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

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

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

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