device-group
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ą).
Tworzy grupy urządzeń i zarządza nimi.
Grupy urządzeń są adresowane według identyfikatora (ID) lub nazwy produktu i pary nazw grup urządzeń.
| Działanie | opis |
|---|---|
| create | Tworzy nową grupę urządzeń. |
| lista | Wyświetl listę wszystkich grup urządzeń w dzierżawie usługi Azure Sphere. |
| usuwanie | Usuwa istniejącą grupę urządzeń. |
| Wdrażania | Zarządza wdrożeniami w grupie urządzeń. |
| urządzenie | Wyświetla listę urządzeń w grupie urządzeń. |
| pokazać | Wyświetla informacje o grupie urządzeń. |
| update | Modyfikuje istniejącą grupę urządzeń. |
create
Tworzy grupę urządzeń o określonej nazwie określonego produktu. Grupa urządzeń organizuje urządzenia, które mają ten sam produkt i otrzymują te same aplikacje z chmury.
Parametry wymagane
| Parametr | Type | opis |
|---|---|---|
| -p, --product | Identyfikator GUID lub nazwa | Określa produkt do dodania tej grupy urządzeń. Możesz określić identyfikator lub nazwę produktu Azure Sphere. |
| -n, --name | String | Określa nazwę grupy urządzeń. Nazwa może zawierać tylko znaki alfanumeryczne. Jeśli nazwa zawiera spacje, należy ująć ją w cudzysłów. Nazwa grupy urządzeń nie może przekraczać 50 znaków, jest bez uwzględniania wielkości liter, musi być unikatowa w obrębie produktu. |
Parametry opcjonalne
| Parametr | Type | opis |
|---|---|---|
| -a, --application-update | Wyliczenie | Określa zasady aktualizacji aplikacji, które mają być stosowane dla tej grupy urządzeń. Zaakceptowane wartości: No3rdPartyAppUpdates, UpdateAlli NoUpdates. Wartość domyślna to UpdateAll. Zasady NoUpdates są obecnie zarezerwowane tylko do użytku wewnętrznego. |
| -f, --os-feed | Wyliczenie | Określa typ kanału informacyjnego systemu operacyjnego do użycia dla aktualizacji systemu operacyjnego. Zaakceptowane wartości: Retail, RetailEval. |
| -t, --tenant | Identyfikator GUID lub nazwa | Określa dzierżawę do wykonania tej operacji w. Zastępuje wybraną dzierżawę domyślną. Możesz określić identyfikator dzierżawy lub nazwę dzierżawy. |
| -d, --description | String | Określa opcjonalny tekst opisujący grupę urządzeń. Maksymalna długość to 100 znaków. Jeśli opis zawiera spacje, należy go ująć w cudzysłów. |
| -r, --regional-data-boundary | String | Regionalna granica danych dla tego obrazu. Dozwolone wartości: EU, None. Domyślna wartość to None. Jeśli żadna wartość nie zostanie określona, zostanie użyta wartość domyślna. Aby uzyskać więcej informacji, zobacz Konfigurowanie zrzutów awaryjnych — zagadnienia dotyczące pivacy |
Parametry globalne
Następujące parametry globalne są dostępne dla interfejsu wiersza polecenia usługi Azure Sphere:
| Parametr | opis |
|---|---|
| --debugować | Zwiększa szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania. Jeśli znajdziesz usterkę, podaj dane wyjściowe wygenerowane z flagą --debug podczas przesyłania raportu o usterce. |
| -h, --help | Drukuje informacje referencyjne dotyczące poleceń oraz ich argumentów i list dostępnych podgrup i poleceń. |
| --only-show-errors | Pokazuje tylko błędy, pomijając ostrzeżenia. |
| -o, --output | Zmienia format danych wyjściowych. Dostępne formaty danych wyjściowych to json, jsonc (kolorowy kod JSON), tsv (wartości rozdzielane tabulatorami), tabela (tabele ASCII czytelne dla człowieka) i yaml. Domyślnie interfejs wiersza polecenia zwraca format table. Aby dowiedzieć się więcej o dostępnych formatach danych wyjściowych, zobacz Format danych wyjściowych dla poleceń interfejsu wiersza polecenia usługi Azure Sphere. |
| --zapytanie | Używa języka zapytań JMESPath do filtrowania danych wyjściowych zwróconych z usług zabezpieczeń Azure Sphere. Aby uzyskać więcej informacji i przykładów, zobacz Samouczek JMESPath i Wykonywanie zapytań o dane wyjściowe polecenia interfejsu wiersza polecenia platformy Azure. |
| --gadatliwy | Drukuje informacje o zasobach utworzonych w usłudze Azure Sphere podczas operacji i innych przydatnych informacji. Użyj parametru --debug, aby uzyskać pełne dzienniki debugowania. |
Przykład
azsphere device-group create --name Marketing --product DW100
------------------------------------ ------------------------------------ ---------- ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- ---------------------
Id TenantId OsFeedType ProductId Name UpdatePolicy AllowCrashDumpsCollection RegionalDataBoundary
===================================================================================================================================================================================================================================================
7f860cc1-4949-4000-a541-9a988ba4c3cd 143adbc9-1bf0-4be2-84a2-084a331d81cb Retail 6f52bead-700d-4289-bdc2-2f11f774270e Marketing Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------------------ ---------- ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------
lista
Wyświetl listę wszystkich grup urządzeń w dzierżawie usługi Azure Sphere.
Parametry opcjonalne
| Parametr | Type | opis |
|---|---|---|
| -t, --tenant | Identyfikator GUID lub nazwa | Określa dzierżawę do wykonania tej operacji w. Zastępuje wybraną dzierżawę domyślną. Możesz określić identyfikator dzierżawy lub nazwę dzierżawy. |
Parametry globalne
Następujące parametry globalne są dostępne dla interfejsu wiersza polecenia usługi Azure Sphere:
| Parametr | opis |
|---|---|
| --debugować | Zwiększa szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania. Jeśli znajdziesz usterkę, podaj dane wyjściowe wygenerowane z flagą --debug podczas przesyłania raportu o usterce. |
| -h, --help | Drukuje informacje referencyjne dotyczące poleceń oraz ich argumentów i list dostępnych podgrup i poleceń. |
| --only-show-errors | Pokazuje tylko błędy, pomijając ostrzeżenia. |
| -o, --output | Zmienia format danych wyjściowych. Dostępne formaty danych wyjściowych to json, jsonc (kolorowy kod JSON), tsv (wartości rozdzielane tabulatorami), tabela (tabele ASCII czytelne dla człowieka) i yaml. Domyślnie interfejs wiersza polecenia zwraca format table. Aby dowiedzieć się więcej o dostępnych formatach danych wyjściowych, zobacz Format danych wyjściowych dla poleceń interfejsu wiersza polecenia usługi Azure Sphere. |
| --zapytanie | Używa języka zapytań JMESPath do filtrowania danych wyjściowych zwróconych z usług zabezpieczeń Azure Sphere. Aby uzyskać więcej informacji i przykładów, zobacz Samouczek JMESPath i Wykonywanie zapytań o dane wyjściowe polecenia interfejsu wiersza polecenia platformy Azure. |
| --gadatliwy | Drukuje informacje o zasobach utworzonych w usłudze Azure Sphere podczas operacji i innych przydatnych informacji. Użyj parametru --debug, aby uzyskać pełne dzienniki debugowania. |
Przykład
azsphere device-group list --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- ---------------------
Id Name Description ProductId OsFeedType UpdatePolicy AllowCrashDumpsCollection RegionalDataBoundary
=====================================================================================================================================================================================================================================================================================
a3a49688-4601-4422-8b51-a0838ea84627 Development Default development device group 6f52bead-700d-4289-bdc2-2f11f774270e Retail Accept only system software updates. Don't accept application updates. False None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
7cb46b96-8c17-4afd-bd3f-614acad9d264 Field Test Default test device group 6f52bead-700d-4289-bdc2-2f11f774270e Retail Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
30c39bae-f525-4094-8008-d03705429ef0 Production Default production device group 6f52bead-700d-4289-bdc2-2f11f774270e Retail Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
cb5c9685-5dbe-470c-91a9-91dc129884d6 Production OS Evaluation Default Production OS Evaluation device group 6f52bead-700d-4289-bdc2-2f11f774270e RetailEval Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
63e72035-3fcf-4fdc-b88a-05e30d1ba224 Field Test OS Evaluation Default Field Test OS Evaluation device group 6f52bead-700d-4289-bdc2-2f11f774270e RetailEval Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- --------------------------------------------------
delete
Usuwa określoną grupę urządzeń w dzierżawie usługi Azure Sphere.
Grupę urządzeń można usunąć tylko wtedy, gdy:
- Użytkownik ma uprawnienia administratora do dzierżawy.
- Grupa urządzeń jest pusta i nie ma w niej żadnych urządzeń. Polecenie azsphere device-group device list wyświetla listę wszystkich urządzeń w grupie urządzeń. Uruchom polecenie azsphere device update --device-group , aby przenieść urządzenie do innej grupy urządzeń.
Parametry wymagane
| Parametr | Type | opis |
|---|---|---|
| -g, --device-group | String | Określa grupę urządzeń do usunięcia. Możesz określić identyfikator grupy urządzeń lub nazwę grupy urządzeń. Aby użyć nazwy grupy urządzeń, należy podać zarówno nazwę produktu, jak i nazwę grupy urządzeń w <product-name/device-group-name> formacie. |
Parametry opcjonalne
| Parametr | Type | opis |
|---|---|---|
| -t, --tenant | Identyfikator GUID lub nazwa | Określa dzierżawę do wykonania tej operacji w. Zastępuje wybraną dzierżawę domyślną. Możesz określić identyfikator dzierżawy lub nazwę dzierżawy. |
Parametry globalne
Następujące parametry globalne są dostępne dla interfejsu wiersza polecenia usługi Azure Sphere:
| Parametr | opis |
|---|---|
| --debugować | Zwiększa szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania. Jeśli znajdziesz usterkę, podaj dane wyjściowe wygenerowane z flagą --debug podczas przesyłania raportu o usterce. |
| -h, --help | Drukuje informacje referencyjne dotyczące poleceń oraz ich argumentów i list dostępnych podgrup i poleceń. |
| --only-show-errors | Pokazuje tylko błędy, pomijając ostrzeżenia. |
| -o, --output | Zmienia format danych wyjściowych. Dostępne formaty danych wyjściowych to json, jsonc (kolorowy kod JSON), tsv (wartości rozdzielane tabulatorami), tabela (tabele ASCII czytelne dla człowieka) i yaml. Domyślnie interfejs wiersza polecenia zwraca format table. Aby dowiedzieć się więcej o dostępnych formatach danych wyjściowych, zobacz Format danych wyjściowych dla poleceń interfejsu wiersza polecenia usługi Azure Sphere. |
| --zapytanie | Używa języka zapytań JMESPath do filtrowania danych wyjściowych zwróconych z usług zabezpieczeń Azure Sphere. Aby uzyskać więcej informacji i przykładów, zobacz Samouczek JMESPath i Wykonywanie zapytań o dane wyjściowe polecenia interfejsu wiersza polecenia platformy Azure. |
| --gadatliwy | Drukuje informacje o zasobach utworzonych w usłudze Azure Sphere podczas operacji i innych przydatnych informacji. Użyj parametru --debug, aby uzyskać pełne dzienniki debugowania. |
Przykład
azsphere device-group delete --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Successfully deleted the device group
azsphere device-group delete --device-group DW100/Development
Successfully deleted the device group
wdrożenie
Zarządza wdrożeniami dla grupy urządzeń.
| Działanie | opis |
|---|---|
| create | Tworzy nowe wdrożenie dla określonej grupy urządzeń. |
| lista | Wyświetla wdrożenia grupy urządzeń. |
tworzenie wdrożenia
Tworzy nowe wdrożenie dla grupy urządzeń z dostarczonymi obrazami.
Grupę urządzeń można zidentyfikować według identyfikatora (identyfikatora) lub pary nazw produktów i grupy urządzeń.
Parametry wymagane
| Parametr | Type | opis |
|---|---|---|
| -g, --device-group | String | Określa grupę urządzeń, w której ma zostać utworzone wdrożenie. Możesz określić identyfikator grupy urządzeń lub nazwę grupy urządzeń. Aby użyć nazwy grupy urządzeń, należy podać zarówno nazwę produktu, jak i nazwę grupy urządzeń w <product-name/device-group-name> formacie. |
| -i, --images | String | Określa identyfikatory obrazów dla co najmniej jednego obrazu do uwzględnienia we wdrożeniu. Można dodać wiele obrazów, dodając dodatkowe parametry lub wiele identyfikatorów obrazów można połączyć w jednym parametrze na liście rozdzielanej spacjami. Uruchom polecenie azsphere image add, aby uzyskać identyfikator obrazu. |
Parametry opcjonalne
| Parametr | Type | opis |
|---|---|---|
| -t, --tenant | Identyfikator GUID lub nazwa | Określa dzierżawę do wykonania tej operacji w. Zastępuje wybraną dzierżawę domyślną. Możesz określić identyfikator dzierżawy lub nazwę dzierżawy. |
Parametry globalne
Następujące parametry globalne są dostępne dla interfejsu wiersza polecenia usługi Azure Sphere:
| Parametr | opis |
|---|---|
| --debugować | Zwiększa szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania. Jeśli znajdziesz usterkę, podaj dane wyjściowe wygenerowane z flagą --debug podczas przesyłania raportu o usterce. |
| -h, --help | Drukuje informacje referencyjne dotyczące poleceń oraz ich argumentów i list dostępnych podgrup i poleceń. |
| --only-show-errors | Pokazuje tylko błędy, pomijając ostrzeżenia. |
| -o, --output | Zmienia format danych wyjściowych. Dostępne formaty danych wyjściowych to json, jsonc (kolorowy kod JSON), tsv (wartości rozdzielane tabulatorami), tabela (tabele ASCII czytelne dla człowieka) i yaml. Domyślnie interfejs wiersza polecenia zwraca format table. Aby dowiedzieć się więcej o dostępnych formatach danych wyjściowych, zobacz Format danych wyjściowych dla poleceń interfejsu wiersza polecenia usługi Azure Sphere. |
| --zapytanie | Używa języka zapytań JMESPath do filtrowania danych wyjściowych zwróconych z usług zabezpieczeń Azure Sphere. Aby uzyskać więcej informacji i przykładów, zobacz Samouczek JMESPath i Wykonywanie zapytań o dane wyjściowe polecenia interfejsu wiersza polecenia platformy Azure. |
| --gadatliwy | Drukuje informacje o zasobach utworzonych w usłudze Azure Sphere podczas operacji i innych przydatnych informacji. Użyj parametru --debug, aby uzyskać pełne dzienniki debugowania. |
Przykład
Parametr --device-group identyfikuje grupę urządzeń. Identyfikator grupy urządzeń dostarcza identyfikator GUID, który jednoznacznie identyfikuje grupę urządzeń we wszystkich produktach. Alternatywnie można użyć pary nazwy produktu i nazwy grupy urządzeń w <formacie product-name/>device-group-name<>. Ta para nazw jednoznacznie identyfikuje grupę urządzeń dla określonego produktu.
Przykład określania grupy urządzeń według identyfikatora:
azsphere device-group deployment create --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd --images 5572509b-43a4-45b0-88c5-365cbf9732c1
Przykład określania grupy urządzeń według nazwy:
azsphere device-group deployment create --device-group DW100/Development --images 5572509b-43a4-45b0-88c5-365cbf9732c1
Przykład określania wielu identyfikatorów obrazów przez podanie listy wartości rozdzielonych spacjami:
azsphere device-group deployment create --device-group DW100/Development --images 5572509b-43a4-45b0-88c5-365cbf9732c1 3bbd2d2a-2870-4dde-9db8-ae50548ea7b4
Powinny pojawić się następujące dane wyjściowe:
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
Id TenantId DeployedImages DeploymentDateUtc
===================================================================================================================================================
7f860cc1-4949-4000-a541-9a988ba4c3cd 143adbc9-1bf0-4be2-84a2-084a331d81cb 5572509b-43a4-45b0-88c5-365cbf9732c1 2021-04-01T18:48:41.721662+00:00
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
lista wdrożeń
Przedstawia historię wdrażania grupy urządzeń. Zwraca identyfikator wdrożenia, znacznik czasu i listę dołączonych obrazów. Lista jest uporządkowana według najnowszych wdrożeń.
Parametry wymagane
| Parametr | Type | opis |
|---|---|---|
| -g, --device-group | String | Określa grupę urządzeń, dla której ma być wyświetlana lista historii wdrożenia. Możesz określić identyfikator grupy urządzeń lub nazwę grupy urządzeń. Aby użyć nazwy grupy urządzeń, należy podać zarówno nazwę produktu, jak i nazwę grupy urządzeń w <product-name/device-group-name> formacie. |
Parametry opcjonalne
| Parametr | Type | opis |
|---|---|---|
| -t, --tenant | Identyfikator GUID lub nazwa | Określa dzierżawę do wykonania tej operacji w. Zastępuje wybraną dzierżawę domyślną. Możesz określić identyfikator dzierżawy lub nazwę dzierżawy. |
Parametry globalne
Następujące parametry globalne są dostępne dla interfejsu wiersza polecenia usługi Azure Sphere:
| Parametr | opis |
|---|---|
| --debugować | Zwiększa szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania. Jeśli znajdziesz usterkę, podaj dane wyjściowe wygenerowane z flagą --debug podczas przesyłania raportu o usterce. |
| -h, --help | Drukuje informacje referencyjne dotyczące poleceń oraz ich argumentów i list dostępnych podgrup i poleceń. |
| --only-show-errors | Pokazuje tylko błędy, pomijając ostrzeżenia. |
| -o, --output | Zmienia format danych wyjściowych. Dostępne formaty danych wyjściowych to json, jsonc (kolorowy kod JSON), tsv (wartości rozdzielane tabulatorami), tabela (tabele ASCII czytelne dla człowieka) i yaml. Domyślnie interfejs wiersza polecenia zwraca format table. Aby dowiedzieć się więcej o dostępnych formatach danych wyjściowych, zobacz Format danych wyjściowych dla poleceń interfejsu wiersza polecenia usługi Azure Sphere. |
| --zapytanie | Używa języka zapytań JMESPath do filtrowania danych wyjściowych zwróconych z usług zabezpieczeń Azure Sphere. Aby uzyskać więcej informacji i przykładów, zobacz Samouczek JMESPath i Wykonywanie zapytań o dane wyjściowe polecenia interfejsu wiersza polecenia platformy Azure. |
| --gadatliwy | Drukuje informacje o zasobach utworzonych w usłudze Azure Sphere podczas operacji i innych przydatnych informacji. Użyj parametru --debug, aby uzyskać pełne dzienniki debugowania. |
Przykład
Przykład określania grupy urządzeń według identyfikatora:
azsphere device-group deployment list --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Przykład określania grupy urządzeń według nazwy:
azsphere device-group deployment list --device-group DW100/Development
Powinny pojawić się następujące dane wyjściowe:
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
Id TenantId DeployedImages DeploymentDateUtc
===================================================================================================================================================
7f860cc1-4949-4000-a541-9a988ba4c3cd 143adbc9-1bf0-4be2-84a2-084a331d81cb e3769536-dc4b-48d9-afd4-22ed321ba4bc 2020-11-18T19:46:50.514429+00:00
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
device
Zarządza urządzeniami dla grupy urządzeń.
| Działanie | opis |
|---|---|
| lista | Wyświetla urządzenia w grupie urządzeń. |
| show-count | Przedstawia liczbę urządzeń w grupie urządzeń. |
lista urządzeń
Wyświetla urządzenia w grupie urządzeń.
Parametry wymagane
| Parametr | Type | opis |
|---|---|---|
| -g, --device-group | String | Określa grupę urządzeń, dla której ma być wyświetlana lista urządzeń. Możesz określić identyfikator grupy urządzeń lub nazwę grupy urządzeń. Aby użyć nazwy grupy urządzeń, należy podać zarówno nazwę produktu, jak i nazwę grupy urządzeń w <product-name/device-group-name> formacie. |
Parametry opcjonalne
| Parametr | Type | opis |
|---|---|---|
| -t, --tenant | Identyfikator GUID lub nazwa | Określa dzierżawę do wykonania tej operacji w. Zastępuje wybraną dzierżawę domyślną. Możesz określić identyfikator dzierżawy lub nazwę dzierżawy. |
Parametry globalne
Następujące parametry globalne są dostępne dla interfejsu wiersza polecenia usługi Azure Sphere:
| Parametr | opis |
|---|---|
| --debugować | Zwiększa szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania. Jeśli znajdziesz usterkę, podaj dane wyjściowe wygenerowane z flagą --debug podczas przesyłania raportu o usterce. |
| -h, --help | Drukuje informacje referencyjne dotyczące poleceń oraz ich argumentów i list dostępnych podgrup i poleceń. |
| --only-show-errors | Pokazuje tylko błędy, pomijając ostrzeżenia. |
| -o, --output | Zmienia format danych wyjściowych. Dostępne formaty danych wyjściowych to json, jsonc (kolorowy kod JSON), tsv (wartości rozdzielane tabulatorami), tabela (tabele ASCII czytelne dla człowieka) i yaml. Domyślnie interfejs wiersza polecenia zwraca format table. Aby dowiedzieć się więcej o dostępnych formatach danych wyjściowych, zobacz Format danych wyjściowych dla poleceń interfejsu wiersza polecenia usługi Azure Sphere. |
| --zapytanie | Używa języka zapytań JMESPath do filtrowania danych wyjściowych zwróconych z usług zabezpieczeń Azure Sphere. Aby uzyskać więcej informacji i przykładów, zobacz Samouczek JMESPath i Wykonywanie zapytań o dane wyjściowe polecenia interfejsu wiersza polecenia platformy Azure. |
| --gadatliwy | Drukuje informacje o zasobach utworzonych w usłudze Azure Sphere podczas operacji i innych przydatnych informacji. Użyj parametru --debug, aby uzyskać pełne dzienniki debugowania. |
Przykład
Przykład określania grupy urządzeń według identyfikatora:
azsphere device-group device list --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Przykład określania grupy urządzeń według nazwy:
azsphere device-group device list --device-group DW100/Marketing
Powinny pojawić się następujące dane wyjściowe:
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ ------------------------------------ ----------------------------------------
DeviceId TenantId ProductId DeviceGroupId
===================================================================================================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 143adbc9-1bf0-4be2-84a2-084a331d81cb 6f52bead-700d-4289-bdc2-2f11f774270e 7f860cc1-4949-4000-a541-9a988ba4c3cd
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ ------------------------------------ ----------------------------------------
device show-count
Wyświetla liczbę urządzeń w grupie urządzeń.
Parametry wymagane
| Parametr | Type | opis |
|---|---|---|
| -g, --device-group | String | Określa grupę urządzeń, dla której ma być wyświetlana liczba urządzeń. Możesz określić identyfikator grupy urządzeń lub nazwę grupy urządzeń. Aby użyć nazwy grupy urządzeń, należy podać zarówno nazwę produktu, jak i nazwę grupy urządzeń w <product-name/device-group-name> formacie. |
Parametry opcjonalne
| Parametr | Type | opis |
|---|---|---|
| -t, --tenant | Identyfikator GUID lub nazwa | Określa dzierżawę do wykonania tej operacji w. Zastępuje wybraną dzierżawę domyślną. Możesz określić identyfikator dzierżawy lub nazwę dzierżawy. |
Parametry globalne
Następujące parametry globalne są dostępne dla interfejsu wiersza polecenia usługi Azure Sphere:
| Parametr | opis |
|---|---|
| --debugować | Zwiększa szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania. Jeśli znajdziesz usterkę, podaj dane wyjściowe wygenerowane z flagą --debug podczas przesyłania raportu o usterce. |
| -h, --help | Drukuje informacje referencyjne dotyczące poleceń oraz ich argumentów i list dostępnych podgrup i poleceń. |
| --only-show-errors | Pokazuje tylko błędy, pomijając ostrzeżenia. |
| -o, --output | Zmienia format danych wyjściowych. Dostępne formaty danych wyjściowych to json, jsonc (kolorowy kod JSON), tsv (wartości rozdzielane tabulatorami), tabela (tabele ASCII czytelne dla człowieka) i yaml. Domyślnie interfejs wiersza polecenia zwraca format table. Aby dowiedzieć się więcej o dostępnych formatach danych wyjściowych, zobacz Format danych wyjściowych dla poleceń interfejsu wiersza polecenia usługi Azure Sphere. |
| --zapytanie | Używa języka zapytań JMESPath do filtrowania danych wyjściowych zwróconych z usług zabezpieczeń Azure Sphere. Aby uzyskać więcej informacji i przykładów, zobacz Samouczek JMESPath i Wykonywanie zapytań o dane wyjściowe polecenia interfejsu wiersza polecenia platformy Azure. |
| --gadatliwy | Drukuje informacje o zasobach utworzonych w usłudze Azure Sphere podczas operacji i innych przydatnych informacji. Użyj parametru --debug, aby uzyskać pełne dzienniki debugowania. |
Przykład
Przykład określania grupy urządzeń według identyfikatora:
azsphere device-group device show-count --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Przykład określania grupy urządzeń według nazwy:
azsphere device-group device show-count --device-group DW100/Marketing
Powinny pojawić się następujące dane wyjściowe:
------
Result
======
1
------
pokaż
Zwraca informacje o grupie urządzeń.
Parametry wymagane
| Parametr | Type | opis |
|---|---|---|
| -g, --device-group | String | Określa grupę urządzeń, dla której mają być wyświetlane szczegóły. Możesz określić identyfikator grupy urządzeń lub nazwę grupy urządzeń. Aby użyć nazwy grupy urządzeń, należy podać zarówno nazwę produktu, jak i nazwę grupy urządzeń w <product-name/device-group-name> formacie. |
Parametry opcjonalne
| Parametr | Type | opis |
|---|---|---|
| -t, --tenant | Identyfikator GUID lub nazwa | Określa dzierżawę do wykonania tej operacji w. Zastępuje wybraną dzierżawę domyślną. Możesz określić identyfikator dzierżawy lub nazwę dzierżawy. |
Parametry globalne
Następujące parametry globalne są dostępne dla interfejsu wiersza polecenia usługi Azure Sphere:
| Parametr | opis |
|---|---|
| --debugować | Zwiększa szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania. Jeśli znajdziesz usterkę, podaj dane wyjściowe wygenerowane z flagą --debug podczas przesyłania raportu o usterce. |
| -h, --help | Drukuje informacje referencyjne dotyczące poleceń oraz ich argumentów i list dostępnych podgrup i poleceń. |
| --only-show-errors | Pokazuje tylko błędy, pomijając ostrzeżenia. |
| -o, --output | Zmienia format danych wyjściowych. Dostępne formaty danych wyjściowych to json, jsonc (kolorowy kod JSON), tsv (wartości rozdzielane tabulatorami), tabela (tabele ASCII czytelne dla człowieka) i yaml. Domyślnie interfejs wiersza polecenia zwraca format table. Aby dowiedzieć się więcej o dostępnych formatach danych wyjściowych, zobacz Format danych wyjściowych dla poleceń interfejsu wiersza polecenia usługi Azure Sphere. |
| --zapytanie | Używa języka zapytań JMESPath do filtrowania danych wyjściowych zwróconych z usług zabezpieczeń Azure Sphere. Aby uzyskać więcej informacji i przykładów, zobacz Samouczek JMESPath i Wykonywanie zapytań o dane wyjściowe polecenia interfejsu wiersza polecenia platformy Azure. |
| --gadatliwy | Drukuje informacje o zasobach utworzonych w usłudze Azure Sphere podczas operacji i innych przydatnych informacji. Użyj parametru --debug, aby uzyskać pełne dzienniki debugowania. |
Przykład
Przykład określania grupy urządzeń według identyfikatora:
azsphere device-group show --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Przykład określania grupy urządzeń według nazwy:
azsphere device-group show --device-group DW100/Marketing
Powinny pojawić się następujące dane wyjściowe:
------------------------------------ --------- ---------------------- ------------------------------------ ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------
Id Name Description TenantId ProductId OsFeedType UpdatePolicy AllowCrashDumpsCollection RegionalDataBoundary
========================================================================================================================================================================================================================================================================
7f860cc1-4949-4000-a541-9a988ba4c3cd Marketing Marketing device group 143adbc9-1bf0-4be2-84a2-084a331d81cb 6f52bead-700d-4289-bdc2-2f11f774270e Retail Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ --------- ---------------------- ------------------------------------ ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------
update
Aktualizuje istniejącą grupę urządzeń zidentyfikowaną według identyfikatora lub nazwy produktu i pary nazw grup urządzeń.
Parametry wymagane
| Parametr | Type | opis |
|---|---|---|
| -g, --device-group | String | Określa grupę urządzeń, dla której mają być aktualizowane szczegóły. Możesz określić identyfikator grupy urządzeń lub nazwę grupy urządzeń. Aby użyć nazwy grupy urządzeń, należy podać zarówno nazwę produktu, jak i nazwę grupy urządzeń w <product-name/device-group-name> formacie. |
Parametry opcjonalne
| Parametr | Type | opis |
|---|---|---|
| -c, --allow-crash-dumps-collection | String | Ustaw zgodę na zbieranie zrzutów awaryjnych przez firmę Microsoft dla grupy urządzeń. Wartość domyślna to Off. Dozwolone wartości: Off i On. Użyj parametru , --regional-data-boundary aby określić miejsce przechowywania plików zrzutu awaryjnego. Aby uzyskać więcej informacji, zobacz Konfigurowanie zrzutów awaryjnych. |
| -a, --application-update | ApplicationUpdatePolicyType | Określa zasady aktualizacji aplikacji dla grupy urządzeń. Dozwolone wartości: No3rdPartyAppUpdates, UpdateAlli NoUpdates. Wartość domyślna to UpdateAll. Zasady NoUpdates są obecnie zarezerwowane tylko do użytku wewnętrznego. |
| -d, --new-description | String | Określa opcjonalny tekst opisujący grupę urządzeń. Maksymalna długość to 100 znaków. |
| -n, --new-name | String | Określa nową nazwę grupy urządzeń. Nazwa może zawierać tylko znaki alfanumeryczne. Jeśli nazwa zawiera spacje, należy ująć ją w cudzysłów. Nazwa grupy urządzeń nie może przekraczać 50 znaków, jest bez uwzględniania wielkości liter i musi być unikatowa w produkcie. |
| -f, --os-feed | String | Określa źródło danych systemu operacyjnego dla grupy urządzeń. Możliwe wartości to Retail i RetailEval. |
| -t, --tenant | Identyfikator GUID lub nazwa | Określa dzierżawę do wykonania tej operacji w. Zastępuje wybraną dzierżawę domyślną. Możesz określić identyfikator dzierżawy lub nazwę dzierżawy. |
| -r, --regional-data-boundary | String | Regionalna granica danych dla tego obrazu. Dozwolone wartości: EU, None. Domyślna wartość to None. Jeśli żadna wartość nie zostanie określona, zostanie użyta wartość domyślna. Aby uzyskać więcej informacji, zobacz Konfigurowanie zrzutów awaryjnych — zagadnienia dotyczące pivacy |
Parametry globalne
Następujące parametry globalne są dostępne dla interfejsu wiersza polecenia usługi Azure Sphere:
| Parametr | opis |
|---|---|
| --debugować | Zwiększa szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania. Jeśli znajdziesz usterkę, podaj dane wyjściowe wygenerowane z flagą --debug podczas przesyłania raportu o usterce. |
| -h, --help | Drukuje informacje referencyjne dotyczące poleceń oraz ich argumentów i list dostępnych podgrup i poleceń. |
| --only-show-errors | Pokazuje tylko błędy, pomijając ostrzeżenia. |
| -o, --output | Zmienia format danych wyjściowych. Dostępne formaty danych wyjściowych to json, jsonc (kolorowy kod JSON), tsv (wartości rozdzielane tabulatorami), tabela (tabele ASCII czytelne dla człowieka) i yaml. Domyślnie interfejs wiersza polecenia zwraca format table. Aby dowiedzieć się więcej o dostępnych formatach danych wyjściowych, zobacz Format danych wyjściowych dla poleceń interfejsu wiersza polecenia usługi Azure Sphere. |
| --zapytanie | Używa języka zapytań JMESPath do filtrowania danych wyjściowych zwróconych z usług zabezpieczeń Azure Sphere. Aby uzyskać więcej informacji i przykładów, zobacz Samouczek JMESPath i Wykonywanie zapytań o dane wyjściowe polecenia interfejsu wiersza polecenia platformy Azure. |
| --gadatliwy | Drukuje informacje o zasobach utworzonych w usłudze Azure Sphere podczas operacji i innych przydatnych informacji. Użyj parametru --debug, aby uzyskać pełne dzienniki debugowania. |
Przykład
Przykład określania grupy urządzeń według identyfikatora:
azsphere device-group update --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd --new-description "Marketing device group"
Przykład określania grupy urządzeń według nazwy:
azsphere device-group update --device-group DW100/Marketing --new-description "Marketing device group"
Powinny pojawić się następujące dane wyjściowe:
------------------------------------ ------------------------------------ ---------- ------------------------------------ --------- ---------------------- ---------------------------------------------------------- ----------------------------- --------------------
Id TenantId OsFeedType ProductId Name Description UpdatePolicy AllowCrashDumpsCollection RegionalDataBoundary
========================================================================================================================================================================================================================================================================
7f860cc1-4949-4000-a541-9a988ba4c3cd 143adbc9-1bf0-4be2-84a2-084a331d81cb Retail 6f52bead-700d-4289-bdc2-2f11f774270e Marketing Marketing device group Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------------------ ---------- ------------------------------------ --------- ---------------------- ---------------------------------------------------------- ----------------------------- --------------------