tenant

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ą).

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. Zamiast tego użyj poleceń azsphere ca-certificate download, azsphere ca-certificate download-chain, azsphere ca-certificate download-proofi azsphere ca-certificate list .

W interfejsie wiersza polecenia usługi Azure Sphere domyślna dzierżawa nie jest automatycznie wybierana podczas tworzenia dzierżawy. Musisz uruchomić polecenie azsphere tenant select , aby wybrać domyślną dzierżawę do użycia dla bieżącego użytkownika na komputerze. Ma to na celu zapewnienie, że domyślna dzierżawa jest poprawna do użycia podczas wykonywania jednorazowej operacji, której nie można cofnąć, na przykład oświadczenia urządzenia.

Działanie	opis
create	Tworzy nową dzierżawę.
download-error-report	Zwraca informacje o błędzie dla urządzeń w bieżącej dzierżawie.
lista	Wyświetla listę dostępnych dzierżaw usługi Azure Sphere.
wybrać	Wybiera domyślną dzierżawę usługi Azure Sphere do użycia na tym komputerze.
show-selected	Pokazuje domyślną dzierżawę usługi Azure Sphere dla tego komputera.
update	Aktualizuje szczegóły dzierżawy, takie jak nazwa dzierżawy.

create

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 innej, użyj parametru --force-additional . Obecnie nie można usunąć dzierżawy usługi Azure Sphere. Po utworzeniu dzierżawy uruchom polecenie azsphere tenant select , aby wybrać domyślną dzierżawę do użycia dla bieżącego użytkownika na tym komputerze. Role dla użytkowników w bieżącej dzierżawie usługi Azure Sphere można dodawać przy użyciu polecenia azsphere role add .

Polecenie azsphere tenant create współpracuje z lokalnie dołączonym urządzeniem usługi Azure Sphere. Jeśli spróbujesz wykonać polecenie bez dołączonego urządzenia, zostanie wyświetlony błąd. Identyfikator urządzenia jest rejestrowany podczas tworzenia dzierżawy i można utworzyć tylko jedną dzierżawę dla każdego urządzenia.

Parametry wymagane

Parametr	Type	opis
-n, --name	String	Określa nazwę dzierżawy. Podczas określania nazwy 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	Type	opis
-d, --device	String	Określa urządzenie, na którym ma zostać uruchomione polecenie, gdy dołączono wiele urządzeń. Ten parametr jest wymagany, gdy dołączono wiele urządzeń. Aktualnie dołą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. Interfejs wiersza polecenia usługi Azure Sphere obsługuje wiele urządzeń MT3620 w systemie Windows, ale można połączyć tylko jedno urządzenie jednocześnie w systemie Linux. Z tego powodu ten parametr jest obsługiwany dla systemu Windows, ale nie dla systemu Linux. Jeśli używasz tego parametru z poleceniem w systemie Linux, zostanie zwrócony błąd.
--force-additional	Wartość logiczna	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	Wartość logiczna	Wyłącza monit o potwierdzenie użytkownika.

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 tenant create --name MyTenant

--force-additional Użyj parametrów i--disable-confirm-prompt, 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. Nie można użyć urządzenia, które zostało wcześniej użyte do utworzenia dzierżawy usługi Azure Sphere w celu 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.

Napiwek

Po utworzeniu dzierżawy upewnij się, że uruchomiono dzierżawę azsphere select, aby wybrać domyślną dzierżawę do użycia dla bieżącego użytkownika na tym komputerze.

download-error-report

Zwraca informacje o błędach zgłaszanych przez urządzenia w bieżącej dzierżawie.

To polecenie ściąga dane zdarzeń z chmury usługi zabezpieczeń Azure Sphere i nie wymaga fizycznego połączenia z określonym urządzeniem. Polecenie azsphere tenant download-error-report działa w kontekście bieżącej dzierżawy i zwraca raporty o błędach dla wszystkich urządzeń w tej dzierżawie.

Uwaga

Pobranie ostatnio zgłoszonych zdarzeń może potrwać do 24 godzin. Aby uzyskać więcej informacji, zobacz Zbieranie i interpretowanie danych o błędach.

Parametry opcjonalne

Parametr	Type	opis
--cel	String	Określa ścieżkę i nazwę pliku wyjściowego.
-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 tenant download-error-report --destination c:\error-report.csv --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb

lista

Wyświetla listę dzierżaw usługi Azure Sphere.

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 tenant list
 ------------------------------------ --------------------- -------------
 Id                                   Name                  Roles
 ========================================================================
 143adbc9-1bf0-4be2-84a2-084a331d81cb MyTenant              Administrator
                                                            Contributor
 ------------------------------------ --------------------- -------------

select

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 polecenia azsphere tenant show-selected.

Parametry wymagane

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 tenant select --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb
 ------------------------------------ --------------------- -------------
 Id                                   Name                  Roles
 ========================================================================
 143adbc9-1bf0-4be2-84a2-084a331d81cb MyTenant               Administrator
                                                            Contributor
 ------------------------------------ --------------------- -------------

show-selected

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 za pomocą polecenia azsphere tenant select .

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 tenant show-selected
 ------------------------------------ --------------------- -------------
 Id                                   Name                  Roles
 ========================================================================
 143adbc9-1bf0-4be2-84a2-084a331d81cb MyTenant               Administrator
                                                            Contributor
 ------------------------------------ --------------------- -------------

update

Aktualizuje szczegóły dzierżawy, takie jak nazwa dzierżawy.

Parametry wymagane

Parametr	Type	opis
-n, --new-name	String	Określa nową nazwę dzierżawy. Podczas określania nazwy 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	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 tenant update --tenant a323c263-2aa3-2559-aabb-a3fc32631900 --new-name Tenant2
 ------------------------------------ --------------------- -------------
 Id                                   Name                  Roles
 ========================================================================
 a323c263-2aa3-2559-aabb-a3fc32631900 Tenant2               Administrator
                                                            Contributor
 ------------------------------------ --------------------- -------------

Napiwek

Jeśli nie wybrano dzierżawy domyślnej, zostanie wyświetlona lista dostępnych dzierżaw. Ustaw domyślną dzierżawę, wybierając jedną z opcji.