Udostępnij za pośrednictwem

Zarządzaj grupami urządzeń

  • Artykuł

Ważne

Jest to dokumentacja usługi Azure Sphere (starsza wersja). Usługa Azure Sphere (starsza wersja) zostanie wycofana 27 września 2027 r., a użytkownicy muszą przeprowadzić migrację do usługi Azure Sphere (zintegrowanej) do tej pory. Użyj selektora wersji znajdującego się powyżej spisu treści, aby wyświetlić dokumentację usługi Azure Sphere (zintegrowaną).

W tym temacie opisano sposób zarządzania grupami urządzeń przy użyciu interfejsu wiersza polecenia lub Eksploratora usługi Azure Sphere. W krokach w tym temacie założono, że znasz pojęcia dotyczące dzierżaw, produktów i grup urządzeń usługi Azure Sphere.

Wyświetlanie listy grup urządzeń

Wyświetl listę wszystkich grup urządzeń w dzierżawie usługi Azure Sphere przy użyciu polecenia azsphere device-group list lub przy użyciu interfejsu API Grupa urządzeń — lista.

Aby wyświetlić listę wszystkich grup urządzeń:

azsphere device-group list

Wyświetl listę grup urządzeń w określonym produkcie przy użyciu polecenia azsphere product device-group list lub przy użyciu interfejsu API Product - List Groups .

azsphere product device-group list --product <product-name>

Napiwek

Aby wyświetlić listę wszystkich produktów w dzierżawie usługi Azure Sphere, uruchom polecenie azsphere product list. Jeśli nie ma żadnych produktów na liście, utwórz produkt.

Aby wyświetlić listę wszystkich urządzeń w dzierżawie usługi Azure Sphere, uruchom polecenie azsphere device list. Dane wyjściowe zawierają produkt i grupę urządzeń, w której istnieje urządzenie.

  1. Otwórz Eksploratora usługi Azure Sphere.

  2. Rozwiń węzeł Dzierżawa dla interesującej Cię dzierżawy.

  1. Otwórz Eksploratora usługi Azure Sphere.

  2. Rozwiń węzeł Dzierżawa dla interesującej Cię dzierżawy.

Aby wyświetlić produkty i grupy urządzeń dzierżawy:

  1. Otwórz Eksploratora usługi Azure Sphere.

  2. Rozwiń węzeł Dzierżawa dla interesującej Cię dzierżawy.

Jeśli nie ma żadnych produktów na liście, utwórz produkt.

Jeśli urządzenie jest już skojarzone z produktem i przypisane do grupy, możesz zaktualizować jego grupę urządzeń w dowolnym momencie.

Aby wyświetlić produkty i grupy urządzeń dzierżawy:

  1. Otwórz Eksploratora usługi Azure Sphere.

  2. Rozwiń węzeł Dzierżawa dla interesującej Cię dzierżawy.

Jeśli nie ma żadnych produktów na liście, utwórz produkt.

Jeśli urządzenie jest już skojarzone z produktem i przypisane do grupy, możesz zaktualizować jego grupę urządzeń w dowolnym momencie.

Tworzenie grupy urządzeń

Utwórz grupę urządzeń przy użyciu polecenia azsphere device-group create lub przy użyciu grupy urządzeń — tworzenie interfejsu API.

Aby utworzyć grupę urządzeń:

azsphere device-group create --product <product-name> --name <device-group-name> --description <device-group-description>

Nazwy grup urządzeń mogą zawierać tylko znaki alfanumeryczne i spacje. Nie mogą przekraczać 50 znaków. Jeśli nazwa lub opis zawiera spacje, należy je ująć w cudzysłów.

