az iot hub device-identity

Referencia

Feljegyzé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 device-identity parancs első futtatásakor. További információ a bővítményekről.

IoT-eszközök kezelése.

Parancsok

Name	Description	Típus	Állapot
az iot hub device-identity children	Az IoT edge-eszközök gyermekeszköz-kapcsolatainak kezelése.	Bővítmény	FE
az iot hub device-identity children add	Eszközök hozzáadása gyermekként egy cél peremeszközhöz.	Bővítmény	FE
az iot hub device-identity children list	A hozzárendelt gyermekeszközök gyűjteményét adja ki.	Bővítmény	FE
az iot hub device-identity children remove	Gyermekeszközök eltávolítása a cél peremeszközről.	Bővítmény	FE
az iot hub device-identity connection-string	Az IoT-eszköz kapcsolati sztring kezelése.	Bővítmény	FE
az iot hub device-identity connection-string show	Adott IoT Hub-eszköz kapcsolati sztring megjelenítése.	Bővítmény	FE
az iot hub device-identity create	Hozzon létre egy eszközt egy IoT Hubon.	Bővítmény	FE
az iot hub device-identity delete	IoT Hub-eszköz törlése.	Bővítmény	FE
az iot hub device-identity export	Exportálja az összes eszközidentitást egy IoT Hubról egy Azure Storage-blobtárolóba.	Bővítmény	FE
az iot hub device-identity import	Eszközidentitások importálása egy IoT Hubra tárolótároló-blobból.	Bővítmény	FE
az iot hub device-identity list	Eszközök listázása egy IoT Hubon.	Bővítmény	FE
az iot hub device-identity parent	Az IoT-eszközök szülőeszköz-kapcsolatainak kezelése.	Bővítmény	FE
az iot hub device-identity parent set	Állítsa be a céleszköz szülőeszközét.	Bővítmény	FE
az iot hub device-identity parent show	A céleszköz szülőeszközének lekérése.	Bővítmény	FE
az iot hub device-identity renew-key	Újítsa meg egy IoT Hub-eszköz célkulcsait sas-hitelesítéssel.	Bővítmény	FE
az iot hub device-identity show	IoT Hub-eszköz adatainak lekérése.	Bővítmény	FE
az iot hub device-identity update	IoT Hub-eszköz frissítése.	Bővítmény	FE

az iot hub device-identity create

Hozzon létre egy eszközt egy IoT Hubon.

Ha a shared_private_key hitelesítési módszerét (más néven szimmetrikus kulcsokat) használja, ha nincs megadva egyéni kulcs, a szolgáltatás létrehozza őket az eszközhöz.

Ha egy peremeszközhöz eszközhatókört ad meg, a rendszer automatikusan szülőhatókörré alakítja az értéket.

az iot hub device-identity create --device-id
                                  [--am {shared_private_key, x509_ca, x509_thumbprint}]
                                  [--auth-type {key, login}]
                                  [--device-scope]
                                  [--edge-enabled {false, true}]
                                  [--hub-name]
                                  [--login]
                                  [--od]
                                  [--pk]
                                  [--primary-thumbprint]
                                  [--resource-group]
                                  [--secondary-key]
                                  [--secondary-thumbprint]
                                  [--sta {disabled, enabled}]
                                  [--star]
                                  [--valid-days]

Példák

Edge-kompatibilis IoT-eszköz létrehozása alapértelmezett hitelesítéssel (megosztott titkos kulcs).

az iot hub device-identity create -n {iothub_name} -d {device_id} --ee

Hozzon létre egy IoT-eszközt önaláírt tanúsítványengedélyekkel, hozzon létre egy 10 napig érvényes tanúsítványt, majd használja az ujjlenyomatát.

az iot hub device-identity create -n {iothub_name} -d {device_id} --am x509_thumbprint --valid-days 10

Hozzon létre egy IoT-eszközt önaláírt tanúsítványengedélyekkel, hozzon létre egy alapértelmezett lejárati tanúsítványt (365 nap), és kimenetet a célkönyvtárba.

az iot hub device-identity create -n {iothub_name} -d {device_id} --am x509_thumbprint --output-dir /path/to/output

