Delen via

az iot du update

  • Referentie

Notitie

Deze verwijzing maakt deel uit van de Azure-iot-extensie voor de Azure CLI (versie 2.46.0 of hoger). De extensie installeert automatisch de eerste keer dat u een az iot du update-opdracht uitvoert. Meer informatie over extensies.

Updatebeheer voor apparaatupdates.

Opdracht

Name Description Type Status
az iot du update calculate-hash

Bereken de base64-hashweergave van een bestand.

 Toestel GA
az iot du update delete

Een specifieke updateversie verwijderen.

 Toestel GA
az iot du update file

Bestandsbewerkingen bijwerken.

 Toestel GA
az iot du update file list

Lijst met updatebestands-id's met betrekking tot updateprovider, naam en versie.

 Toestel GA
az iot du update file show

Geef de details van een specifiek updatebestand weer met betrekking tot de updateprovider, naam en versie.

 Toestel GA
az iot du update import

Importeer een nieuwe updateversie in het device update-exemplaar.

 Toestel GA
az iot du update init

Hulpprogramma voor het initialiseren van manifesten.

 Toestel Preview uitvoeren
az iot du update init v5

Initialiseer een v5-importmanifest met de gewenste status.

 Toestel Preview uitvoeren
az iot du update list

Vermeld updates die zijn geïmporteerd in het device update-exemplaar.

 Toestel GA
az iot du update show

Een specifieke updateversie weergeven.

 Toestel GA
az iot du update stage

Faseer een update voor importeren naar een doelexemplaren.

 Toestel Preview uitvoeren

az iot du update calculate-hash

Bereken de base64-hashweergave van een bestand.

az iot du update calculate-hash --file-path
                                [--hash-algo {sha256}]

Voorbeelden

Bereken de base64-weergave van een sha256-digest voor een doelupdatebestand.

az iot du update calculate-hash --file-path /path/to/file

Bereken de base64-weergave van een sha256-digest voor meerdere doelupdatebestanden.

az iot du update calculate-hash --file-path /path/to/file1 --file-path /path/to/file2 --file-path /path/to/file3

Vereiste parameters

--file-path -f

Lokaal pad naar doelbestand voor hashberekening. --file-path kan 1 of meer keren worden gebruikt.

Optionele parameters

--hash-algo

Cryptografisch algoritme dat moet worden gebruikt voor hashing.

Geaccepteerde waarden: sha256
Default value: sha256
Globale parameters
--debug

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

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

Naam of id van het 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.

az iot du update delete

Een specifieke updateversie verwijderen.

az iot du update delete --account
                        --instance
                        --un
                        --up
                        --update-version
                        [--no-wait]
                        [--resource-group]
                        [--yes {false, true}]

Voorbeelden

Verwijder een doelupdate met betrekking tot de updateprovider, naam en versie.

az iot du update delete -n {account_name} -i {instance_name} --update-provider {provider_name} --update-name {update_name} --update-version {update_version}

Vereiste parameters

--account -n

Accountnaam voor apparaatupdate. U kunt de standaardaccountnaam configureren met behulp van az config set defaults.adu_account=<name>.

--instance -i

De naam van het apparaatupdate-exemplaar. U kunt de naam van het standaardexemplaren configureren met behulp van az config set defaults.adu_instance=<name>.

--un --update-name

De naam van de update.

--up --update-provider

De updateprovider.

--update-version --uv

De updateversie.

Optionele parameters

--no-wait

Wacht niet totdat de langdurige bewerking is voltooid.

Default value: False
--resource-group -g

Resourcegroepnaam voor apparaatupdate-account. U kunt de standaardgroep configureren met behulp van az config set defaults.adu_group=<name>.

--yes -y

Gebruikersprompts overslaan. Geeft de acceptatie van de actie aan. Wordt voornamelijk gebruikt voor automatiseringsscenario's. Standaard: onwaar.

Geaccepteerde waarden: false, true
Globale parameters
--debug

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

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

Naam of id van het 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.

az iot du update import

Importeer een nieuwe updateversie in het device update-exemplaar.

Deze opdracht ondersteunt de --defer mogelijkheid. Wanneer u de opdracht gebruikt, wordt de nettolading van het object opgeslagen die is bedoeld om in een lokale cache naar Azure te worden verzonden. Het volgende gebruik van deze opdracht zonder --defer de nettolading van de nieuwe aanvraag te combineren met de objecten in de cache die ze samen verzenden.

