az iot hub device-identity

Opdracht

Name	Description	Type	Status
az iot hub device-identity children	Onderliggende apparaatrelaties voor IoT Edge-apparaten beheren.	Extension	GA
az iot hub device-identity children add	Voeg apparaten toe als onderliggende elementen aan een edge-doelapparaat.	Extension	GA
az iot hub device-identity children list	Hiermee wordt de verzameling toegewezen onderliggende apparaten uitgevoerd.	Extension	GA
az iot hub device-identity children remove	Onderliggende apparaten verwijderen van een doelrandapparaat.	Extension	GA
az iot hub device-identity connection-string	Beheer de verbindingsreeks van het IoT-apparaat.	Extension	GA
az iot hub device-identity connection-string show	Een bepaald IoT Hub-apparaat weergeven verbindingsreeks.	Extension	GA
az iot hub device-identity create	Maak een apparaat in een IoT Hub.	Extension	GA
az iot hub device-identity delete	Een IoT Hub-apparaat verwijderen.	Extension	GA
az iot hub device-identity export	Exporteer alle apparaat-id's van een IoT Hub naar een Azure Storage-blobcontainer.	Extension	GA
az iot hub device-identity import	Apparaat-id's importeren in een IoT Hub vanuit een opslagcontainer-blob.	Extension	GA
az iot hub device-identity list	Apparaten weergeven in een IoT Hub.	Extension	GA
az iot hub device-identity parent	Relaties tussen bovenliggende apparaten voor IoT-apparaten beheren.	Extension	GA
az iot hub device-identity parent set	Stel het bovenliggende apparaat van een doelapparaat in.	Extension	GA
az iot hub device-identity parent show	Haal het bovenliggende apparaat van een doelapparaat op.	Extension	GA
az iot hub device-identity renew-key	Vernieuw doelsleutels van IoT Hub-apparaten met SAS-verificatie.	Extension	GA
az iot hub device-identity show	De details van een IoT Hub-apparaat ophalen.	Extension	GA
az iot hub device-identity update	Een IoT Hub-apparaat bijwerken.	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]

Voorbeelden

Een IoT-apparaat met edge maken met standaardautorisatie (gedeelde persoonlijke sleutel).

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

Maak een IoT-apparaat met zelfondertekende certificaatautorisatie, genereer een certificaat dat 10 dagen geldig is en gebruik vervolgens de vingerafdruk.

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

Maak een IoT-apparaat met zelfondertekende certificaatautorisatie, genereer een standaardverloopcertificaat (365 dagen) en uitvoer naar de doelmap.

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

Maak een IoT-apparaat met zelfondertekende certificaatautorisatie en geef expliciet primaire en secundaire vingerafdrukken op.

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

Maak een IoT-apparaat met ca-basisautorisatie met uitgeschakelde status en reden.

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

Maak een IoT-apparaat met een apparaatbereik.

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

Vereiste parameters

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Uitvoerindeling.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap	Waarde
Default value:	False

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

Vereiste parameters

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Uitvoerindeling.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap	Waarde
Default value:	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]

Voorbeelden

Exporteer alle apparaat-id's naar een geconfigureerde blobcontainer en neem apparaatsleutels op. De naam van de blobcontainer en de naam van het opslagaccount worden opgegeven als parameters voor de opdracht.

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

Exporteer alle apparaat-id's naar een geconfigureerde blobcontainer en neem apparaatsleutels op. Maakt gebruik van een inline SAS-URI-voorbeeld.

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'

Exporteer alle apparaat-id's naar een geconfigureerde blobcontainer met behulp van een bestandspad dat de SAS-URI bevat.

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

Exporteer alle apparaat-id's naar een geconfigureerde blobcontainer en neem apparaatsleutels op. Maakt gebruik van door het systeem toegewezen identiteit met de rol Inzender voor opslagblobgegevens voor het opslagaccount. De naam van de blobcontainer en de naam van het opslagaccount worden opgegeven als parameters voor de opdracht.

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

Exporteer alle apparaat-id's naar een geconfigureerde blobcontainer en neem apparaatsleutels op. Maakt gebruik van door het systeem toegewezen identiteit met de rol Inzender voor opslagblobgegevens voor het opslagaccount. De blobcontainer-URI heeft het SAS-token voor de blob niet nodig.

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

Exporteer alle apparaat-id's naar een geconfigureerde blobcontainer en neem apparaatsleutels op. Maakt gebruik van door de gebruiker toegewezen beheerde identiteit met de rol Inzender voor opslagblobgegevens voor het opslagaccount. De naam van de blobcontainer en de naam van het opslagaccount worden opgegeven als parameters voor de opdracht.

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

Exporteer alle apparaat-id's naar een geconfigureerde blobcontainer en neem apparaatsleutels op. Maakt gebruik van door de gebruiker toegewezen beheerde identiteit met de rol Inzender voor opslagblobgegevens voor het opslagaccount. De blobcontainer-URI heeft het SAS-token voor de blob niet nodig.

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

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Uitvoerindeling.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap	Waarde
Default value:	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]

Voorbeelden

Importeer alle apparaat-id's uit een blob door opdrachtparameters op te geven voor invoerblobcontainer en opslagaccount, evenals uitvoerblobcontainer en opslagaccount.

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}

Importeer alle apparaat-id's uit een blob met behulp van een inline SAS-URI.

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

Importeer alle apparaat-id's uit een blob met behulp van een bestandspad dat SAS-URI bevat.

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

Importeer alle apparaat-id's uit een blob met de door het systeem toegewezen identiteit met de rollen Inzender voor opslagblobgegevens voor beide opslagaccounts. De invoer-blobcontainer en het opslagaccount en het uitvoer-blobcontainer en het opslagaccount worden geleverd als parameters voor de opdracht

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]

Importeer alle apparaat-id's uit een blob met de door het systeem toegewezen identiteit met de rollen Inzender voor opslagblobgegevens voor beide opslagaccounts. De blobcontainer-URI heeft het SAS-token voor de blob niet nodig.

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

Importeer alle apparaat-id's uit een blob met door de gebruiker toegewezen beheerde identiteit met de rollen Inzender voor opslagblobgegevens voor beide opslagaccounts. De invoer-blobcontainer en het opslagaccount en het uitvoer-blobcontainer en het opslagaccount worden geleverd als parameters voor de opdracht

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}

Importeer alle apparaat-id's uit een blob met door de gebruiker toegewezen beheerde identiteit met de rollen Inzender voor opslagblobgegevens voor beide opslagaccounts. De blobcontainer-URI heeft het SAS-token voor de blob niet nodig.

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

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Uitvoerindeling.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap	Waarde
Default value:	False

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

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Uitvoerindeling.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap	Waarde
Default value:	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]

Voorbeelden

Vernieuw de primaire sleutel.

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

Vervang de primaire en secundaire sleutels.

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

Vernieuw de secundaire sleutel voor twee apparaten en hun modules.

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

Vernieuw de beide sleutels voor alle apparaten in de hub.

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

Vereiste parameters

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Uitvoerindeling.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap	Waarde
Default value:	False

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

Vereiste parameters

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Uitvoerindeling.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap	Waarde
Default value:	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]

Voorbeelden

Edge-mogelijkheden voor apparaat inschakelen

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

Schakel edge-mogelijkheden in voor het apparaat met behulp van het argument gemak.

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

Apparaatstatus uitschakelen

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

Schakel de apparaatstatus uit met behulp van het argument gemak.

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

In één opdracht

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

Vereiste parameters

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Uitvoerindeling.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap	Waarde
Default value:	False