Hozzon létre egy IoT-eszközt önaláírt tanúsítványengedélyekkel, és explicit módon adjon meg elsődleges és másodlagos ujjlenyomatokat.

az iot hub device-identity create -n {iothub_name} -d {device_id} --am x509_thumbprint --ptp {thumbprint_1} --stp {thumbprint_2}

Hozzon létre egy IoT-eszközt a legfelső szintű hitelesítésszolgáltatói engedéllyel letiltott állapottal és okkal.

az iot hub device-identity create -n {iothub_name} -d {device_id} --am x509_ca --status disabled --status-reason 'for reasons'

IoT-eszköz létrehozása eszközhatókörrel.

az iot hub device-identity create -n {iothub_name} -d {device_id} --device-scope 'ms-azure-iot-edge://edge0-123456789123456789'

Kötelező paraméterek

--device-id -d

Céleszköz-azonosító.

Opcionális paraméterek

--am --auth-method

Azzal az engedélyezési módszerrel kell létrehozni egy entitást.

elfogadott értékek: shared_private_key, x509_ca, x509_thumbprint

alapértelmezett érték: shared_private_key

--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

--device-scope

Az eszköz hatóköre. Peremeszközök esetén ez automatikusan generált és nem módosítható. Levéleszközök esetén állítsa be ezt gyermek-szülő kapcsolat létrehozásához.

--edge-enabled --ee

A peremhálózat engedélyezését jelző jelző.

elfogadott értékek: false, true

alapértelmezett érték: False

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

--od --output-dir

Hozzon létre önaláírt tanúsítványt, és használja az ujjlenyomatát. Kimenet a megadott célkönyvtárba.

--pk --primary-key

A base64 formátumban tárolt elsődleges szimmetrikus közös hozzáférési kulcs.

--primary-thumbprint --ptp

Önaláírt tanúsítvány ujjlenyomata az elsődleges ujjlenyomathoz.

--resource-group -g

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

--secondary-key --sk

A base64 formátumban tárolt másodlagos szimmetrikus közös hozzáférési kulcs.

--secondary-thumbprint --stp

A másodlagos ujjlenyomathoz használt önaláírt tanúsítvány ujjlenyomata.

--sta --status

Eszközállapot beállítása létrehozáskor.

elfogadott értékek: disabled, enabled

alapértelmezett érték: enabled

--star --status-reason

Az eszköz állapotának leírása.

--valid-days --vd

Hozzon létre önaláírt tanúsítványt, és használja az ujjlenyomatát. Megadott számú napra érvényes. Alapértelmezett: 365.

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 device-identity delete

IoT Hub-eszköz törlése.

az iot hub device-identity delete --device-id
                                  [--auth-type {key, login}]
                                  [--etag]
                                  [--hub-name]
                                  [--login]
                                  [--resource-group]

Kötelező paraméterek

--device-id -d

Céleszköz-azonosító.

Opcionális paraméterek

--auth-type

elfogadott értékek: key, login

alapértelmezett érték: key

--etag -e

Az erőforrás utolsó állapotának megfelelő etag vagy entitáscímke. Ha nincs megadva etag, a rendszer a "*" értéket használja.

--hub-name -n

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

--login -l

--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 device-identity export

Exportálja az összes eszközidentitást egy IoT Hubról egy Azure Storage-blobtárolóba.

Az eszközidentitásokat tartalmazó kimeneti blob egy "devices.txt" nevű szövegfájl.

Szükséges engedélyek – Vagy az IoT Hub megosztott hozzáférési szabályzata támogatja a "Beállításjegyzék olvasása & beállításjegyzék írása" vagy egy IoT Hub-adatszolgáltatói szerepkörrel rendelkező tagot az IoT Hubon.

A tárfiók neve és a blobtárolónév paraméterei csak akkor használhatók, ha a tárfiók ugyanabban az előfizetésben van, mint a bemeneti IoT Hub. Beágyazott blobtároló SAS uri bemenete esetén tekintse át a környezet bemeneti szabályait.

További információ: https://aka.ms/iothub-device-exportimport.

az iot hub device-identity export [--auth-type {key, login}]
                                  [--bc]
                                  [--bcu]
                                  [--hub-name]
                                  [--identity]
                                  [--ik {false, true}]
                                  [--login]
                                  [--resource-group]
                                  [--sa]