Wanneer de overeenkomende lokale cachevermelding is voltooid, wordt de cache verwijderd. Als er een fout optreedt in de cache, wordt de inhoud niet verwijderd. Gebruik az cache opdrachten om lokale cachevermeldingen onafhankelijk te beheren.

Ondersteuning uitstellen is voornamelijk bedoeld voor updates met meerdere referentiestappen, zodat bovenliggende en onderliggende updates samen kunnen worden ingediend.

az iot du update import --account
                        --instance
                        --url
                        [--defer]
                        [--file]
                        [--friendly-name]
                        [--hashes]
                        [--no-wait]
                        [--resource-group]
                        [--size]

Voorbeelden

Importeer een update met twee gerelateerde bestanden en geen referentiestappen, waarbij expliciet de hashwaarde en de manifestgrootte in bytes worden opgegeven.

az iot du update import -n {account_name} -i {instance_name} --hashes sha256={hash_value} --size {size_in_bytes} --url {manifest_location} --file filename={file1_name} url={file1_url} --file filename={file2_name} url={file2_url}

Importeer een update met twee gerelateerde bestanden en geen referentiestappen, zodat de CLI de hashwaarde en grootte van het importmanifest in bytes kan berekenen.

az iot du update import -n {account_name} -i {instance_name} --url {manifest_location} --file filename={file1_name} url={file1_url} --file filename={file2_name} url={file2_url}

Importeer een bovenliggende update met twee verwijzingsstappen voor onderliggende updates, waarbij alle drie de importmanifesten één gerelateerd bestand hebben. Laat de CLI de hashwaarde en grootte berekenen in bytes voor iedereen. Deze bewerking is afhankelijk van de mogelijkheid '--defer'.

az iot du update import -n {account_name} -i {instance_name} --url {parent_manifest_location} --file filename={parent_file_name} url={parent_file_url} --defer

az iot du update import -n {account_name} -i {instance_name} --url {child1_manifest_location} --file filename={child1_file_name} url={child1_file_url} --defer

az iot du update import -n {account_name} -i {instance_name} --url {child2_manifest_location} --file filename={child2_file_name} url={child2_file_url}

Vereiste parameters

--account -n

Accountnaam voor apparaatupdate. U kunt de standaardaccountnaam configureren met behulp van az config set defaults.adu_account=<name>.

--instance -i

De naam van het apparaatupdate-exemplaar. U kunt de naam van het standaardexemplaren configureren met behulp van az config set defaults.adu_instance=<name>.

--url

Routeerbare locatie waaruit het importmanifest kan worden gedownload door Device Update voor IoT Hub. Dit is doorgaans een alleen-lezen SAS-beveiligde blob-URL met een vervaldatum die is ingesteld op ten minste 3 uur.

Optionele parameters

--defer

Sla het object tijdelijk op in de lokale cache in plaats van naar Azure te verzenden. Gebruik az cache opdrachten om weer te geven/te wissen.

--file

Door spaties gescheiden sleutel-waardeparen die overeenkomen met eigenschappen van manifestmetagegevensbestand importeren. Vereiste sleutels bevatten bestandsnaam en URL. --file kan 1 of meer keren worden gebruikt.

--friendly-name

Beschrijvende naam die is gekoppeld aan de updatedefinitie.

--hashes

Door spaties gescheiden sleutel-waardeparen waarbij de sleutel het hash-algoritme is dat wordt gebruikt en de waarde de base64 gecodeerde hash van het importmanifestbestand is. Ten minste een sha256-vermelding is vereist. Als dit niet wordt opgegeven, wordt dit berekend op basis van de opgegeven URL.

--no-wait

Wacht niet totdat de langdurige bewerking is voltooid.

Default value: False
--resource-group -g

Resourcegroepnaam voor apparaatupdate-account. U kunt de standaardgroep configureren met behulp van az config set defaults.adu_group=<name>.

--size

Bestandsgrootte in het aantal bytes. Als dit niet wordt opgegeven, wordt dit berekend op basis van de opgegeven URL.

Globale parameters
--debug

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

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

Naam of id van het 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.

az iot du update list

