Dzierżawy
Zarządza dzierżawą usługi Azure Sphere.
Ważne
Polecenia azsphere tenant download-ca-certificate, azsphere tenant download-ca-certificate-chaini azsphere tenant download-validation-certificate są przestarzałe. Użyj , azsphere ca-certificate downloadazsphere ca-certificate download-chain, azsphere ca-certificate download-proof, , a azsphere ca-certificate list zamiast tego.
W interfejsie użytkownika platformy Azure Sphere dzierżawa domyślna nie jest automatycznie wybierana podczas tworzenia dzierżawy. Aby wybrać domyślną dzierżawę dla bieżącego użytkownika na komputerze, musisz uruchomić polecenie wybierz dzierżawę azsphere . Ma to na celu zapewnienie, że dzierżawa domyślna jest prawidłowa do użycia podczas jednorazowej operacji, nie można cofnąć, na przykład żądając urządzenia.
| Operacji | Opis |
|---|---|
| Utworzyć | Tworzy nową dzierżawę. |
| raport o błędach pobierania | Zwraca informacje o błędach dla urządzeń w bieżącej dzierżawie. |
| Listy | Lista dostępnych dzierżaw usługi Azure Sphere. |
| Wybierz | Wybiera domyślną dzierżawę usługi Azure Sphere, która ma być użyta na tym komputerze. |
| pokaż zaznaczone | Przedstawia domyślną dzierżawę usługi Azure Sphere dla tego komputera. |
| Aktualizacji | Aktualizacje szczegóły dzierżawy, takie jak nazwa dzierżawy. |
Utworzyć
Tworzy nową dzierżawę usługi Azure Sphere. Do uruchomienia tego polecenia jest wymagane dołączone urządzenie. Aby uzyskać więcej informacji, zobacz Tworzenie dzierżawy usługi Azure Sphere.
Jeśli masz już dzierżawę i masz pewność, że chcesz mieć inną dzierżawę, użyj parametru --force-additional . Obecnie nie można usunąć dzierżawy usługi Azure Sphere.
Po utworzeniu dzierżawy uruchom dzierżawę azsphere , wybierając domyślną dzierżawę do użycia dla bieżącego użytkownika na tym komputerze. Możesz dodać role dla użytkowników w bieżącej dzierżawie usługi Azure Sphere, używając polecenia Dodaj rolę azsphere .
Polecenie utwórz dzierżawy azsphere współdziała z lokalnie dołączonym urządzeniem Azure Sphere. Jeśli spróbujesz wykonać polecenie bez podłączonego urządzenia, zostanie wyświetlony komunikat o błędzie. Identyfikator urządzenia jest rejestrowany podczas tworzenia dzierżawy i na jednym urządzeniu można utworzyć tylko jedną dzierżawę.
Wymagane parametry
| Parametr | Typu | Opis |
|---|---|---|
| -n, --name | Ciąg | Określa nazwę dzierżawy. Podczas nazywania dzierżawy używaj znaków alfanumerycznych. Znaki specjalne są niedozwolone. Nazwa nie może przekraczać 50 znaków i uwzględnia wielkość liter. |
Parametry opcjonalne
| Parametr | Typu | Opis |
|---|---|---|
| -d, --device | Ciąg | Określa urządzenie, na którym ma zostać uruchomione polecenie, gdy jest podłączonych wiele urządzeń. Ten parametr jest wymagany, gdy jest podłączonych wiele urządzeń. Obecnie podłączone urządzenie jest używane domyślnie. Możesz określić identyfikator urządzenia, adres IP lub identyfikator połączenia lokalnego dołączonego urządzenia. Środowisko Azure Sphere CLI obsługuje wiele urządzeń MT3620 w systemie Windows, ale w systemie Linux można jednocześnie połączyć tylko jedno urządzenie. Z tego powodu ten parametr jest obsługiwany w systemie Windows, ale nie dla systemu Linux. Jeśli użyjesz tego parametru z poleceniem w systemie Linux, zostanie zwrócony błąd. |
| --force-additional | Boolean | Wymusza utworzenie nowej dzierżawy usługi Azure Sphere. Użyj tego polecenia tylko wtedy, gdy masz pewność, że chcesz użyć bieżącego konta do utworzenia nowej dzierżawy usługi Azure Sphere przy użyciu dołączonego urządzenia. |
| --disable-confirm-prompt | Boolean | Wyłącza monit o potwierdzenie użytkownika. |
Parametry globalne
Następujące parametry globalne są dostępne dla środowiska Azure Sphere CLI:
| Parametr | Opis |
|---|---|
| --Debugowania | Zwiększa poziom szczegółowości rejestrowania, aby wyświetlić wszystkie dzienniki debugowania. Jeśli znajdziesz błąd, podaj dane wyjściowe wygenerowane z flagą --debug podczas przesyłania raportu o usterce. |
| -h, --help | Umożliwia drukowanie informacji odwołań do poleceń i ich argumentów oraz list dostępnych podgrup i poleceń. |
| --only-show-errors | Wyświetla tylko błędy, pomijając ostrzeżenia. |
| -o, --output | Zmienia format wyjściowy. Dostępne formaty wyjściowe to json, jsonc (kolorowy JSON), tsv (wartości oddzielone tabulatorami), tabela (czytelne dla człowieka tabele ASCII) i yaml. Domyślnie wynik tableinterfejsu. Aby dowiedzieć się więcej o dostępnych formatach wyjściowych, zobacz Format wyjściowy dla poleceń platformy Azure Sphere CLI. |
| --Kwerendy | Używa języka zapytań JMESPath do filtrowania danych wyjściowych zwróconych przez usługi zabezpieczeń Azure Sphere. Aby uzyskać więcej informacji i przykładów, zobacz Samouczek programu JMESPath i Dane wyjściowe poleceń interfejsu platformy Azure CLI. |
| --Pełne | Drukowanie informacji o zasobach utworzonych w usłudze Azure Sphere podczas operacji i innych przydatnych informacji. Służy --debug do pełnego tworzenia dzienników debugowania. |
Uwaga
Jeśli używasz klasycznej platformy Azure Sphere, zobacz Parametry globalne , aby uzyskać więcej informacji na temat dostępnych opcji.
Przykład
azsphere tenant create --name MyTenant
Użyj parametrów i --disable-confirm-prompt danych--force-additional, jeśli masz pewność, że chcesz użyć tego konta do utworzenia nowej dzierżawy usługi Azure Sphere przy użyciu dołączonego urządzenia. Urządzenia, które zostało wcześniej użyte do utworzenia dzierżawy usługi Azure Sphere, nie może zostać użyte do utworzenia nowej dzierżawy.
azsphere tenant create --name MyTenant --force-additional
You have logged in with the following account:
bob@contoso.com
Do you want to use this account to create a new Azure Sphere tenant using the attached device?
You cannot change the tenant name 'MyTenant1' once it has been created.
Enter 'yes' to continue. Enter anything else to exit.
yes
> verbose: TraceId: c761ba73-761e-4df2-94f5-3f87384d71b7
Created a new Azure Sphere tenant:
--> Tenant Name: MyTenant1
--> Tenant ID: 768c2cd6-059a-49ad-9f53-89f5271cea15
Please use 'azsphere tenant select --tenant MyTenant' to select the created tenant.
Wskazówka
Po utworzeniu dzierżawy upewnij się, że masz uruchomioną dzierżawę azsphere , wybierając domyślną dzierżawę do użycia dla bieżącego użytkownika na tym komputerze.
raport o błędach pobierania
Zwraca informacje o błędach zgłaszanych przez urządzenia w bieżącej dzierżawie.
To polecenie pobiera dane zdarzeń z chmury usługi zabezpieczeń Azure Sphere i nie wymaga fizycznego połączenia z konkretnym urządzeniem. Polecenie pobierz-raport dotyczący błędów dzierżawy azsphere działa w kontekście bieżącej dzierżawy i zwraca raporty o błędach dla wszystkich urządzeń w tej dzierżawie.
Uwaga
Może upłynąć do 24 godzin, aż ostatnio zgłoszone zdarzenia będą dostępne do pobrania. Aby uzyskać więcej informacji, zobacz Zbieranie i interpretowanie danych o błędach.
Parametry opcjonalne
| Parametr | Typu | Opis |
|---|---|---|
| --Docelowy | Ciąg | Określa ścieżkę i nazwę pliku wyjściowego. |
| -t, --tenant | Identyfikator GUID lub nazwa | Określa dzierżawę, w ramach która ma wykonać tę operację. Zastępuje domyślną wybraną dzierżawę. Możesz określić identyfikator dzierżawy lub nazwę dzierżawy. |
Parametry globalne
Następujące parametry globalne są dostępne dla środowiska Azure Sphere CLI:
| Parametr | Opis |
|---|---|
| --Debugowania | Zwiększa poziom szczegółowości rejestrowania, aby wyświetlić wszystkie dzienniki debugowania. Jeśli znajdziesz błąd, podaj dane wyjściowe wygenerowane z flagą --debug podczas przesyłania raportu o usterce. |
| -h, --help | Umożliwia drukowanie informacji odwołań do poleceń i ich argumentów oraz list dostępnych podgrup i poleceń. |
| --only-show-errors | Wyświetla tylko błędy, pomijając ostrzeżenia. |
| -o, --output | Zmienia format wyjściowy. Dostępne formaty wyjściowe to json, jsonc (kolorowy JSON), tsv (wartości oddzielone tabulatorami), tabela (czytelne dla człowieka tabele ASCII) i yaml. Domyślnie wynik tableinterfejsu. Aby dowiedzieć się więcej o dostępnych formatach wyjściowych, zobacz Format wyjściowy dla poleceń platformy Azure Sphere CLI. |
| --Kwerendy | Używa języka zapytań JMESPath do filtrowania danych wyjściowych zwróconych przez usługi zabezpieczeń Azure Sphere. Aby uzyskać więcej informacji i przykładów, zobacz Samouczek programu JMESPath i Dane wyjściowe poleceń interfejsu platformy Azure CLI. |
| --Pełne | Drukowanie informacji o zasobach utworzonych w usłudze Azure Sphere podczas operacji i innych przydatnych informacji. Służy --debug do pełnego tworzenia dzienników debugowania. |
Uwaga
Jeśli używasz klasycznej platformy Azure Sphere, zobacz Parametry globalne , aby uzyskać więcej informacji na temat dostępnych opcji.
Przykład
azsphere tenant download-error-report --destination c:\error-report.csv --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb
Listy
Lista dzierżaw usługi Azure Sphere.
Parametry globalne
Następujące parametry globalne są dostępne dla środowiska Azure Sphere CLI:
| Parametr | Opis |
|---|---|
| --Debugowania | Zwiększa poziom szczegółowości rejestrowania, aby wyświetlić wszystkie dzienniki debugowania. Jeśli znajdziesz błąd, podaj dane wyjściowe wygenerowane z flagą --debug podczas przesyłania raportu o usterce. |
| -h, --help | Umożliwia drukowanie informacji odwołań do poleceń i ich argumentów oraz list dostępnych podgrup i poleceń. |
| --only-show-errors | Wyświetla tylko błędy, pomijając ostrzeżenia. |
| -o, --output | Zmienia format wyjściowy. Dostępne formaty wyjściowe to json, jsonc (kolorowy JSON), tsv (wartości oddzielone tabulatorami), tabela (czytelne dla człowieka tabele ASCII) i yaml. Domyślnie wynik tableinterfejsu. Aby dowiedzieć się więcej o dostępnych formatach wyjściowych, zobacz Format wyjściowy dla poleceń platformy Azure Sphere CLI. |
| --Kwerendy | Używa języka zapytań JMESPath do filtrowania danych wyjściowych zwróconych przez usługi zabezpieczeń Azure Sphere. Aby uzyskać więcej informacji i przykładów, zobacz Samouczek programu JMESPath i Dane wyjściowe poleceń interfejsu platformy Azure CLI. |
| --Pełne | Drukowanie informacji o zasobach utworzonych w usłudze Azure Sphere podczas operacji i innych przydatnych informacji. Służy --debug do pełnego tworzenia dzienników debugowania. |
Uwaga
Jeśli używasz klasycznej platformy Azure Sphere, zobacz Parametry globalne , aby uzyskać więcej informacji na temat dostępnych opcji.
Przykład
azsphere tenant list
------------------------------------ --------------------- -------------
Id Name Roles
========================================================================
143adbc9-1bf0-4be2-84a2-084a331d81cb MyTenant Administrator
Contributor
------------------------------------ --------------------- -------------
Wybierz
Wybiera domyślną dzierżawę usługi Azure Sphere do użycia dla bieżącego użytkownika na tym komputerze.
Aby wyświetlić bieżącą dzierżawę domyślną, użyj wybranej dzierżawy azsphere.
Wymagane parametry
| Parametr | Typu | Opis |
|---|---|---|
| -t, --tenant | Identyfikator GUID lub nazwa | Określa dzierżawę, w ramach która ma wykonać tę operację. Zastępuje domyślną wybraną dzierżawę. Możesz określić identyfikator dzierżawy lub nazwę dzierżawy. |
Parametry globalne
Następujące parametry globalne są dostępne dla środowiska Azure Sphere CLI:
| Parametr | Opis |
|---|---|
| --Debugowania | Zwiększa poziom szczegółowości rejestrowania, aby wyświetlić wszystkie dzienniki debugowania. Jeśli znajdziesz błąd, podaj dane wyjściowe wygenerowane z flagą --debug podczas przesyłania raportu o usterce. |
| -h, --help | Umożliwia drukowanie informacji odwołań do poleceń i ich argumentów oraz list dostępnych podgrup i poleceń. |
| --only-show-errors | Wyświetla tylko błędy, pomijając ostrzeżenia. |
| -o, --output | Zmienia format wyjściowy. Dostępne formaty wyjściowe to json, jsonc (kolorowy JSON), tsv (wartości oddzielone tabulatorami), tabela (czytelne dla człowieka tabele ASCII) i yaml. Domyślnie wynik tableinterfejsu. Aby dowiedzieć się więcej o dostępnych formatach wyjściowych, zobacz Format wyjściowy dla poleceń platformy Azure Sphere CLI. |
| --Kwerendy | Używa języka zapytań JMESPath do filtrowania danych wyjściowych zwróconych przez usługi zabezpieczeń Azure Sphere. Aby uzyskać więcej informacji i przykładów, zobacz Samouczek programu JMESPath i Dane wyjściowe poleceń interfejsu platformy Azure CLI. |
| --Pełne | Drukowanie informacji o zasobach utworzonych w usłudze Azure Sphere podczas operacji i innych przydatnych informacji. Służy --debug do pełnego tworzenia dzienników debugowania. |
Uwaga
Jeśli używasz klasycznej platformy Azure Sphere, zobacz Parametry globalne , aby uzyskać więcej informacji na temat dostępnych opcji.
Przykład
azsphere tenant select --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb
------------------------------------ --------------------- -------------
Id Name Roles
========================================================================
143adbc9-1bf0-4be2-84a2-084a331d81cb MyTenant Administrator
Contributor
------------------------------------ --------------------- -------------
pokaż zaznaczone
Wyświetla szczegóły domyślnej dzierżawy usługi Azure Sphere dla bieżącego użytkownika na tym komputerze.
Jest to dzierżawa wybrana z poleceniem wybierz dzierżawę azsphere .
Parametry globalne
Następujące parametry globalne są dostępne dla środowiska Azure Sphere CLI:
| Parametr | Opis |
|---|---|
| --Debugowania | Zwiększa poziom szczegółowości rejestrowania, aby wyświetlić wszystkie dzienniki debugowania. Jeśli znajdziesz błąd, podaj dane wyjściowe wygenerowane z flagą --debug podczas przesyłania raportu o usterce. |
| -h, --help | Umożliwia drukowanie informacji odwołań do poleceń i ich argumentów oraz list dostępnych podgrup i poleceń. |
| --only-show-errors | Wyświetla tylko błędy, pomijając ostrzeżenia. |
| -o, --output | Zmienia format wyjściowy. Dostępne formaty wyjściowe to json, jsonc (kolorowy JSON), tsv (wartości oddzielone tabulatorami), tabela (czytelne dla człowieka tabele ASCII) i yaml. Domyślnie wynik tableinterfejsu. Aby dowiedzieć się więcej o dostępnych formatach wyjściowych, zobacz Format wyjściowy dla poleceń platformy Azure Sphere CLI. |
| --Kwerendy | Używa języka zapytań JMESPath do filtrowania danych wyjściowych zwróconych przez usługi zabezpieczeń Azure Sphere. Aby uzyskać więcej informacji i przykładów, zobacz Samouczek programu JMESPath i Dane wyjściowe poleceń interfejsu platformy Azure CLI. |
| --Pełne | Drukowanie informacji o zasobach utworzonych w usłudze Azure Sphere podczas operacji i innych przydatnych informacji. Służy --debug do pełnego tworzenia dzienników debugowania. |
Uwaga
Jeśli używasz klasycznej platformy Azure Sphere, zobacz Parametry globalne , aby uzyskać więcej informacji na temat dostępnych opcji.
Przykład
azsphere tenant show-selected
------------------------------------ --------------------- -------------
Id Name Roles
========================================================================
143adbc9-1bf0-4be2-84a2-084a331d81cb MyTenant Administrator
Contributor
------------------------------------ --------------------- -------------
Aktualizacji
Aktualizacje szczegóły dzierżawy, takie jak nazwa dzierżawy.
Wymagane parametry
| Parametr | Typu | Opis |
|---|---|---|
| -n, --nowa nazwa | Ciąg | Określa nową nazwę dzierżawy. Podczas nazywania dzierżawy używaj znaków alfanumerycznych. Znaki specjalne są niedozwolone. Nazwa nie może przekraczać 50 znaków i uwzględnia wielkość liter. |
Parametry opcjonalne
| Parametr | Typu | Opis |
|---|---|---|
| -t, --tenant | Identyfikator GUID lub nazwa | Określa dzierżawę, w ramach która ma wykonać tę operację. Zastępuje domyślną wybraną dzierżawę. Możesz określić identyfikator dzierżawy lub nazwę dzierżawy. |
Parametry globalne
Następujące parametry globalne są dostępne dla środowiska Azure Sphere CLI:
| Parametr | Opis |
|---|---|
| --Debugowania | Zwiększa poziom szczegółowości rejestrowania, aby wyświetlić wszystkie dzienniki debugowania. Jeśli znajdziesz błąd, podaj dane wyjściowe wygenerowane z flagą --debug podczas przesyłania raportu o usterce. |
| -h, --help | Umożliwia drukowanie informacji odwołań do poleceń i ich argumentów oraz list dostępnych podgrup i poleceń. |
| --only-show-errors | Wyświetla tylko błędy, pomijając ostrzeżenia. |
| -o, --output | Zmienia format wyjściowy. Dostępne formaty wyjściowe to json, jsonc (kolorowy JSON), tsv (wartości oddzielone tabulatorami), tabela (czytelne dla człowieka tabele ASCII) i yaml. Domyślnie wynik tableinterfejsu. Aby dowiedzieć się więcej o dostępnych formatach wyjściowych, zobacz Format wyjściowy dla poleceń platformy Azure Sphere CLI. |
| --Kwerendy | Używa języka zapytań JMESPath do filtrowania danych wyjściowych zwróconych przez usługi zabezpieczeń Azure Sphere. Aby uzyskać więcej informacji i przykładów, zobacz Samouczek programu JMESPath i Dane wyjściowe poleceń interfejsu platformy Azure CLI. |
| --Pełne | Drukowanie informacji o zasobach utworzonych w usłudze Azure Sphere podczas operacji i innych przydatnych informacji. Służy --debug do pełnego tworzenia dzienników debugowania. |
Uwaga
Jeśli używasz klasycznej platformy Azure Sphere, zobacz Parametry globalne , aby uzyskać więcej informacji na temat dostępnych opcji.
Przykład
azsphere tenant update --tenant a323c263-2aa3-2559-aabb-a3fc32631900 --new-name Tenant2
------------------------------------ --------------------- -------------
Id Name Roles
========================================================================
a323c263-2aa3-2559-aabb-a3fc32631900 Tenant2 Administrator
Contributor
------------------------------------ --------------------- -------------
Wskazówka
Jeśli nie wybrano dzierżawy domyślnej, zostanie wyświetlona lista dostępnych dzierżaw. Ustaw dzierżawę domyślną, wybierając jedną z opcji.