Példák

Exportálja az összes eszközidentitást egy konfigurált blobtárolóba, és tartalmazza az eszközkulcsokat. A blobtároló neve és a tárfiók neve paraméterként van megadva a parancshoz.

az iot hub device-identity export -n {iothub_name} --ik --bc {blob_container_name} --sa {storage_account_name}

Exportálja az összes eszközidentitást egy konfigurált blobtárolóba, és tartalmazza az eszközkulcsokat. Beágyazott SAS uri-példát használ.

az iot hub device-identity export -n {iothub_name} --ik --bcu 'https://mystorageaccount.blob.core.windows.net/devices?sv=2019-02-02&st=2020-08-23T22%3A35%3A00Z&se=2020-08-24T22%3A35%3A00Z&sr=c&sp=rwd&sig=VrmJ5sQtW3kLzYg10VqmALGCp4vtYKSLNjZDDJBSh9s%3D'

Exportálja az összes eszközidentitást egy konfigurált blobtárolóba az SAS uri-t tartalmazó fájl elérési útján.

az iot hub device-identity export -n {iothub_name} --bcu {sas_uri_filepath}

Exportálja az összes eszközidentitást egy konfigurált blobtárolóba, és tartalmazza az eszközkulcsokat. Olyan rendszer által hozzárendelt identitást használ, amely a tárfiókhoz tárolóblobadat-közreműködői szerepköröket használ. A blobtároló neve és a tárfiók neve paraméterként van megadva a parancshoz.

az iot hub device-identity export -n {iothub_name} --ik --bc {blob_container_name} --sa {storage_account_name} --identity [system]

az iot hub device-identity export -n {iothub_name} --ik --bcu 'https://mystorageaccount.blob.core.windows.net/devices' --identity [system]

Exportálja az összes eszközidentitást egy konfigurált blobtárolóba, és tartalmazza az eszközkulcsokat. Felhasználó által hozzárendelt felügyelt identitást használ, amely a tárfiókhoz tárolóblobadatok közreműködői szerepkörével rendelkezik. A blobtároló neve és a tárfiók neve paraméterként van megadva a parancshoz.

az iot hub device-identity export -n {iothub_name} --ik --bc {blob_container_name} --sa {storage_account_name} --identity {managed_identity_resource_id}

az iot hub device-identity export -n {iothub_name} --ik --bcu 'https://mystorageaccount.blob.core.windows.net/devices' --identity {managed_identity_resource_id}

Opcionális paraméterek

--auth-type

elfogadott értékek: key, login

alapértelmezett érték: key

--bc --blob-container

Ez a blobtároló az eszközidentitás-importálási feladat és az eredmények állapotának kimenetére szolgál. A paraméter figyelmen kívül lesz hagyva blob_container_uri megadásakor. Ehhez a blobtárolóhoz írási, olvasási és törlési hozzáférés szükséges.

--bcu --blob-container-uri

Blob megosztott hozzáférésű jogosultságkód URI írási, olvasási és törlési hozzáféréssel egy blobtárolóhoz. Ez a feladat és az eredmények állapotának kimenetére szolgál. Megjegyzés: Identitásalapú hitelesítés használata esetén továbbra is https:// URI-ra van szükség , de nincs szükség SAS-jogkivonatra. Az argumentum bemenete lehet beágyazott vagy fájl elérési útja.

--hub-name -n

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

--identity

Felügyelt identitástípus annak megállapításához, hogy a rendszer hozzárendelt felügyelt identitást vagy felhasználó által hozzárendelt felügyelt identitást használ-e. A rendszer által hozzárendelt felügyelt identitáshoz használja a [system] parancsot. A felhasználó által hozzárendelt felügyelt identitáshoz adja meg a felhasználó által hozzárendelt felügyelt identitás erőforrás-azonosítóját. Ehhez az identitáshoz tárolóblobadat-közreműködői szerepkörre van szükség a tárfiókhoz.

--ik --include-keys

Ha be van állítva, a kulcsok exportálása normál módon történik. Ellenkező esetben a kulcsok null értékre vannak állítva az exportálási kimenetben.

elfogadott értékek: false, true

alapértelmezett érték: False

--login -l

--resource-group -g

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