Możesz uwzględnić następujące parametry opcjonalne:

  • --os-feed określa typ kanału informacyjnego systemu operacyjnego do użycia w przypadku aktualizacji systemu operacyjnego.
  • --application-update Ustawia zasady aktualizacji aplikacji dla tej grupy urządzeń.

  1. Otwórz Eksploratora usługi Azure Sphere.

  2. W przypadku dzierżawy, którą cię interesuje, rozwiń węzeł Produkt.

  3. W przypadku interesującego Cię produktu kliknij prawym przyciskiem myszy i wybierz pozycję Nowa grupa urządzeń.

  4. Określ nazwę grupy urządzeń i naciśnij Enter. Nazwy grup urządzeń mogą zawierać tylko znaki alfanumeryczne i spacje. Nie mogą przekraczać 50 znaków. Jeśli określisz nieprawidłową nazwę, w oknie Dane wyjściowe zostanie zgłoszony błąd.

Grupę urządzeń można utworzyć w programie Visual Studio Code, ale nie można jej usunąć. Aby usunąć grupę urządzeń, użyj polecenia azsphere device-group delete lub publicznego interfejsu API usługi Azure Sphere.

  1. Otwórz Eksploratora usługi Azure Sphere.

  2. W przypadku dzierżawy, którą cię interesuje, rozwiń węzeł Produkt.

  3. W przypadku interesującego Cię produktu kliknij prawym przyciskiem myszy i wybierz pozycję Nowa grupa urządzeń.

  4. Określ nazwę grupy urządzeń i naciśnij Enter lub kliknij przycisk Zastosuj. Nazwy grup urządzeń mogą zawierać tylko znaki alfanumeryczne i spacje. Nie mogą przekraczać 50 znaków. Jeśli określisz nieprawidłową nazwę, w oknie Dane wyjściowe zostanie zgłoszony błąd.

Grupę urządzeń można utworzyć w programie Visual Studio, ale nie usunąć. Aby usunąć produkty, użyj polecenia azsphere device-group delete lub publicznego interfejsu API usługi Azure Sphere.

Aktualizowanie grupy urządzeń

Nazwę lub opis grupy urządzeń można zmodyfikować przy użyciu polecenia azsphere device-group update lub przy użyciu interfejsu API grupy urządzeń — poprawki.

Aby zaktualizować nazwę i opis grupy urządzeń:

azsphere device-group update --device-group <device group ID or product-name/device-group-name> --new-name <new-device-group-name> --new-description <new-device-group-description>

