Aktualizacja urządzenia na potrzeby zarządzania zasobami usługi IoT Hub

Centrum IoT. Zaleca się użycie warstwy S1 (Standardowa) lub nowszej.

• Centrum IoT. Zaleca się użycie warstwy S1 (Standardowa) lub nowszej.

• Środowisko wiersza poleceń platformy Azure

  • Użyj środowiska Bash w Azure Cloud Shell.

    

  • Jeśli wolisz uruchamiać polecenia referencyjne interfejsu wiersza polecenia lokalnie, zainstaluj interfejs wiersza polecenia platformy Azure

    • Zaloguj się do Azure CLI, używając polecenia az login.

    • Uruchom az version, aby sprawdzić zainstalowaną wersję i biblioteki zależne. Aby zaktualizować do najnowszej wersji, uruchom az upgrade.

    • Po wyświetleniu komunikatu zainstaluj rozszerzenia Azure CLI podczas pierwszego użycia. Polecenia w tym artykule używają rozszerzenia azure-iot. Uruchom polecenie az extension update --name azure-iot , aby upewnić się, że używasz najnowszej wersji rozszerzenia.

1. W portalu Azure wybierz pozycję Utwórz zasób i wyszukaj "Aktualizacja urządzenia dla IoT Hub"

   

2. Wybierz Utwórz>Aktualizacja urządzenia dla IoT Hub

3. Na karcie Podstawowe podaj następujące informacje dotyczące konta usługi Device Update:

   • Subskrypcja: subskrypcja platformy Azure, która ma być skojarzona z kontem usługi Device Update.
   • Grupa zasobów: istniejąca lub nowa grupa zasobów.
   • Nazwa: nazwa konta.
   • Lokalizacja: region świadczenia usługi Azure, w którym będzie znajdować się Twoje konto. Aby uzyskać informacje o regionach obsługujących usługę Device Update dla usługi IoT Hub, zobacz stronę Produkty platformy Azure według regionów.

   Uwaga / Notatka

   Konto usługi Device Update nie musi być w tym samym regionie co centra IoT, ale dla lepszej wydajności zaleca się, aby znajdowały się blisko siebie geograficznie.

   

4. Opcjonalnie możesz zaznaczyć to pole wyboru, aby przypisać rolę administratora usługi Device Update do siebie. Możesz również użyć kroków wymienionych w sekcji Konfigurowanie ról kontroli dostępu , aby zapewnić kombinację ról dla użytkowników i aplikacji dla odpowiedniego poziomu dostępu.

   Aby zarządzać rolami, musisz mieć uprawnienia właściciela lub administratora dostępu użytkowników w subskrypcji.

5. Wybierz Dalej: Wystąpienie

   Wystąpienie usługi Device Update jest skojarzone z jednym centrum IoT. Wybierz centrum IoT, które będzie używane z aktualizacją urządzenia. Po połączeniu centrum IoT Hub z wystąpieniem usługi Device Update, nowa polisa dostępu współużytkowanego jest tworzona automatycznie, aby przyznać uprawnienia usłudze Device Update do pracy z IoT Hub (zapisywanie w rejestrze i łączenie z usługą). Te zasady zapewniają, że dostęp jest ograniczony tylko do aktualizacji urządzenia.

6. Na karcie Instancja podaj następujące informacje dla instancji Device Update:

   • Nazwa: nazwa dla Twojego wystąpienia.
   • Szczegóły IoT Hub: Wybierz IoT Hub, aby połączyć z tą instancją.

   

7. Wybierz opcję Dalej: przejrzyj + utwórz. Po weryfikacji wybierz pozycję Utwórz.

   

8. Zobaczysz, że wdrożenie jest w toku. Stan wdrożenia zmieni się na "ukończony" w ciągu kilku minut. Gdy tak, wybierz pozycję Przejdź do zasobu

   

Użyj polecenia az iot device-update account create , aby utworzyć nowe konto usługi Device Update.

Zamień następujące elementy zastępcze na własne informacje:

• < >resource_group: istniejąca grupa zasobów w subskrypcji.

• < >account_name: nazwa konta usługi Device Update.

• <region>: region świadczenia usługi Azure, w którym będzie znajdować się Twoje konto. Aby uzyskać informacje o regionach obsługujących usługę Device Update dla usługi IoT Hub, zobacz stronę Produkty platformy Azure według regionów. Jeśli nie podano żadnego regionu, zostanie użyta lokalizacja grupy zasobów.

  Uwaga / Notatka

  Konto usługi Device Update nie musi znajdować się w tym samym regionie co centra IoT, ale dla lepszej wydajności zaleca się utrzymanie ich w bliskiej odległości geograficznej.

az iot device-update account create --resource-group <resource_group> --account <account_name> --location <region>

Użyj polecenia az iot device-update instance create, aby utworzyć instancję Device Update.

Wystąpienie usługi Device Update jest skojarzone z jednym centrum IoT. Wybierz centrum IoT, które będzie używane z aktualizacją urządzenia. Po połączeniu IoT Hub z wystąpieniem usługi Device Update, nowa zasada dostępu współużytkowanego jest tworzona automatycznie, aby nadać usłudze Device Update uprawnienia do pracy z IoT Hub (zapis w rejestrze i połączenie z usługą). Te zasady zapewniają, że dostęp jest ograniczony tylko do aktualizacji urządzenia.

Zamień następujące elementy zastępcze na własne informacje:

• < >account_name: nazwa konta usługi Device Update, z którymi będzie skojarzone to wystąpienie.
• < >instance_name: nazwa tego wystąpienia.
• < >iothub_id: identyfikator zasobu centrum IoT, który zostanie połączony z tym wystąpieniem. Identyfikator zasobu usługi IoT Hub można pobrać przy użyciu polecenia az iot hub show i wykonywania zapytań dotyczących wartości identyfikatora: az iot hub show -n <iothub_name> --query id.