Vermeld updates die zijn geïmporteerd in het device update-exemplaar.

Bij het weergeven van updateproviders hoeft alleen de vlag --by-provider te worden opgegeven naast de algemene argumenten voor het opzoeken van exemplaren. Wanneer de updatenamen worden vermeld, moet de updateprovider worden opgegeven. Bij het weergeven van updateversies moet de updateprovider en de naam van de update worden opgegeven.

az iot du update list --account
                      --instance
                      [--by-provider {false, true}]
                      [--filter]
                      [--resource-group]
                      [--search]
                      [--un]
                      [--up]

Voorbeelden

Geef alle updates weer.

az iot du update list -n {account_name} -i {instance_name}

Vermeld alle updates die voldoen aan een zoekcriteria voor vrije tekst, in dit geval de updateprovider van Contoso.

az iot du update list -n {account_name} -i {instance_name} --search 'Contoso'

Vermeld alle updates die voldoen aan een odata-filter, in dit geval filteren op niet-implementeerbare updates.

az iot du update list -n {account_name} -i {instance_name} --filter 'isDeployable eq false'

Geef alle updateproviders weer.

az iot du update list -n {account_name} -i {instance_name} --by-provider

Geef alle updatenamen per updateprovider weer.

az iot du update list -n {account_name} -i {instance_name} --update-provider {provider_name}

Vermeld alle updateversies per updateprovider en updatenaam.

az iot du update list -n {account_name} -i {instance_name} --update-provider {provider_name} --update-name {update_name}

Vereiste parameters

--account -n

Accountnaam voor apparaatupdate. U kunt de standaardaccountnaam configureren met behulp van az config set defaults.adu_account=<name>.

--instance -i

De naam van het apparaatupdate-exemplaar. U kunt de naam van het standaardexemplaren configureren met behulp van az config set defaults.adu_instance=<name>.

Optionele parameters

--by-provider

Vlag die aangeeft dat de resultatenset moet worden beperkt tot updateproviders.

Geaccepteerde waarden: false, true
--filter

Hiermee beperkt u de set updates die worden geretourneerd door eigenschapswaarden. Ondersteund bij het weergeven van updates zonder beperkingen of bij vermelding per versie.

--resource-group -g

Resourcegroepnaam voor apparaatupdate-account. U kunt de standaardgroep configureren met behulp van az config set defaults.adu_group=<name>.

--search

Updates aanvragen die overeenkomen met een zoekexpressie in vrije tekst. Ondersteund bij het weergeven van updates zonder beperkingen.

--un --update-name

De naam van de update.

--up --update-provider

De updateprovider.

Globale parameters
--debug

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

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

Naam of id van het 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.

az iot du update show

Een specifieke updateversie weergeven.

az iot du update show --account
                      --instance
                      --un
                      --up
                      --update-version
                      [--resource-group]

Voorbeelden

Een specifieke update weergeven met betrekking tot de updateprovider, naam en versie.

az iot du update show -n {account_name} -i {instance_name} --update-provider {provider_name} --update-name {update_name} --update-version {update_version}

Vereiste parameters

--account -n

Accountnaam voor apparaatupdate. U kunt de standaardaccountnaam configureren met behulp van az config set defaults.adu_account=<name>.

--instance -i

De naam van het apparaatupdate-exemplaar. U kunt de naam van het standaardexemplaren configureren met behulp van az config set defaults.adu_instance=<name>.

--un --update-name

De naam van de update.

--up --update-provider

De updateprovider.

--update-version --uv

De updateversie.

Optionele parameters

--resource-group -g

Resourcegroepnaam voor apparaatupdate-account. U kunt de standaardgroep configureren met behulp van az config set defaults.adu_group=<name>.

Globale parameters
--debug

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

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

Naam of id van het 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.

az iot du update stage

Preview

Deze opdracht is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Faseer een update voor importeren naar een doelexemplaren.

Fasering van een update verwijst naar het versnellen van de vereiste stappen voor het importeren van een update naar een doelexemplaren. Voor een bepaald importmanifest bepaalt het proces relevante bestanden, pusht deze naar een gewenste opslagcontainer, genereert u SAS-URI's en behandelt u andere voorbereidingsstappen voor een geslaagde import.

