az iot hub device-identity

Kommandon

Name	Description	Typ	Status
az iot hub device-identity children	Hantera underordnade enhetsrelationer för IoT Edge-enheter.	Extension	GA
az iot hub device-identity children add	Lägg till enheter som underordnade till en målgränsenhet.	Extension	GA
az iot hub device-identity children list	Matar ut samlingen med tilldelade underordnade enheter.	Extension	GA
az iot hub device-identity children remove	Ta bort underordnade enheter från en målgränsenhet.	Extension	GA
az iot hub device-identity connection-string	Hantera IoT-enhetens anslutningssträng.	Extension	GA
az iot hub device-identity connection-string show	Visa en viss IoT Hub-enhet anslutningssträng.	Extension	GA
az iot hub device-identity create	Skapa en enhet i en IoT Hub.	Extension	GA
az iot hub device-identity delete	Ta bort en IoT Hub-enhet.	Extension	GA
az iot hub device-identity export	Exportera alla enhetsidentiteter från en IoT Hub till en Azure Storage-blobcontainer.	Extension	GA
az iot hub device-identity import	Importera enhetsidentiteter till en IoT Hub från en lagringscontainerblob.	Extension	GA
az iot hub device-identity list	Lista enheter i en IoT Hub.	Extension	GA
az iot hub device-identity parent	Hantera överordnade enhetsrelationer för IoT-enheter.	Extension	GA
az iot hub device-identity parent set	Ange den överordnade enheten för en målenhet.	Extension	GA
az iot hub device-identity parent show	Hämta den överordnade enheten för en målenhet.	Extension	GA
az iot hub device-identity renew-key	Förnya målnycklarna för IoT Hub-enheter med sas-autentisering.	Extension	GA
az iot hub device-identity show	Hämta information om en IoT Hub-enhet.	Extension	GA
az iot hub device-identity update	Uppdatera en IoT Hub-enhet.	Extension	GA

az iot hub device-identity create --device-id
                                  [--am --auth-method {shared_private_key, x509_ca, x509_thumbprint}]
                                  [--auth-type {key, login}]
                                  [--device-scope]
                                  [--edge-enabled --ee {false, true}]
                                  [--hub-name]
                                  [--login]
                                  [--od --output-dir]
                                  [--pk --primary-key]
                                  [--primary-thumbprint --ptp]
                                  [--resource-group]
                                  [--secondary-key --sk]
                                  [--secondary-thumbprint --stp]
                                  [--sta --status {disabled, enabled}]
                                  [--star --status-reason]
                                  [--valid-days --vd]

Exempel

Skapa en edge-aktiverad IoT-enhet med standardauktorisering (delad privat nyckel).

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

Skapa en IoT-enhet med självsignerad certifikatauktorisering, generera ett certifikat som är giltigt i 10 dagar och använd sedan tumavtrycket.

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

Skapa en IoT-enhet med självsignerad certifikatauktorisering, generera ett certifikat för standardförfallotid (365 dagar) och utdata till målkatalogen.

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

Skapa en IoT-enhet med självsignerad certifikatauktorisering och ange explicit primära och sekundära tumavtryck.

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

Skapa en IoT-enhet med rotcertifikatutfärdarauktorisering med inaktiverad status och orsak.

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

Skapa en IoT-enhet med ett enhetsomfång.

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

Obligatoriska parametrar

Valfria parametrar

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

Globala parametrar

--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap	Värde
Standardvärde:	False

--output -o

Utdataformat.

Egenskap	Värde
Standardvärde:	json
Godkända värden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

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

Obligatoriska parametrar

Valfria parametrar

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

Globala parametrar

--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap	Värde
Standardvärde:	False

--output -o

Utdataformat.

Egenskap	Värde
Standardvärde:	json
Godkända värden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

az iot hub device-identity export [--auth-type {key, login}]
                                  [--bc --blob-container]
                                  [--bcu --blob-container-uri]
                                  [--hub-name]
                                  [--identity]
                                  [--ik --include-keys {false, true}]
                                  [--login]
                                  [--resource-group]
                                  [--sa --storage-account]

Exempel

Exportera alla enhetsidentiteter till en konfigurerad blobcontainer och inkludera enhetsnycklar. Namnet på blobcontainern och lagringskontot anges som parametrar för kommandot.

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

Exportera alla enhetsidentiteter till en konfigurerad blobcontainer och inkludera enhetsnycklar. Använder ett infogat SAS-uri-exempel.

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'

Exportera alla enhetsidentiteter till en konfigurerad blobcontainer med hjälp av en filsökväg som innehåller SAS-URI:n.

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

Exportera alla enhetsidentiteter till en konfigurerad blobcontainer och inkludera enhetsnycklar. Använder systemtilldelad identitet som har rollerna Storage Blob Data Contributor för lagringskontot. Namnet på blobcontainern och lagringskontot anges som parametrar för kommandot.

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

