Megosztás a következőn keresztül:

az iot hub state

  • Kísérleti
  • Referencia

Megjegyzés:

Ez a hivatkozás az Azure CLI azure-iot bővítményének része (2.37.0-s vagy újabb verzió). A bővítmény automatikusan telepíti az az iot hub state parancs első futtatásakor. További információ a bővítményekről.

Ez a parancscsoport kísérleti és fejlesztés alatt áll. Referencia- és támogatási szintek: https://aka.ms/CLI_refstatus

IoT Hub állapotának kezelése.

További információ: aka.ms/aziotcli-iot-hub-state.

Parancsok

Name Description Típus Állapot
az iot hub state export

Exportálja az IoT Hub állapotát egy fájlba.

 Extension Kísérleti
az iot hub state import

Hub-állapot importálása fájlból egy IoT Hubba.

 Extension Kísérleti
az iot hub state migrate

Az egyik központ állapotának áttelepítése egy másik központba fájlba mentés nélkül.

 Extension Kísérleti

az iot hub state export

Kísérleti

Az "iot hub state" parancscsoport kísérleti és fejlesztés alatt áll. Referencia- és támogatási szintek: https://aka.ms/CLI_refstatus

Exportálja az IoT Hub állapotát egy fájlba.

Alapértelmezés szerint az exportált állapot a következőkre terjed ki: a központ arm-sablonja, a központi konfigurációk (beleértve az ADM-konfigurációkat és az éltelepítéseket), az eszközinformációk (beleértve az eszköz identitjait, az ikereszközöket, a modulidentitásokat és a modul-ikermodulokat).

További információ: aka.ms/aziotcli-iot-hub-state.

az iot hub state export --state-file
                        [--aspects {arm, configurations, devices}]
                        [--auth-type {key, login}]
                        [--hub-name]
                        [--login]
                        [--replace]
                        [--resource-group]

Példák

Exportálja a megadott központ támogatott állapotát a megadott fájlba.

az iot hub state export -n {iothub_name} -f {state_filename}

Exportálja a megadott központ támogatott állapotát a megadott fájlba, felülírva a fájl tartalmát.

az iot hub state export -n {iothub_name} -f {state_filename} -r

Csak a megadott központ eszközeit és konfigurációit exportálja a megadott fájlba.

az iot hub state export -n {iothub_name} -f {state_filename} --aspects devices configurations

Kötelező paraméterek

--state-file -f

Annak a fájlnak az elérési útja, amelyben az állapotinformációk tárolódnak.

Opcionális paraméterek

--aspects

Központi szempontok (térelválasztó).

elfogadott értékek: arm, configurations, devices
--auth-type

Azt jelzi, hogy a műveletnek automatikusan le kell-e származtatnia egy szabályzatkulcsot, vagy az aktuális Azure AD-munkamenetet kell-e használnia. Ha a hitelesítési típus bejelentkezés, és az erőforrás-állomásnév meg van adva, az erőforrás-keresés kihagyva lesz, hacsak nem szükséges. Az alapértelmezett beállítást a következővel az configure --defaults iothub-data-auth-type=<auth-type-value>konfigurálhatja: .

elfogadott értékek: key, login
alapértelmezett érték: key
--hub-name -n

IoT Hub neve vagy állomásneve. Kötelező, ha a --login nincs megadva.

--login -l

Ez a parancs egy művelet végrehajtására jogosult entitást kapcsolati sztring támogat. Az "az login" használatával elkerülheti a munkamenet-bejelentkezést. Ha egy entitás kapcsolati sztring és név is meg van adva, a kapcsolati sztring elsőbbséget élvez. Ha a --hub-name nincs megadva, kötelező megadni.

--replace -r

Ha ez a jelző be van állítva, a parancs felülírja a kimeneti fájl tartalmát.

alapértelmezett érték: False
--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az iot hub state import

Kísérleti

Az "iot hub state" parancscsoport kísérleti és fejlesztés alatt áll. Referencia- és támogatási szintek: https://aka.ms/CLI_refstatus

Hub-állapot importálása fájlból egy IoT Hubba.

Ha a kar aspektusa meg van adva, a központ akkor jön létre, ha nem létezik.