Deze opdracht is afhankelijk van een op conventie gebaseerde organisatie van updatebestanden. Alle updatebestanden voor een doelmanifest bevinden zich naar verwachting in dezelfde map waarin het importmanifest zich bevindt.

Op sleutels gebaseerde toegang wordt gebruikt voor het uploaden van blobartefacten en voor het genereren van SAS-URI's van 3 uur met leestoegang.

Als --then-import er een vlag is opgegeven, wordt met de opdracht de gefaseerde update geïmporteerd. Anders is het resultaat van deze bewerking een importopdracht die moet worden uitgevoerd om hetzelfde resultaat te bereiken op een later tijdstip.

Met deze opdracht worden alle lokale cachevermeldingen voor het doelexemplaren verwijderd en vernieuwd.

az iot du update stage --account
                       --instance
                       --manifest-path
                       --storage-account
                       --storage-container
                       [--friendly-name]
                       [--overwrite {false, true}]
                       [--resource-group]
                       [--storage-subscription]
                       [--then-import {false, true}]

Voorbeelden

Een zelfstandige update uitvoeren. Updatebestanden bevinden zich naar verwachting in dezelfde map als het manifest. De resulterende importopdracht kan op een later tijdstip worden uitgevoerd om het importeren van de gefaseerde update vóór het verlopen van het SAS-token te starten.

az iot du update stage -n {account_name} -i {instance_name} --storage-account {storage_account_name} --storage-container {storage_container_name} --manifest-path /path/to/manifest.json

Een zelfstandige update uitvoeren. Na de fasering importeert u de update naar het exemplaar met behulp van een gewenste beschrijvende naam.

az iot du update stage -n {account_name} -i {instance_name} --storage-account {storage_account_name} --storage-container {storage_container_name} --manifest-path /path/to/manifest.json --then-import --friendly-name myAptUpdate

Faseer een update met meerdere verwijzingen. Updatebestanden worden geüpload naar een opslagblobcontainer die zich in een ander abonnement bevindt voor het updateaccount.

az iot du update stage -n {account_name} -i {instance_name} --storage-account {storage_account_name} --storage-container {storage_container_name} --storage-subscription {storage_account_subscription} --manifest-path /path/to/parent/parent.manifest.json --manifest-path /path/to/leaf1/leaf1.manifest.json --manifest-path /path/to/leaf2/leaf2.manifest.json

Een update met meerdere verwijzingen uitvoeren, bestaande blobs overschrijven als deze bestaan. Na de fasering importeert u de update naar het exemplaar.

az iot du update stage -n {account_name} -i {instance_name} --storage-account {storage_account_name} --storage-container {storage_container_name} --manifest-path /path/to/parent/parent.manifest.json --manifest-path /path/to/leaf1/leaf1.manifest.json --manifest-path /path/to/leaf2/leaf2.manifest.json --then-import --overwrite

Vereiste parameters

--account -n

Accountnaam voor apparaatupdate. U kunt de standaardaccountnaam configureren met behulp van az config set defaults.adu_account=<name>.

--instance -i

De naam van het apparaatupdate-exemplaar. U kunt de naam van het standaardexemplaren configureren met behulp van az config set defaults.adu_instance=<name>.

--manifest-path

Lokaal bestandspad naar het importmanifest dat moet worden gefaseerd. Kan 1 of meer keren worden gebruikt.

--storage-account

Gewenste naam van het opslagaccount om manifestartefacten te faseken.

--storage-container

De naam van de gewenste opslagcontainer om manifestartefacten te faseken.

Optionele parameters

--friendly-name

Beschrijvende naam die is gekoppeld aan de updatedefinitie.

--overwrite

Vlag die aangeeft of bestaande blobs moeten worden overschreven als er een conflict bestaat.

Geaccepteerde waarden: false, true
Default value: False
--resource-group -g

Resourcegroepnaam voor apparaatupdate-account. U kunt de standaardgroep configureren met behulp van az config set defaults.adu_group=<name>.

--storage-subscription

Gewenst opslagaccountabonnement om manifestartefacten te faseken. Van toepassing wanneer de opslag- en apparaatupdateaccounts zich in verschillende abonnementen bevinden.

--then-import

Vlag die aangeeft of de update na fasering moet worden geïmporteerd.

Geaccepteerde waarden: false, true
Globale parameters
--debug

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

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

Naam of id van het 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.