Exportera alla enhetsidentiteter till en konfigurerad blobcontainer och inkludera enhetsnycklar. Använder systemtilldelad identitet som har rollerna Storage Blob Data Contributor för lagringskontot. Blobcontainer-URI:n behöver inte blob-SAS-token.

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

Exportera alla enhetsidentiteter till en konfigurerad blobcontainer och inkludera enhetsnycklar. Använder användartilldelad hanterad identitet som har rollen Storage Blob Data Contributor för lagringskontot. Namnet på blobcontainern och lagringskontot anges som parametrar för kommandot.

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

Exportera alla enhetsidentiteter till en konfigurerad blobcontainer och inkludera enhetsnycklar. Använder användartilldelad hanterad identitet som har rollen Storage Blob Data Contributor för lagringskontot. Blobcontainer-URI:n behöver inte blob-SAS-token.

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

Valfria parametrar

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

Globala parametrar

--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap	Värde
Standardvärde:	False

--output -o

Utdataformat.

Egenskap	Värde
Standardvärde:	json
Godkända värden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

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

Exempel

Importera alla enhetsidentiteter från en blob genom att ange kommandoparametrar för indatablobcontainer och lagringskonto samt utdatablobcontainer och lagringskonto.

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}

Importera alla enhetsidentiteter från en blob med hjälp av en infogad SAS-uri.

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

Importera alla enhetsidentiteter från en blob med hjälp av en filsökväg som innehåller SAS-URI.

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

Importera alla enhetsidentiteter från en blob med hjälp av systemtilldelad identitet som har rollerna Storage Blob Data Contributor för båda lagringskontona. Indatablobcontainern och lagringskontot samt utdatablobcontainern och lagringskontot tillhandahålls som parametrar till kommandot

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]

Importera alla enhetsidentiteter från en blob med hjälp av systemtilldelad identitet som har rollerna Storage Blob Data Contributor för båda lagringskontona. Blobcontainer-URI:n behöver inte blob-SAS-token.

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

Importera alla enhetsidentiteter från en blob med användartilldelad hanterad identitet som har rollerna Storage Blob Data Contributor för båda lagringskontona. Indatablobcontainern och lagringskontot samt utdatablobcontainern och lagringskontot tillhandahålls som parametrar till kommandot

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}

Importera alla enhetsidentiteter från en blob med användartilldelad hanterad identitet som har rollerna Storage Blob Data Contributor för båda lagringskontona. Blobcontainer-URI:n behöver inte blob-SAS-token.

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

Valfria parametrar

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

Globala parametrar

--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap	Värde
Standardvärde:	False

--output -o

Utdataformat.

Egenskap	Värde
Standardvärde:	json
Godkända värden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

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

Valfria parametrar

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

Globala parametrar

--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap	Värde
Standardvärde:	False

--output -o

Utdataformat.

Egenskap	Värde
Standardvärde:	json
Godkända värden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

az iot hub device-identity renew-key --device-id
                                     --hub-name
                                     --key-type --kt {both, primary, secondary, swap}
                                     [--auth-type {key, login}]
                                     [--etag]
                                     [--im --include-modules {false, true}]
                                     [--login]
                                     [--no-progress {false, true}]
                                     [--resource-group]

Exempel

Förnya primärnyckeln.

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

Växla de primära och sekundära nycklarna.

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

Förnya den sekundära nyckeln för två enheter och deras moduler.

az iot hub device-identity renew-key -d {device_id} {device_id} -n {iothub_name} --kt secondary --include-modules

Förnya båda nycklarna för alla enheter i hubben.

az iot hub device-identity renew-key -d * -n {iothub_name} --kt both

Obligatoriska parametrar

Valfria parametrar

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

Globala parametrar

--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap	Värde
Standardvärde:	False

--output -o

Utdataformat.

Egenskap	Värde
Standardvärde:	json
Godkända värden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

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

Obligatoriska parametrar

Valfria parametrar

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

Globala parametrar

--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap	Värde
Standardvärde:	False

--output -o

Utdataformat.

Egenskap	Värde
Standardvärde:	json
Godkända värden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

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

Exempel

Aktivera gränsfunktioner för enheten

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

Aktivera gränsfunktioner för enheten med hjälp av bekvämlighetsargument.

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

Inaktivera enhetsstatus

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

Inaktivera enhetsstatus med hjälp av bekvämlighetsargument.

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

I ett kommando

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

Obligatoriska parametrar

Valfria parametrar

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

Globala parametrar

--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap	Värde
Standardvärde:	False

--output -o

Utdataformat.

Egenskap	Värde
Standardvärde:	json
Godkända värden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap	Värde
Standardvärde:	False