Delen via

az iot du update

Note

Deze verwijzing maakt deel uit van de Azure-iot-extensie voor de Azure CLI (versie 2.67.0 of hoger). De extensie wordt automatisch geïnstalleerd wanneer u een az iot du update opdracht uitvoert. Meer informatie over uitbreidingen.

Updatebeheer voor apparaatupdates.

Opdracht

Name Description Type Status
az iot du update calculate-hash

Bereken de base64-hashweergave van een bestand.

 Extension GA
az iot du update delete

Een specifieke updateversie verwijderen.

 Extension GA
az iot du update file

Bestandsbewerkingen bijwerken.

 Extension GA
az iot du update file list

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

 Extension GA
az iot du update file show

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

 Extension GA
az iot du update import

Importeer een nieuwe updateversie in het device update-exemplaar.

 Extension GA
az iot du update init

Hulpprogramma voor het initialiseren van manifesten.

 Extension Preview
az iot du update init v5

Initialiseer een v5-importmanifest met de gewenste status.

 Extension Preview
az iot du update list

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

 Extension GA
az iot du update show

Een specifieke updateversie weergeven.

 Extension GA
az iot du update stage

Faseer een update voor importeren naar een doelexemplaren.

 Extension Preview

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

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

--hash-algo

Cryptografisch algoritme dat moet worden gebruikt voor hashing.

Eigenschap Waarde
Default value: sha256
Geaccepteerde waarden: sha256
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 du update delete

Een specifieke updateversie verwijderen.

az iot du update delete --account
                        --instance
                        --un --update-name
                        --up --update-provider
                        --update-version --uv
                        [--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}.

Eigenschap Waarde
Parametergroep: Account Identifier Arguments
--instance -i

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

Eigenschap Waarde
Parametergroep: Account Identifier Arguments
--un --update-name

De naam van de update.

--up --update-provider

De updateprovider.

--update-version --uv

De updateversie.

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.

--no-wait

Wacht niet totdat de langdurige bewerking is voltooid.

Eigenschap Waarde
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}.

Eigenschap Waarde
Parametergroep: Account Identifier Arguments
--yes -y

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

Eigenschap Waarde
Geaccepteerde waarden: false, true
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 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}.

Eigenschap Waarde
Parametergroep: Account Identifier Arguments
--instance -i

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

Eigenschap Waarde
Parametergroep: Account Identifier Arguments
--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

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

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

Eigenschap Waarde
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}.

Eigenschap Waarde
Parametergroep: Account Identifier Arguments
--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.

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 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 --update-name]
                      [--up --update-provider]

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

Eigenschap Waarde
Parametergroep: Account Identifier Arguments
--instance -i

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

Eigenschap Waarde
Parametergroep: Account Identifier Arguments

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.

--by-provider

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

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

Eigenschap Waarde
Parametergroep: Filter Arguments
--resource-group -g

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

Eigenschap Waarde
Parametergroep: Account Identifier Arguments
--search

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

Eigenschap Waarde
Parametergroep: Filter Arguments
--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.

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 du update show

Een specifieke updateversie weergeven.

az iot du update show --account
                      --instance
                      --un --update-name
                      --up --update-provider
                      --update-version --uv
                      [--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}.

Eigenschap Waarde
Parametergroep: Account Identifier Arguments
--instance -i

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

Eigenschap Waarde
Parametergroep: Account Identifier Arguments
--un --update-name

De naam van de update.

--up --update-provider

De updateprovider.

--update-version --uv

De updateversie.

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.

--resource-group -g

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

Eigenschap Waarde
Parametergroep: Account Identifier Arguments
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 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}.

Eigenschap Waarde
Parametergroep: Account Identifier Arguments
--instance -i

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

Eigenschap Waarde
Parametergroep: Account Identifier Arguments
--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.

Eigenschap Waarde
Parametergroep: Storage Arguments
--storage-container

De naam van de gewenste opslagcontainer om manifestartefacten te faseken.

Eigenschap Waarde
Parametergroep: Storage Arguments

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.

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

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

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

Eigenschap Waarde
Parametergroep: Account Identifier Arguments
--storage-subscription

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

Eigenschap Waarde
Parametergroep: Storage Arguments
--then-import

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

Eigenschap Waarde
Geaccepteerde waarden: false, true
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