--sa --storage-account

A kimeneti blobtárolót tartalmazó Azure Storage-fiók neve. A paraméter figyelmen kívül lesz hagyva blob_container_uri megadásakor. Írási, olvasási és törlési hozzáférés szükséges.

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 device-identity import

Eszközidentitások importálása egy IoT Hubra tárolótároló-blobból.

Az eszközidentitásokat tartalmazó várt bemeneti fájl neve "devices.txt". A "importErrors.log" kimeneti naplófájl üres, ha az importálás sikeres, és importálási hiba esetén hibanaplókat tartalmaz.

További információ: https://aka.ms/iothub-device-exportimport.

az iot hub device-identity import [--auth-type {key, login}]
                                  [--hub-name]
                                  [--ibc]
                                  [--ibcu]
                                  [--identity]
                                  [--input-storage-account]
                                  [--login]
                                  [--obc]
                                  [--obcu]
                                  [--osa]
                                  [--resource-group]

Példák

Importálja az összes eszközidentitást egy blobból a bemeneti blobtároló és a tárfiók parancsparamétereinek, valamint a kimeneti blobtároló és a tárfiók parancsparamétereinek megadásával.

az iot hub device-identity import -n {iothub_name} --ibc {input_blob_container_name} --isa {input_storage_account_name} --obc {output_blob_container_name} --osa {output_storage_account_name}

Importálja az összes eszközidentitást egy blobból beágyazott SAS uri használatával.

az iot hub device-identity import -n {iothub_name} --ibcu {input_sas_uri} --obcu {output_sas_uri}

Importálja az összes eszközidentitást egy blobból egy SAS uri-t tartalmazó fájl elérési útján.

az iot hub device-identity import -n {iothub_name} --ibcu {input_sas_uri_filepath} --obcu {output_sas_uri_filepath}

Importálja az összes eszközidentitást egy blobból olyan rendszer által hozzárendelt identitással, amely mindkét tárfiókhoz tárolóblobadat-közreműködői szerepkörrel rendelkezik. A bemeneti blobtárolót és a tárfiókot, valamint a kimeneti blobtárolót és a tárfiókot paraméterként adja meg a parancs

az iot hub device-identity import -n {iothub_name} --ibc {input_blob_container_name} --isa {input_storage_account_name} --obc {output_blob_container_name} --osa {output_storage_account_name} --identity [system]

Importálja az összes eszközidentitást egy blobból olyan rendszer által hozzárendelt identitással, amely mindkét tárfiókhoz tárolóblobadat-közreműködői szerepkörrel rendelkezik. A blobtároló uri-nak nincs szüksége a blob SAS-jogkivonatra.

az iot hub device-identity import -n {iothub_name} --ibcu {input_sas_uri} --obcu {output_sas_uri} --identity [system]

Importálja az összes eszközidentitást egy blobból a felhasználó által hozzárendelt felügyelt identitással, amely mindkét tárfiókhoz tárolóblobadat-közreműködői szerepkörrel rendelkezik. A bemeneti blobtárolót és a tárfiókot, valamint a kimeneti blobtárolót és a tárfiókot paraméterként adja meg a parancs

az iot hub device-identity import -n {iothub_name} --ibc {input_blob_container_name} --isa {input_storage_account_name} --obc {output_blob_container_name} --osa {output_storage_account_name} --identity {managed_identity_resource_id}

Importálja az összes eszközidentitást egy blobból a felhasználó által hozzárendelt felügyelt identitással, amely mindkét tárfiókhoz tárolóblobadat-közreműködői szerepkörrel rendelkezik. A blobtároló uri-nak nincs szüksége a blob SAS-jogkivonatra.

az iot hub device-identity import -n {iothub_name} --ibcu {input_sas_uri} --obcu {output_sas_uri} --identity {managed_identity_resource_id}

Opcionális paraméterek

--auth-type

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.

--ibc --input-blob-container

Ez a blobtároló tárolja azt a fájlt, amely meghatározza az identitásjegyzékben végrehajtandó műveleteket. A paraméter figyelmen kívül lesz hagyva input_blob_container_uri megadásakor. Olvasási hozzáférés szükséges ehhez a blobtárolóhoz.

--ibcu --input-blob-container-uri

