Bérlő
Egy Azure Sphere-bérlőt kezel.
Fontos
A , azsphere tenant download-ca-certificate-chainés azsphere tenant download-validation-certificate parancsok azsphere tenant download-ca-certificateelavultak. Használja azsphere ca-certificate downloadhelyette a , azsphere ca-certificate download-chain, azsphere ca-certificate download-proofés azsphere ca-certificate list parancsot.
Az Azure Sphere CLI-ben a rendszer nem választja ki automatikusan az alapértelmezett bérlőt a bérlő létrehozásakor. Az azsphere tenant select parancs futtatásával válassza ki a számítógép aktuális felhasználójához használandó alapértelmezett bérlőt. Ezzel biztosíthatja, hogy az alapértelmezett bérlő legyen a megfelelő, amelyet nem vonható vissza, például az eszköz igénylése során.
| Művelet | Leírás |
|---|---|
| Létrehozása | Új bérlőt hoz létre. |
| download-error-report | Az aktuális bérlőn belüli eszközök hibaadatait adja vissza. |
| Lista | Felsorolja az elérhető Azure Sphere-bérlőket. |
| Válassza ki | Kiválasztja a számítógépen használni kívánt alapértelmezett Azure Sphere-bérlőt. |
| show-selected | A számítógép alapértelmezett Azure Sphere-bérlője. |
| Frissítés | Frissítések a bérlő adatait, például a bérlő nevét. |
Létrehozása
Létrehoz egy új Azure Sphere-bérlőt. A parancs futtatásához csatlakoztatott eszközre van szükség. További információ: Azure Sphere-bérlő létrehozása.
Ha már rendelkezik bérlővel, és biztos benne, hogy egy másikat szeretne, használja a paramétert --force-additional . Jelenleg nem törölhet Azure Sphere-bérlőt.
A bérlő létrehozása után futtassa az azsphere tenant select parancsot, és válassza ki a számítógép aktuális felhasználójához használandó alapértelmezett bérlőt. Az azsphere role add paranccsal adhat hozzá szerepköröket az aktuális Azure Sphere-bérlő felhasználóihoz.
Az azsphere tenant create parancs helyileg csatlakoztatott Azure Sphere-eszközzel működik. Ha eszköz nélkül kísérli meg a parancsot, hibaüzenet jelenik meg. Az eszközazonosítót a rendszer a bérlő létrehozásakor rögzíti, és eszközönként csak egy bérlő hozható létre.
Kötelező paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| -n, --name | Karakterlánc | Megadja a bérlő nevét. A bérlő elnevezésekor használjon alfanumerikus karaktereket. Speciális karakterek nem használhatók. A név nem lehet hosszabb 50 karakternél, és megkülönbözteti a kis- és nagybetűk karaktereit. |
Választható paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| -d, --device | Karakterlánc | Azt az eszközt adja meg, amelyen több eszköz csatlakoztatásakor futtatni szeretné a parancsot. Ez a paraméter több eszköz csatlakoztatása esetén szükséges. A rendszer alapértelmezés szerint a jelenleg csatlakoztatott eszközt használja. Megadhatja a csatlakoztatott eszköz eszközazonosítóját, IP-címét vagy helyi kapcsolatazonosítóját. Az Azure Sphere CLI több MT3620-eszközt támogat Windows rendszeren, de Linux rendszeren egyszerre csak egy eszközt csatlakoztathat. Ezért ez a paraméter Windows rendszeren támogatott, Linuxon azonban nem. A rendszer hibát ad vissza, ha ezt a paramétert a linuxos paranccsal használja. |
| --force-additional | Logikai | Új Azure Sphere-bérlő létrehozását kényszeríti ki. Ezt a parancsot csak akkor használja, ha biztos abban, hogy az aktuális fiókkal szeretne új Azure Sphere-bérlőt létrehozni a csatolt eszközzel. |
| --disable-confirm-prompt | Logikai | Letiltja a felhasználó megerősítését kérő üzenetet. |
Globális paraméterek
Az Azure Sphere CLI-hez a következő globális paraméterek érhetők el:
| Paraméter | Leírás |
|---|---|
| --Debug | Növeli a naplózás részletességét az összes hibakeresési napló megjelenítéséhez. Ha hibát talál, adja meg a hibajelentés elküldésekor a --debug jelzővel létrehozott kimenetet. |
| -h, --help | Parancssori felületi hivatkozási információkat nyomtat ki a parancsokról és azok argumentumairól, valamint felsorolja az elérhető alcsoportokat és parancsokat. |
| --only-show-errors | Csak a hibákat jeleníti meg, és letiltja a figyelmeztetéseket. |
| -o, --output | A kimeneti formátum módosítása. Az elérhető kimeneti formátumok a következők: json, jsonc (színezett JSON), tsv (tabulátorral tagolt értékek), táblázat (emberi olvasásra alkalmas ASCII-táblák) és yaml. Alapértelmezés szerint a parancssori felület kimenete table. Az elérhető kimeneti formátumokról további információt az Azure Sphere CLI-parancsok kimeneti formátumát ismertető cikkben talál. |
| --Lekérdezés | A JMESPath lekérdezési nyelv használatával szűri az Azure Sphere Security Services által visszaadott kimenetet. További információkért és példákért lásd: JMESPath-oktatóanyag és Azure CLI-parancskimenet lekérdezése . |
| --Részletes | Kinyomtatja az Azure Sphere-ben egy művelet során létrehozott erőforrásokra vonatkozó információkat és egyéb hasznos információkat. Teljes hibakeresési naplókhoz használható --debug . |
Megjegyzés
Ha klasszikus Azure Sphere cli-t használ, az elérhető lehetőségekről további információt a Globális paraméterek című témakörben talál.
Példa
azsphere tenant create --name MyTenant
Használja a és --disable-confirm-prompt a --force-additional paramétert, ha biztos abban, hogy ezzel a fiókkal szeretne létrehozni egy új Azure Sphere-bérlőt a csatolt eszközzel. Az Azure Sphere-bérlő létrehozásához korábban használt eszközök nem használhatók új bérlő létrehozásához.
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.
Tipp
Miután létrehozott egy bérlőt, győződjön meg arról, hogy futtatja az azsphere-bérlőt, és válassza ki a számítógép aktuális felhasználójához használandó alapértelmezett bérlőt.
download-error-report
Információkat ad vissza az aktuális bérlőn belüli eszközök által jelentett hibákról.
Ez a parancs lekéri az eseményadatokat az Azure Sphere Security Service felhőből, és nem igényel fizikai kapcsolatot egy adott eszközzel. Az azsphere tenant download-error-report parancs az aktuális bérlő kontextusában működik, és hibajelentéseket ad vissza az adott bérlőn belüli összes eszközre vonatkozóan.
Megjegyzés
Akár 24 órába is telhet, hogy a közelmúltban jelentett események letölthetők legyenek. További információ: Hibaadatok gyűjtése és értelmezése.
Választható paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| --Cél | Karakterlánc | Megadja a kimeneti fájl elérési útját és fájlnevét. |
| -t, --tenant | GUID vagy név | Meghatározza a bérlőt, amelyben a műveletet végre kívánja hajtani. Felülbírálja az alapértelmezett kijelölt bérlőt. Megadhatja a bérlőazonosítót vagy a bérlő nevét. |
Globális paraméterek
Az Azure Sphere CLI-hez a következő globális paraméterek érhetők el:
| Paraméter | Leírás |
|---|---|
| --Debug | Növeli a naplózás részletességét az összes hibakeresési napló megjelenítéséhez. Ha hibát talál, adja meg a hibajelentés elküldésekor a --debug jelzővel létrehozott kimenetet. |
| -h, --help | Parancssori felületi hivatkozási információkat nyomtat ki a parancsokról és azok argumentumairól, valamint felsorolja az elérhető alcsoportokat és parancsokat. |
| --only-show-errors | Csak a hibákat jeleníti meg, és letiltja a figyelmeztetéseket. |
| -o, --output | A kimeneti formátum módosítása. Az elérhető kimeneti formátumok a következők: json, jsonc (színezett JSON), tsv (tabulátorral tagolt értékek), táblázat (emberi olvasásra alkalmas ASCII-táblák) és yaml. Alapértelmezés szerint a parancssori felület kimenete table. Az elérhető kimeneti formátumokról további információt az Azure Sphere CLI-parancsok kimeneti formátumát ismertető cikkben talál. |
| --Lekérdezés | A JMESPath lekérdezési nyelv használatával szűri az Azure Sphere Security Services által visszaadott kimenetet. További információkért és példákért lásd: JMESPath-oktatóanyag és Azure CLI-parancskimenet lekérdezése . |
| --Részletes | Kinyomtatja az Azure Sphere-ben egy művelet során létrehozott erőforrásokra vonatkozó információkat és egyéb hasznos információkat. Teljes hibakeresési naplókhoz használható --debug . |
Megjegyzés
Ha klasszikus Azure Sphere cli-t használ, az elérhető lehetőségekről további információt a Globális paraméterek című témakörben talál.
Példa
azsphere tenant download-error-report --destination c:\error-report.csv --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb
Lista
Az Azure Sphere-bérlők listája.
Globális paraméterek
Az Azure Sphere CLI-hez a következő globális paraméterek érhetők el:
| Paraméter | Leírás |
|---|---|
| --Debug | Növeli a naplózás részletességét az összes hibakeresési napló megjelenítéséhez. Ha hibát talál, adja meg a hibajelentés elküldésekor a --debug jelzővel létrehozott kimenetet. |
| -h, --help | Parancssori felületi hivatkozási információkat nyomtat ki a parancsokról és azok argumentumairól, valamint felsorolja az elérhető alcsoportokat és parancsokat. |
| --only-show-errors | Csak a hibákat jeleníti meg, és letiltja a figyelmeztetéseket. |
| -o, --output | A kimeneti formátum módosítása. Az elérhető kimeneti formátumok a következők: json, jsonc (színezett JSON), tsv (tabulátorral tagolt értékek), táblázat (emberi olvasásra alkalmas ASCII-táblák) és yaml. Alapértelmezés szerint a parancssori felület kimenete table. Az elérhető kimeneti formátumokról további információt az Azure Sphere CLI-parancsok kimeneti formátumát ismertető cikkben talál. |
| --Lekérdezés | A JMESPath lekérdezési nyelv használatával szűri az Azure Sphere Security Services által visszaadott kimenetet. További információkért és példákért lásd: JMESPath-oktatóanyag és Azure CLI-parancskimenet lekérdezése . |
| --Részletes | Kinyomtatja az Azure Sphere-ben egy művelet során létrehozott erőforrásokra vonatkozó információkat és egyéb hasznos információkat. Teljes hibakeresési naplókhoz használható --debug . |
Megjegyzés
Ha klasszikus Azure Sphere cli-t használ, az elérhető lehetőségekről további információt a Globális paraméterek című témakörben talál.
Példa
azsphere tenant list
------------------------------------ --------------------- -------------
Id Name Roles
========================================================================
143adbc9-1bf0-4be2-84a2-084a331d81cb MyTenant Administrator
Contributor
------------------------------------ --------------------- -------------
Válassza ki
Kiválasztja az alapértelmezett Azure Sphere-bérlőt, amelyet a számítógép aktuális felhasználója használ.
Az aktuális alapértelmezett bérlő megjelenítéséhez használja az azsphere tenant show-selected parancsot.
Kötelező paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| -t, --tenant | GUID vagy név | Meghatározza a bérlőt, amelyben a műveletet végre kívánja hajtani. Felülbírálja az alapértelmezett kijelölt bérlőt. Megadhatja a bérlőazonosítót vagy a bérlő nevét. |
Globális paraméterek
Az Azure Sphere CLI-hez a következő globális paraméterek érhetők el:
| Paraméter | Leírás |
|---|---|
| --Debug | Növeli a naplózás részletességét az összes hibakeresési napló megjelenítéséhez. Ha hibát talál, adja meg a hibajelentés elküldésekor a --debug jelzővel létrehozott kimenetet. |
| -h, --help | Parancssori felületi hivatkozási információkat nyomtat ki a parancsokról és azok argumentumairól, valamint felsorolja az elérhető alcsoportokat és parancsokat. |
| --only-show-errors | Csak a hibákat jeleníti meg, és letiltja a figyelmeztetéseket. |
| -o, --output | A kimeneti formátum módosítása. Az elérhető kimeneti formátumok a következők: json, jsonc (színezett JSON), tsv (tabulátorral tagolt értékek), táblázat (emberi olvasásra alkalmas ASCII-táblák) és yaml. Alapértelmezés szerint a parancssori felület kimenete table. Az elérhető kimeneti formátumokról további információt az Azure Sphere CLI-parancsok kimeneti formátumát ismertető cikkben talál. |
| --Lekérdezés | A JMESPath lekérdezési nyelv használatával szűri az Azure Sphere Security Services által visszaadott kimenetet. További információkért és példákért lásd: JMESPath-oktatóanyag és Azure CLI-parancskimenet lekérdezése . |
| --Részletes | Kinyomtatja az Azure Sphere-ben egy művelet során létrehozott erőforrásokra vonatkozó információkat és egyéb hasznos információkat. Teljes hibakeresési naplókhoz használható --debug . |
Megjegyzés
Ha klasszikus Azure Sphere cli-t használ, az elérhető lehetőségekről további információt a Globális paraméterek című témakörben talál.
Példa
azsphere tenant select --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb
------------------------------------ --------------------- -------------
Id Name Roles
========================================================================
143adbc9-1bf0-4be2-84a2-084a331d81cb MyTenant Administrator
Contributor
------------------------------------ --------------------- -------------
show-selected
Megjeleníti az aktuális felhasználó alapértelmezett Azure Sphere-bérlőjének adatait ezen a számítógépen.
Ez az azsphere tenant select paranccsal kiválasztott bérlő.
Globális paraméterek
Az Azure Sphere CLI-hez a következő globális paraméterek érhetők el:
| Paraméter | Leírás |
|---|---|
| --Debug | Növeli a naplózás részletességét az összes hibakeresési napló megjelenítéséhez. Ha hibát talál, adja meg a hibajelentés elküldésekor a --debug jelzővel létrehozott kimenetet. |
| -h, --help | Parancssori felületi hivatkozási információkat nyomtat ki a parancsokról és azok argumentumairól, valamint felsorolja az elérhető alcsoportokat és parancsokat. |
| --only-show-errors | Csak a hibákat jeleníti meg, és letiltja a figyelmeztetéseket. |
| -o, --output | A kimeneti formátum módosítása. Az elérhető kimeneti formátumok a következők: json, jsonc (színezett JSON), tsv (tabulátorral tagolt értékek), táblázat (emberi olvasásra alkalmas ASCII-táblák) és yaml. Alapértelmezés szerint a parancssori felület kimenete table. Az elérhető kimeneti formátumokról további információt az Azure Sphere CLI-parancsok kimeneti formátumát ismertető cikkben talál. |
| --Lekérdezés | A JMESPath lekérdezési nyelv használatával szűri az Azure Sphere Security Services által visszaadott kimenetet. További információkért és példákért lásd: JMESPath-oktatóanyag és Azure CLI-parancskimenet lekérdezése . |
| --Részletes | Kinyomtatja az Azure Sphere-ben egy művelet során létrehozott erőforrásokra vonatkozó információkat és egyéb hasznos információkat. Teljes hibakeresési naplókhoz használható --debug . |
Megjegyzés
Ha klasszikus Azure Sphere cli-t használ, az elérhető lehetőségekről további információt a Globális paraméterek című témakörben talál.
Példa
azsphere tenant show-selected
------------------------------------ --------------------- -------------
Id Name Roles
========================================================================
143adbc9-1bf0-4be2-84a2-084a331d81cb MyTenant Administrator
Contributor
------------------------------------ --------------------- -------------
Frissítés
Frissítések a bérlő adatait, például a bérlő nevét.
Kötelező paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| -n, --new-name | Karakterlánc | A bérlő új nevét adja meg. A bérlő elnevezésekor használjon alfanumerikus karaktereket. Speciális karakterek nem használhatók. A név nem lehet hosszabb 50 karakternél, és megkülönbözteti a kis- és nagybetűk karaktereit. |
Választható paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| -t, --tenant | GUID vagy név | Meghatározza a bérlőt, amelyben a műveletet végre kívánja hajtani. Felülbírálja az alapértelmezett kijelölt bérlőt. Megadhatja a bérlőazonosítót vagy a bérlő nevét. |
Globális paraméterek
Az Azure Sphere CLI-hez a következő globális paraméterek érhetők el:
| Paraméter | Leírás |
|---|---|
| --Debug | Növeli a naplózás részletességét az összes hibakeresési napló megjelenítéséhez. Ha hibát talál, adja meg a hibajelentés elküldésekor a --debug jelzővel létrehozott kimenetet. |
| -h, --help | Parancssori felületi hivatkozási információkat nyomtat ki a parancsokról és azok argumentumairól, valamint felsorolja az elérhető alcsoportokat és parancsokat. |
| --only-show-errors | Csak a hibákat jeleníti meg, és letiltja a figyelmeztetéseket. |
| -o, --output | A kimeneti formátum módosítása. Az elérhető kimeneti formátumok a következők: json, jsonc (színezett JSON), tsv (tabulátorral tagolt értékek), táblázat (emberi olvasásra alkalmas ASCII-táblák) és yaml. Alapértelmezés szerint a parancssori felület kimenete table. Az elérhető kimeneti formátumokról további információt az Azure Sphere CLI-parancsok kimeneti formátumát ismertető cikkben talál. |
| --Lekérdezés | A JMESPath lekérdezési nyelv használatával szűri az Azure Sphere Security Services által visszaadott kimenetet. További információkért és példákért lásd: JMESPath-oktatóanyag és Azure CLI-parancskimenet lekérdezése . |
| --Részletes | Kinyomtatja az Azure Sphere-ben egy művelet során létrehozott erőforrásokra vonatkozó információkat és egyéb hasznos információkat. Teljes hibakeresési naplókhoz használható --debug . |
Megjegyzés
Ha klasszikus Azure Sphere cli-t használ, az elérhető lehetőségekről további információt a Globális paraméterek című témakörben talál.
Példa
azsphere tenant update --tenant a323c263-2aa3-2559-aabb-a3fc32631900 --new-name Tenant2
------------------------------------ --------------------- -------------
Id Name Roles
========================================================================
a323c263-2aa3-2559-aabb-a3fc32631900 Tenant2 Administrator
Contributor
------------------------------------ --------------------- -------------
Tipp
Ha nem választott alapértelmezett bérlőt, megjelenik az elérhető bérlők listája. Állítsa be az alapértelmezett bérlőt az egyik lehetőség kiválasztásával.