Parametry i można również zaktualizować os-feed za pomocą application-update.

  1. Otwórz Eksploratora usługi Azure Sphere.

  2. W przypadku dzierżawy, którą cię interesuje, rozwiń węzeł Produkt.

  3. W przypadku interesującego Cię produktu rozwiń węzeł produktu, aby wyświetlić dołączone grupy urządzeń. Możesz zmienić nazwę grupy urządzeń lub zaktualizować jej opis, typ źródła danych systemu operacyjnego lub zasady aktualizacji:

  • Aby zmienić nazwę grupy urządzeń, kliknij prawym przyciskiem myszy nazwę grupy urządzeń i wybierz polecenie Zmień nazwę, wpisz nową nazwę, a następnie naciśnij Enter. Nazwy grup urządzeń mogą zawierać tylko znaki alfanumeryczne i spacje. Nie mogą przekraczać 50 znaków. Jeśli określisz nieprawidłową nazwę, w oknie Dane wyjściowe zostanie zgłoszony błąd.

  • Aby zaktualizować opis grupy urządzeń, kliknij prawym przyciskiem myszy nazwę grupy urządzeń i wybierz pozycję Aktualizuj opis, wpisz nowy opis, a następnie naciśnij Enter.

  • Aby zaktualizować typ źródła danych systemu operacyjnego, rozwiń grupę urządzeń, kliknij prawym przyciskiem myszy typ źródła danych systemu operacyjnego, wybierz pozycję Aktualizuj, a następnie wybierz pozycję Retail lub RetailEval z menu.

  • Aby zmienić zasady aktualizacji, rozwiń grupę urządzeń, kliknij prawym przyciskiem myszy pozycję Zasady aktualizacji, wybierz pozycję Aktualizuj, a następnie wybierz pozycję No3rdPartyAppUpdates lub UpdateAll z menu. (Trzecia opcja, Program NoUpdates jest obecnie zarezerwowany do użytku wewnętrznego. Jeśli wybierzesz tę opcję, w oknie Dane wyjściowe zostanie zgłoszony błąd.

Przenieś urządzenie do innej grupy urządzeń przy użyciu polecenia azsphere device update lub przy użyciu interfejsu API Przenoszenia urządzeń.

  1. Otwórz Eksploratora usługi Azure Sphere.

  2. W przypadku dzierżawy, którą cię interesuje, rozwiń węzeł Produkt.

  3. W przypadku interesującego Cię produktu rozwiń węzeł produktu, aby wyświetlić dołączone grupy urządzeń. Możesz zmienić nazwę grupy urządzeń lub zaktualizować jej opis, typ źródła danych systemu operacyjnego lub zasady aktualizacji:

  • Aby zmienić nazwę grupy urządzeń, wybierz nazwę grupy urządzeń i naciśnij F2 lub kliknij prawym przyciskiem myszy nazwę grupy urządzeń i wybierz polecenie Zmień nazwę, wpisz nową nazwę, a następnie naciśnij Enter lub kliknij przycisk Zastosuj. Nazwy grup urządzeń mogą zawierać tylko znaki alfanumeryczne i spacje. Nie mogą przekraczać 50 znaków. Jeśli określisz nieprawidłową nazwę, w oknie Dane wyjściowe zostanie zgłoszony błąd.

  • Aby zaktualizować opis grupy urządzeń, rozwiń grupę urządzeń, wybierz pozycję Opis i naciśnij F2 lub kliknij prawym przyciskiem myszy pozycję Opis i wybierz polecenie Modyfikuj, wpisz nowy opis, a następnie naciśnij Enter lub kliknij przycisk Zastosuj.

  • Aby zaktualizować typ kanału informacyjnego systemu operacyjnego, rozwiń grupę urządzeń, wybierz typ kanału informacyjnego systemu operacyjnego i naciśnij F2 lub kliknij prawym przyciskiem myszy typ źródła danych systemu operacyjnego, a następnie wybierz polecenie Modyfikuj, wybierz pozycję Retail lub RetailEval z menu, a następnie naciśnij Enter lub kliknij przycisk Zastosuj.

  • Aby zmienić zasady aktualizacji, rozwiń grupę urządzeń, wybierz pozycję Aktualizuj zasady i naciśnij F2 lub kliknij prawym przyciskiem myszy pozycję Aktualizuj zasady, a następnie wybierz polecenie Modyfikuj, wybierz pozycję No3rdPartyAppUpdates lub UpdateAll z menu, a następnie naciśnij Enter lub kliknij przycisk Zastosuj. (Trzecia opcja, Program NoUpdates jest obecnie zarezerwowany do użytku wewnętrznego. Jeśli wybierzesz tę opcję, w oknie Dane wyjściowe zostanie zgłoszony błąd.

Przenieś urządzenie do innej grupy urządzeń przy użyciu polecenia azsphere device update lub przy użyciu interfejsu API Przenoszenia urządzeń.

Przenoszenie urządzenia do innej grupy urządzeń

Przenieś urządzenie do innej grupy urządzeń przy użyciu polecenia azsphere device update lub przy użyciu interfejsu API Przenoszenia urządzeń.

Określ identyfikator grupy urządzeń lub kombinację nazwy produktu i nazwy grupy urządzeń w <formacie product-name>/<device-group-name> :

azsphere device update --device-group <device-group-id>

azsphere device update --device-group <product-name/device-group-name>

Usuwanie grupy urządzeń

Usuń określoną grupę urządzeń w dzierżawie usługi Azure Sphere przy użyciu polecenia azsphere device-group delete lub przy użyciu interfejsu API Usuwanie grupy urządzeń.

Grupę urządzeń można usunąć tylko wtedy, gdy:

Określ identyfikator grupy urządzeń lub kombinację nazwy produktu i nazwy grupy urządzeń w <formacie product-name>/<device-group-name> :

azsphere device-group delete --device-group <device-group-id>

azsphere device-group delete --device-group <product-name/device-group-name>