Blob megosztott hozzáférésű jogosultságkód URI-ja egy blobtároló olvasási hozzáférésével. Ez a blob tartalmazza az identitásjegyzékben végrehajtandó műveleteket. Megjegyzés: Identitásalapú hitelesítés használata esetén továbbra is https:// URI-ra van szükség , de nincs szükség SAS-jogkivonatra. Az argumentum bemenete lehet beágyazott vagy fájl elérési útja.

--identity

--input-storage-account --isa

A bemeneti blobtárolót tartalmazó Azure Storage-fiók neve. Csak akkor szükséges, ha input_blob_container_uri nincs megadva. Olvasási hozzáférés szükséges.

--login -l

--obc --output-blob-container

Ez a blobtároló az eszközidentitás-importálási feladat és az eredmények állapotának kimenetére szolgál. Csak akkor szükséges, ha input_blob_container_uri nincs megadva. Ehhez a blobtárolóhoz írási hozzáférés szükséges.

--obcu --output-blob-container-uri

Blob megosztott hozzáférésű jogosultságkód URI egy blobtároló írási hozzáférésével. Ez a feladat és az eredmények állapotának kimenetére szolgál. Megjegyzés: Identitásalapú hitelesítés használatakor továbbra is szükség van egy https:// SAS-jogkivonat nélküli URI-ra. Az argumentum bemenete lehet beágyazott vagy fájl elérési útja.

--osa --output-storage-account

A kimeneti blobtárolót tartalmazó Azure Storage-fiók neve. A paraméter figyelmen kívül lesz hagyva output_blob_container_uri megadásakor. Írási hozzáférés szükséges.

--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 device-identity list

Eszközök listázása egy IoT Hubon.

Ez a parancs a parancs aliasa az iot hub device-twin list, amely erősen ajánlott ezen a parancson keresztül. A jövőben ez az iot hub device-identity list a parancs módosítható vagy elavult lehet.

az iot hub device-identity list [--auth-type {key, login}]
                                [--edge-enabled {false, true}]
                                [--hub-name]
                                [--login]
                                [--resource-group]
                                [--top]

Opcionális paraméterek

--auth-type

elfogadott értékek: key, login

alapértelmezett érték: key

--edge-enabled --ee

A peremhálózat engedélyezését jelző jelző.

elfogadott értékek: false, true

alapértelmezett érték: False

--hub-name -n

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

--login -l

--resource-group -g

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

--top

A visszaadandó elemek maximális száma. Használja a -1-et korlátlanul.

alapértelmezett érték: 1000

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 device-identity renew-key

Újítsa meg egy IoT Hub-eszköz célkulcsait sas-hitelesítéssel.

az iot hub device-identity renew-key --device-id
                                     --hub-name
                                     --key-type {primary, secondary, swap}
                                     [--auth-type {key, login}]
                                     [--etag]
                                     [--login]
                                     [--resource-group]

Példák

Újítsa meg az elsődleges kulcsot.

az iot hub device-identity renew-key -d {device_id} -n {iothub_name} --kt primary

Cserélje le az elsődleges és másodlagos kulcsokat.

az iot hub device-identity renew-key -d {device_id} -n {iothub_name} --kt swap

Kötelező paraméterek

--device-id -d

Céleszköz-azonosító.

--hub-name -n

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

--key-type --kt

Újragenerálandó célkulcstípus.

elfogadott értékek: primary, secondary, swap

Opcionális paraméterek

--auth-type

elfogadott értékek: key, login

alapértelmezett érték: key

--etag -e

Az erőforrás utolsó állapotának megfelelő etag vagy entitáscímke. Ha nincs megadva etag, a rendszer a "*" értéket használja.

--login -l

--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 device-identity show

IoT Hub-eszköz adatainak lekérése.

az iot hub device-identity show --device-id
                                [--auth-type {key, login}]
                                [--hub-name]
                                [--login]
                                [--resource-group]

Kötelező paraméterek

--device-id -d

Céleszköz-azonosító.

Opcionális paraméterek

--auth-type

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

--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 device-identity update

IoT Hub-eszköz frissítése.

Az eszköz frissítéséhez használja a --set, majd a tulajdonsághozzárendeléseket. Használja ki az "iot hub device-identity show"-ból visszaadott paramétereket.

