az iot hub device-identity

Megjegyzés

Ez a hivatkozás az Azure CLI Azure-iot bővítményének része (2.30.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

az iot hub device-identity children	Gyermekek IoT Edge-eszközökhöz tartozó eszközkapcsolatainak kezelése.
az iot hub device-identity children add	Eszközök hozzáadása gyermekként a cél peremeszközhöz.
az iot hub device-identity children list	A hozzárendelt gyermekeszközök gyűjteményének kimenete.
az iot hub device-identity children remove	Gyermekeszközök eltávolítása a cél peremeszközről.
az iot hub device-identity connection-string	IoT-eszköz kapcsolati sztring kezelése.
az iot hub device-identity connection-string show	Adott IoT Hub eszköz kapcsolati sztring megjelenítése.
az iot hub device-identity create	Eszköz létrehozása egy IoT Hub.
az iot hub device-identity delete	Töröljön egy IoT Hub eszközt.
az iot hub device-identity export	Az összes eszközidentitás exportálása egy IoT Hub egy Azure Storage-blobtárolóba. Beágyazott blobtároló SAS URI-bemenete esetén tekintse át a környezet bemeneti szabályait.
az iot hub device-identity import	Eszközidentitások importálása IoT Hub blobból. Beágyazott blobtároló SAS URI-bemenete esetén tekintse át a környezet bemeneti szabályait.
az iot hub device-identity list	Eszközök listázása egy IoT Hub.
az iot hub device-identity parent	Az IoT-eszközök szülőeszköz-kapcsolatainak kezelése.
az iot hub device-identity parent set	Állítsa be a céleszköz szülőeszközét.
az iot hub device-identity parent show	A céleszköz szülőeszközének lekérése.
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 show	Lekérheti egy IoT Hub eszköz adatait.
az iot hub device-identity update	Frissítsen egy IoT Hub eszközt.

az iot hub device-identity create

Eszköz létrehozása egy IoT Hub.

A shared_private_key hitelesítési módszerének (más néven szimmetrikus kulcsok) használatakor, ha nincs megadva egyéni kulcs, a szolgáltatás létrehozza azokat az eszközhöz.

Ha egy peremeszközhöz eszközhatókör van megadva, az érték automatikusan szülőhatókörré lesz konvertálva.

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ány-hitelesítéssel, 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ány-hitelesítéssel, hozzon létre egy tanúsítványt az alapértelmezett lejáratról (365 nap), és adja meg a kimenetet a célkönyvtárban.

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ány-hitelesítéssel, és explicit módon biztosítson 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 legfelső szintű hitelesítésszolgáltatói hitelesítésszolgáltatóval, letiltott állapottal és okokkal.

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

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

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.

Opcionális paraméterek

--am --auth-method

Az az engedélyezési módszer, amellyel az entitást létre kell hozni.

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. Az alapértelmezett beállításokat a használatával 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 létrejövő és nem módosítható. Levéleszközök esetén állítsa be úgy, hogy gyermek-szülő kapcsolatot hozzon létre.

--edge-enabled --ee

Az él engedélyezését jelző jelző.

elfogadott értékek: false, true

--hub-name -n

IoT Hub nevet. Kötelező, ha a --login nincs megadva.

--login -l

Ez a parancs olyan entitásokat támogat, kapcsolati sztring műveletek végrehajtásához szükséges jogosultságokkal. Az "az login" használatával történő munkamenet-bejelentkezés elkerülésére használható. Ha egy entitás kapcsolati sztring és név is meg van adva, a kapcsolati sztring prioritást élvez. Kötelező, ha a --hub-name nincs megadva.

--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 a használatával az configure --defaults group=<name>konfigurálhatja.

--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álandó ö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ú napig é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.

--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 a használatával az account set -s NAME_OR_IDkonfigurálhatja.

--verbose

Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az iot hub device-identity delete

Töröljön egy IoT Hub eszközt.

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.

Opcionális paraméterek

--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. Az alapértelmezett beállításokat a használatával az configure --defaults iothub-data-auth-type=<auth-type-value>konfigurálhatja.

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 nevet. Kötelező, ha a --login nincs megadva.

--login -l

Ez a parancs olyan entitásokat támogat, kapcsolati sztring műveletek végrehajtásához szükséges jogosultságokkal. Az "az login" használatával történő munkamenet-bejelentkezés elkerülésére használható. Ha egy entitás kapcsolati sztring és név is meg van adva, a kapcsolati sztring prioritást élvez. Kötelező, ha a --hub-name nincs megadva.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot a használatával az configure --defaults group=<name>konfigurálhatja.

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.

--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 a használatával az account set -s NAME_OR_IDkonfigurálhatja.

--verbose

Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az iot hub device-identity export

Az összes eszközidentitás exportálása egy IoT Hub egy Azure Storage-blobtárolóba. Beágyazott blobtároló SAS URI-bemenete esetén tekintse át a környezet bemeneti szabályait.

További információ: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-identity-registry#import-and-export-device-identities.

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

Példák

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 egy SAS URI-t tartalmazó fájlelérési úttal.

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. Rendszer által hozzárendelt identitást használ, amely a tárfiókhoz storage blobadatok közreműködői szerepkörével rendelkezik. A blobtároló URI-jának nincs szüksége a blob SAS-jogkivonatára.

az iot hub device-identity export -n {iothub_name} --ik --bcu 'https://mystorageaccount.blob.core.windows.net/devices' --auth-type identity --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 tárolóblobadatok közreműködői szerepkörével rendelkezik a tárfiókhoz és az IoT Hub közreműködőihez. A blobtároló URI-jának nincs szüksége a blob SAS-jogkivonatára.

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

Kötelező paraméterek

--bcu --blob-container-uri

Blob közös hozzáférésű jogosultságkód URI egy blobtároló írási, olvasási és törlé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á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ájlelérési út.

--hub-name -n

IoT Hub nevet. Kötelező, ha a --login nincs megadva.

Opcionális paraméterek

--auth-type --storage-authentication-type

A tárolóval való kommunikáció hitelesítési típusa.

elfogadott értékek: identity, key

--identity

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

--ik --include-keys

Ha be van állítva, a kulcsok exportálása a szokásos 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

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot a használatával az configure --defaults group=<name>konfigurálhatja.

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.

--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 a használatával az account set -s NAME_OR_IDkonfigurálhatja.

--verbose

Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az iot hub device-identity import

Eszközidentitások importálása IoT Hub blobból. Beágyazott blobtároló SAS URI-bemenete esetén tekintse át a környezet bemeneti szabályait.

További információ: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-identity-registry#import-and-export-device-identities.

az iot hub device-identity import --hub-name
                                  --ibcu
                                  --obcu
                                  [--auth-type {identity, key}]
                                  [--identity]
                                  [--resource-group]

Példák

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ájlelérési úttal.

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óblobadatok közreműködői szerepkörrel rendelkezik. A blobtároló URI-jának nincs szüksége a blob SAS-jogkivonatára.

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

Importálja az összes eszközidentitást egy blobból olyan felhasználó által hozzárendelt felügyelt identitással, amely storage-blobadatok közreműködői szerepkörrel rendelkezik a tárfiókokhoz és az IoT Hub közreműködőihez is. A blobtároló URI-jának nincs szüksége a blob SAS-jogkivonatára.

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

Kötelező paraméterek

--hub-name -n

IoT Hub nevet. Kötelező, ha a --login nincs megadva.

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

Blob közös hozzáférésű jogosultságkód URI-ja, amely olvasási hozzáféréssel rendelkezik egy blobtárolóhoz. 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ájlelérési út.

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

Blob közös hozzáférésű jogosultságkód URI-ja írá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álatakor továbbra is szükség van egy https:// URI-ra sas-jogkivonat nélkül. Az argumentum bemenete lehet beágyazott vagy fájlelérési út.

Opcionális paraméterek

--auth-type --storage-authentication-type

A tárolóval való kommunikáció hitelesítési típusa.

elfogadott értékek: identity, key

--identity

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

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot a használatával az configure --defaults group=<name>konfigurálhatja.

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.

--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 a használatával az account set -s NAME_OR_IDkonfigurálhatja.

--verbose

Növelje a naplózás részletességét. 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 Hub.

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

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. Az alapértelmezett beállításokat a használatával az configure --defaults iothub-data-auth-type=<auth-type-value>konfigurálhatja.

elfogadott értékek: key, login

alapértelmezett érték: key

--edge-enabled --ee

Az él engedélyezését jelző jelző.

elfogadott értékek: false, true

--hub-name -n

IoT Hub nevet. Kötelező, ha a --login nincs megadva.

--login -l

Ez a parancs olyan entitásokat támogat, kapcsolati sztring műveletek végrehajtásához szükséges jogosultságokkal. Az "az login" használatával történő munkamenet-bejelentkezés elkerülésére használható. Ha egy entitás kapcsolati sztring és név is meg van adva, a kapcsolati sztring prioritást élvez. Kötelező, ha a --hub-name nincs megadva.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot a használatával az configure --defaults group=<name>konfigurálhatja.

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

--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 a használatával az account set -s NAME_OR_IDkonfigurálhatja.

--verbose

Növelje a naplózás részletességét. 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.

--hub-name -n

IoT Hub nevet. Kötelező, ha a --login nincs megadva.

--key-type --kt

Az újragenerálandó célkulcs típusa.

elfogadott értékek: primary, secondary, swap

Opcionális paraméterek

--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. Az alapértelmezett beállításokat a használatával az configure --defaults iothub-data-auth-type=<auth-type-value>konfigurálhatja.

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

Ez a parancs olyan entitásokat támogat, kapcsolati sztring műveletek végrehajtásához szükséges jogosultságokkal. Az "az login" használatával történő munkamenet-bejelentkezés elkerülésére használható. Ha egy entitás kapcsolati sztring és név is meg van adva, a kapcsolati sztring prioritást élvez. Kötelező, ha a --hub-name nincs megadva.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot a használatával az configure --defaults group=<name>konfigurálhatja.

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.

--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 a használatával az account set -s NAME_OR_IDkonfigurálhatja.

--verbose

Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az iot hub device-identity show

Lekérheti egy IoT Hub eszköz adatait.

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.

Opcionális paraméterek

--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. Az alapértelmezett beállításokat a használatával 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 nevet. Kötelező, ha a --login nincs megadva.

--login -l

Ez a parancs olyan entitásokat támogat, kapcsolati sztring műveletek végrehajtásához szükséges jogosultságokkal. Az "az login" használatával történő munkamenet-bejelentkezés elkerülésére használható. Ha egy entitás kapcsolati sztring és név is meg van adva, a kapcsolati sztring prioritást élvez. Kötelező, ha a --hub-name nincs megadva.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot a használatával az configure --defaults group=<name>konfigurálhatja.

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.

--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 a használatával az account set -s NAME_OR_IDkonfigurálhatja.

--verbose

Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az iot hub device-identity update

Frissítsen egy IoT Hub eszközt.

Az eszköz frissítéséhez használja a --set és a tulajdonság-hozzárendeléseket. Használja ki az "iot hub device-identity show" által 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

Peremhálózati képességek bekapcsolása az eszközhöz

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

A peremhálózati képességek bekapcsolása az eszközhöz az egyszerűség argumentumával.

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

Eszközállapot 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 paranccsal

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.

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 vagy JSON string>.

--am --auth-method

Az az engedélyezési módszer, amellyel az entitást létre kell hozni.

elfogadott értékek: shared_private_key, x509_ca, x509_thumbprint

--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. Az alapértelmezett beállításokat a használatával az configure --defaults iothub-data-auth-type=<auth-type-value>konfigurálhatja.

elfogadott értékek: key, login

alapértelmezett érték: key

--edge-enabled --ee

Az él 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 az "add" használatakor őrizze meg a sztringkonstansokat ahelyett, hogy JSON-ra próbálnál konvertálni.

--hub-name -n

IoT Hub nevet. Kötelező, ha a --login nincs megadva.

--login -l

Ez a parancs olyan entitásokat támogat, kapcsolati sztring műveletek végrehajtásához szükséges jogosultságokkal. Az "az login" használatával történő munkamenet-bejelentkezés elkerülésére használható. Ha egy entitás kapcsolati sztring és név is meg van adva, a kapcsolati sztring prioritást élvez. Kötelező, ha a --hub-name nincs megadva.

--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 egy listából. Példa: --remove property.list OR --remove propertyToRemove.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot a használatával az configure --defaults group=<name>konfigurálhatja.

--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álandó önaláírt tanúsítvány ujjlenyomata.

--set

Objektum frissítése a beállítandó tulajdonság elérési útjának és értékének megadásával. Példa: --set property1.property2=.

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

--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 a használatával az account set -s NAME_OR_IDkonfigurálhatja.

--verbose

Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.