Alapértelmezés szerint az importált állapot a következőkre terjed ki: a központ arm-sablonja, a központi konfigurációk (beleértve az ADM-konfigurációkat és a peremhálózati telepítéseket), az eszközinformációk (beleértve az eszköz identititásait, az ikereszközöket, a modulidentitásokat és a modul-ikermodulokat).

A rendszer által hozzárendelt identitáshitelesítéssel rendelkező importált végpontok esetében a megadott központnak megfelelő engedélyekkel kell rendelkeznie. Ellenkező esetben a parancs sikertelen lesz.

Az importálási folyamat figyelmen kívül hagyja a privát végpontokat.

További információ: aka.ms/aziotcli-iot-hub-state.

az iot hub state import --state-file
                        [--aspects {arm, configurations, devices}]
                        [--auth-type {key, login}]
                        [--hub-name]
                        [--login]
                        [--replace]
                        [--resource-group]

Példák

Importálja a támogatott állapotot a megadott fájlból a megadott központba.

az iot hub state import -n {iothub_name} -f {state_filename}

Importálja a támogatott állapotot a megadott fájlból a megadott központba, felülírva a központ előző állapotát. Az új állapot feltöltése előtt minden tanúsítvány, konfiguráció és eszköz törlődik.

az iot hub state import -n {iothub_name} -f {state_filename} -r

Csak az arm-sablon importálása a megadott fájlból a megadott központba. Vegye figyelembe, hogy ez egy új központot hoz létre, ha nem létezik. A fájl tartalmazhat eszközöket és konfigurációkat, de ezek figyelmen kívül lesznek hagyva.

az iot hub state import -n {iothub_name} -g {resource_group} -f {state_filename} --aspects arm

Csak az eszközöket és konfigurációkat importálja a megadott fájlból a megadott központba. Vegye figyelembe, hogy ez NEM hoz létre új központot, ha nem létezik, és a parancs sikertelen lesz. Előfordulhat, hogy a fájl tartalmazza az arm-sablont, de ezt a rendszer figyelmen kívül hagyja.

az iot hub state import -n {iothub_name} -f {state_filename} --aspects devices configurations

Kötelező paraméterek

--state-file -f

Annak a fájlnak az elérési útja, amelyben az állapotinformációk tárolódnak.

Opcionális paraméterek

--aspects

Központi szempontok (térelválasztó).

elfogadott értékek: arm, configurations, devices
--auth-type

Azt jelzi, hogy a műveletnek automatikusan le kell-e származtatnia egy szabályzatkulcsot, vagy az aktuális Azure AD-munkamenetet kell-e használnia. Ha a hitelesítési típus bejelentkezés, és az erőforrás-állomásnév meg van adva, az erőforrás-keresés kihagyva lesz, hacsak nem szükséges. Az alapértelmezett beállítást a következővel az configure --defaults iothub-data-auth-type=<auth-type-value>konfigurálhatja: .

elfogadott értékek: key, login
alapértelmezett érték: key
--hub-name -n

IoT Hub neve vagy állomásneve. Kötelező, ha a --login nincs megadva.

--login -l

Ez a parancs egy művelet végrehajtására jogosult entitást kapcsolati sztring támogat. Az "az login" használatával elkerülheti a munkamenet-bejelentkezést. Ha egy entitás kapcsolati sztring és név is meg van adva, a kapcsolati sztring elsőbbséget élvez. Ha a --hub-name nincs megadva, kötelező megadni.

--replace -r

Ha ez a jelző be van állítva, a parancs törli a célközpont aktuális eszközeit, konfigurációit és tanúsítványait.

alapértelmezett érték: False
--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az iot hub state migrate

Kísérleti

Az "iot hub state" parancscsoport kísérleti és fejlesztés alatt áll. Referencia- és támogatási szintek: https://aka.ms/CLI_refstatus

Az egyik központ állapotának áttelepítése egy másik központba fájlba mentés nélkül.

Ha a kar aspektusa meg van adva, a központ akkor jön létre, ha nem létezik.

Alapértelmezés szerint a migrált állapot a következőkre terjed ki: a központ arm-sablonja, a központi konfigurációk (beleértve az ADM-konfigurációkat és az éltelepítéseket), az eszközinformációk (beleértve az eszköz identititásait, az ikereszközöket, a modulidentitásokat és a modul-ikermodulokat).

A rendszer által hozzárendelt identitáshitelesítéssel rendelkező migrált végpontok esetében a megadott központnak megfelelő engedélyekkel kell rendelkeznie. Ellenkező esetben a parancs sikertelen lesz.