az iot hub device-identity update --device-id
                                  [--add]
                                  [--am {shared_private_key, x509_ca, x509_thumbprint}]
                                  [--auth-type {key, login}]
                                  [--edge-enabled {false, true}]
                                  [--etag]
                                  [--force-string]
                                  [--hub-name]
                                  [--login]
                                  [--pk]
                                  [--primary-thumbprint]
                                  [--remove]
                                  [--resource-group]
                                  [--secondary-key]
                                  [--secondary-thumbprint]
                                  [--set]
                                  [--sta {disabled, enabled}]
                                  [--star]

Példák

Az eszköz peremhálózati képességeinek bekapcsolása

az iot hub device-identity update -d {device_id} -n {iothub_name} --set capabilities.iotEdge=true

Kapcsolja be az eszköz peremhálózati képességeit a kényelmi argumentum használatával.

az iot hub device-identity update -d {device_id} -n {iothub_name} --ee

Eszköz állapotának letiltása

az iot hub device-identity update -d {device_id} -n {iothub_name} --set status=disabled

Tiltsa le az eszköz állapotát a kényelmi argumentum használatával.

az iot hub device-identity update -d {device_id} -n {iothub_name} --status disabled

Egy parancsban

az iot hub device-identity update -d {device_id} -n {iothub_name} --set status=disabled capabilities.iotEdge=true

Kötelező paraméterek

--device-id -d

Céleszköz-azonosító.

Opcionális paraméterek

--add

Adjon hozzá egy objektumot az objektumok listájához egy elérési út és egy kulcsértékpár megadásával. Példa: --add property.listProperty <key=value, string or JSON string>

alapértelmezett érték: []

--am --auth-method

Azzal az engedélyezési módszerrel kell létrehozni egy entitást.

elfogadott értékek: shared_private_key, x509_ca, x509_thumbprint

--auth-type

elfogadott értékek: key, login

alapértelmezett érték: key

--edge-enabled --ee

A peremhálózat engedélyezését jelző jelző.

elfogadott értékek: false, true

--etag -e

Az erőforrás utolsó állapotának megfelelő etag vagy entitáscímke. Ha nincs megadva etag, a rendszer a "*" értéket használja.

--force-string

A "set" vagy a "add" használata esetén a JSON-ra való konvertálás helyett őrizze meg a sztringkonstansokat.

alapértelmezett érték: False

--hub-name -n

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

--login -l

--pk --primary-key

A base64 formátumban tárolt elsődleges szimmetrikus közös hozzáférési kulcs.

--primary-thumbprint --ptp

Önaláírt tanúsítvány ujjlenyomata az elsődleges ujjlenyomathoz.

--remove

Tulajdonság vagy elem eltávolítása a listából. Példa: --remove property.list <indexToRemove> VAGY --remove propertyToRemove.

alapértelmezett érték: []

--resource-group -g

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

--secondary-key --sk

A base64 formátumban tárolt másodlagos szimmetrikus közös hozzáférési kulcs.

--secondary-thumbprint --stp

A másodlagos ujjlenyomathoz használt önaláírt tanúsítvány ujjlenyomata.

--set

Frissítsen egy objektumot egy beállítandó tulajdonság elérési útjának és értékének megadásával. Példa: --set property1.property2=<value>

alapértelmezett érték: []

--sta --status

Eszközállapot beállítása létrehozáskor.

elfogadott értékek: disabled, enabled

--star --status-reason

Az eszköz állapotának leírása.

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 device-identity

Parancsok

az iot hub device-identity create

Példák

Kötelező paraméterek

Opcionális paraméterek

az iot hub device-identity delete

Kötelező paraméterek

Opcionális paraméterek

az iot hub device-identity export

Példák

Opcionális paraméterek

az iot hub device-identity import

Példák

Opcionális paraméterek

az iot hub device-identity list

Opcionális paraméterek

az iot hub device-identity renew-key

Példák

Kötelező paraméterek

Opcionális paraméterek

az iot hub device-identity show

Kötelező paraméterek

Opcionális paraméterek

az iot hub device-identity update

Példák

Kötelező paraméterek

Opcionális paraméterek

Visszajelzés

További források