az iot device-update instance create --account <account_name> --instance <instance_name> --iothub-ids <iothub_id>

1. Na koncie usługi Device Update wybierz pozycję Kontrola dostępu (Zarządzanie dostępem i tożsamościami) z menu nawigacji.

   

2. Wybierz pozycję , a następnie dodaj przypisania ról.

3. Na karcie Rola wybierz rolę Aktualizacja urządzenia z dostępnych opcji:

   • Administrator aktualizacji urządzeń
   • Czytnik aktualizacji urządzenia
   • Administrator zawartości aktualizacji urządzenia
   • Czytnik treści związanych z aktualizacjami urządzenia
   • Administrator wdrożeń aktualizacji urządzeń
   • Odczyt wdrożeń aktualizacji dla urządzeń

   Aby uzyskać więcej informacji, dowiedz się więcej o kontroli dostępu opartej na rolach w usłudze Device Update dla usługi IoT Hub.

   

4. Wybierz Dalej

5. Na karcie Członkowie wybierz użytkowników lub grupy, do których chcesz przypisać rolę.

   

6. Wybierz Przejrzyj i przypisz

7. Przejrzyj nowe przypisania ról i ponownie wybierz pozycję Przejrzyj i przypisz ponownie

8. Teraz możesz korzystać z usługi Device Update z poziomu usługi IoT Hub

Do przypisywania dostępu do usługi Device Update są dostępne następujące role:

• Administrator aktualizacji urządzeń
• Czytnik aktualizacji urządzenia
• Administrator zawartości aktualizacji urządzenia
• Czytnik treści związanych z aktualizacjami urządzenia
• Administrator wdrożeń aktualizacji urządzeń
• Odczyt wdrożeń aktualizacji dla urządzeń

Aby uzyskać więcej informacji, dowiedz się więcej o kontroli dostępu opartej na rolach w usłudze Device Update dla usługi IoT Hub.

Użyj polecenia az role assignment create, aby skonfigurować kontrolę dostępu dla konta usługi Device Update.

Zamień następujące elementy zastępcze na własne informacje:

• <rola>: rola aktualizacji urządzenia, którą przypisujesz.
• < >user_group: użytkownik lub grupa, do której chcesz przypisać rolę.
• < >account_id: identyfikator zasobu konta usługi Device Update, do którego użytkownik lub grupa uzyska dostęp. Identyfikator zasobu można pobrać przy użyciu polecenia az iot device-update account show i wykonywania zapytań o wartość identyfikatora: az iot device-update account show -n <account_name> --query id.

az role assignment create --role '<role>' --assignee <user_group> --scope <account_id>

1. W witrynie Azure przejdź do centra IoT połączonego z instancją Device Update.
2. Wybierz Kontrola dostępu (IAM) z menu nawigacji.
3. Wybierz pozycję Dodaj>Dodaj przypisanie roli.
4. Na karcie Rola wybierz pozycję Współautor danych usługi IoT Hub. Wybierz Dalej.
5. Dla Przydziel dostęp do wybierz Użytkownik, grupa lub usługa główna.
6. Wybierz Wybierz członków i wyszukaj "Azure Device Update"
7. Wybierz Dalej>Przejrzyj + Przypisz

Aby sprawdzić, czy uprawnienia zostały ustawione poprawnie:

1. W portalu Azure przejdź do centrum IoT połączonego z wystąpieniem usługi Device Update.
2. Wybierz Kontrola dostępu (IAM) z menu nawigacji.
3. Wybierz pozycję Sprawdź dostęp.
4. Wybierz użytkownika, grupę lub jednostkę usługi i wyszukaj 'Azure Device Update'
5. Po kliknięciu pozycji Azure Device Update sprawdź, czy rola Współautor danych usługi IoT Hub jest wyświetlana w obszarze Przypisania ról

Użyj polecenia az role assignment create, aby utworzyć przypisanie roli dla głównego użytkownika usługi Azure Device Update.

Zastąp <resource_id> identyfikatorem zasobu centrum IoT. Identyfikator zasobu można pobrać przy użyciu polecenia az iot hub show i wykonywania zapytań o wartość identyfikatora: az iot hub show -n <hub_name> --query id.

az role assignment create --role "IoT Hub Data Contributor" --assignee https://api.adu.microsoft.com/ --scope <resource_id>

1. Aby wyświetlić wszystkie konta usługi Device Update, użyj witryny Azure Portal, aby wyszukać usługę Device Update dla usługi IoT Hubs .

   • Użyj menu rozwijanego Grupowanie , aby grupować konto według subskrypcji, grupy zasobów, lokalizacji i innych warunków.
   • Wybierz pozycję Dodaj filtr , aby filtrować listę kont według grupy zasobów, lokalizacji, tagów i innych warunków.

2. Aby wyświetlić wszystkie wystąpienia na koncie, przejdź do tego konta w witrynie Azure Portal. Wybierz pozycję Wystąpienia w sekcji Zarządzanie wystąpieniami w menu

   • Użyj pola wyszukiwania, aby filtrować wystąpienia.

Aby wyświetlić wszystkie konta usługi Device Update, użyj polecenia az iot device-update account list .

az iot device-update account list 

Aby wyświetlić wszystkie instancje na koncie, użyj polecenia az iot device-update instance list.

az iot device-update instance list --account <account_name>

Oba list polecenia obsługują dodatkowe operacje grupowania i filtrowania. Użyj argumentu --query , aby znaleźć konta lub wystąpienia na podstawie warunków, takich jak tagi. Na przykład --query "[?tags.env == 'test']". Użyj argumentu --output , aby sformatować wyniki. Na przykład --output table.