A migrálási folyamat figyelmen kívül hagyja a privát végpontokat.

Ha problémát tapasztal az áttelepítés során, az exportálási és importálási parancsokkal készítsen biztonsági másolatot egy fájlról.

További információ: aka.ms/aziotcli-iot-hub-state.

az iot hub state migrate [--aspects {arm, configurations, devices}]
                         [--auth-type {key, login}]
                         [--destination-hub]
                         [--destination-hub-login]
                         [--destination-resource-group]
                         [--og]
                         [--oh]
                         [--ol]
                         [--replace]

Példák

A forrásközpont támogatott állapotának migrálása a célközpontba.

az iot hub state migrate --destination-hub {dest_hub_name} --origin-hub {orig_hub_name}

Migrálja a forrásközpont támogatott állapotát a célközpontba, felülírva a központ előző állapotát. A célközpont összes tanúsítványa, konfigurációja és eszköze törlődik az új állapot feltöltése előtt.

az iot hub state migrate --destination-hub {dest_hub_name} --origin-hub {orig_hub_name} -r

Csak az arm-sablon áttelepítése a forrásközpontból a célközpontba. Vegye figyelembe, hogy ez egy új központot hoz létre, ha a célközpont nem létezik. A forrásközpont tartalmazhatja az eszközöket és a konfigurációkat, de ezek figyelmen kívül lesznek hagyva.

az iot hub state migrate --destination-hub {dest_hub_name} --destination-resource-group {dest_hub_resource_group} --origin-hub {orig_hub_name} --aspects arm

Csak az eszközöket és konfigurációkat migrálja a forrásközpontból a célközpontba. Vegye figyelembe, hogy ez NEM hoz létre új központot, ha a célközpont nem létezik, és a parancs sikertelen lesz. A forrásközpont armsablonja figyelmen kívül lesz hagyva.

az iot hub state migrate --destination-hub {dest_hub_name} --origin-hub {orig_hub_name} --aspects devices configurations

Opcionális paraméterek

--aspects

Központi szempontok (térelválasztó).

elfogadott értékek: arm, configurations, devices
--auth-type

Azt jelzi, hogy a műveletnek automatikusan le kell-e származtatnia egy szabályzatkulcsot, vagy az aktuális Azure AD-munkamenetet kell-e használnia. Ha a hitelesítési típus bejelentkezés, és az erőforrás-állomásnév meg van adva, az erőforrás-keresés kihagyva lesz, hacsak nem szükséges. Az alapértelmezett beállítást a következővel az configure --defaults iothub-data-auth-type=<auth-type-value>konfigurálhatja: .

elfogadott értékek: key, login
alapértelmezett érték: key
--destination-hub --dh

Annak az IoT Hubnak a neve, ahová a forrásközpont állapota át lesz másolva.

--destination-hub-login --dl

Ez a parancs egy olyan entitást támogat, kapcsolati sztring, amely jogosult a művelet végrehajtására a célközpontban. Ezzel elkerülheti a munkamenet-bejelentkezést az login ehhez az IoT Hub-példányhoz. Ha egy entitás kapcsolati sztring és név is meg van adva, a kapcsolati sztring elsőbbséget élvez. Kötelező, ha a --destination-hub nincs megadva.

--destination-resource-group --dg

Annak az IoT Hubnak az erőforráscsoportja, amelybe a forrásközpont állapota át lesz másolva. Ha nincs megadva, a forrás IoT Hub erőforráscsoportját fogja használni.

--og --origin-resource-group

A másolandó IoT Hub erőforráscsoportjának neve.

--oh --origin-hub

A másolandó IoT Hub neve.

--ol --origin-hub-login

Ez a parancs támogat egy entitást kapcsolati sztring, amely jogosult a műveletek végrehajtására a forrásközpontban. Ezzel elkerülheti a munkamenet-bejelentkezést az login ehhez az IoT Hub-példányhoz. Ha egy entitás kapcsolati sztring és név is meg van adva, a kapcsolati sztring elsőbbséget élvez. Kötelező, ha a --origin-hub nincs megadva.

--replace -r

Ha ez a jelző be van állítva, a parancs törli a célközpont aktuális eszközeit, konfigurációit és tanúsítványait.

alapértelmezett érték: False
Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.