Dela via

az iot du update

  • Referens

Kommentar

Den här referensen är en del av azure-iot-tillägget för Azure CLI (version 2.46.0 eller senare). Tillägget installeras automatiskt första gången du kör ett az iot du update-kommando . Läs mer om tillägg.

Uppdateringshantering för enhetsuppdatering.

Kommandon

Name Description Typ Status
az iot du update calculate-hash

Beräkna den base64-hashade representationen av en fil.

 Anknytning Allmän tillgänglighet
az iot du update delete

Ta bort en specifik uppdateringsversion.

 Anknytning Allmän tillgänglighet
az iot du update file

Uppdatera filåtgärder.

 Anknytning Allmän tillgänglighet
az iot du update file list

Lista uppdateringsfil-ID:er med avseende på uppdateringsprovider, namn och version.

 Anknytning Allmän tillgänglighet
az iot du update file show

Visa information om en specifik uppdateringsfil med avseende på uppdateringsprovider, namn och version.

 Anknytning Allmän tillgänglighet
az iot du update import

Importera en ny uppdateringsversion till enhetsuppdateringsinstansen.

 Anknytning Allmän tillgänglighet
az iot du update init

Verktyg för importmanifestinitiering.

 Anknytning Förhandsversion
az iot du update init v5

Initiera ett v5-importmanifest med önskat tillstånd.

 Anknytning Förhandsversion
az iot du update list

Visa en lista över uppdateringar som har importerats till enhetsuppdateringsinstansen.

 Anknytning Allmän tillgänglighet
az iot du update show

Visa en specifik uppdateringsversion.

 Anknytning Allmän tillgänglighet
az iot du update stage

Mellanlagra en uppdatering för import till en målinstans.

 Anknytning Förhandsversion

az iot du update calculate-hash

Beräkna den base64-hashade representationen av en fil.

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

Exempel

Beräkna base64-representationen av en sha256-sammandrag för en måluppdateringsfil.

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

Beräkna base64-representationen av en sha256-sammandrag för flera måluppdateringsfiler.

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

Obligatoriska parametrar

--file-path -f

Lokal sökväg till målfilen för hashberäkning. --file-path kan användas 1 eller fler gånger.

Valfria parametrar

--hash-algo

Kryptografisk algoritm som ska användas för hashning.

Godkända värden: sha256
Standardvärde: sha256
Globala parametrar
--debug

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

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

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

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

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

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

az iot du update delete

Ta bort en specifik uppdateringsversion.

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

Exempel

Ta bort en måluppdatering med avseende på uppdateringsprovider, namn och version.

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

Obligatoriska parametrar

--account -n

Namn på enhetsuppdateringskonto. Du kan konfigurera standardkontonamnet med .az config set defaults.adu_account=<name>

--instance -i

Namnet på enhetsuppdateringsinstansen. Du kan konfigurera standardinstansnamnet med .az config set defaults.adu_instance=<name>

--un --update-name

Uppdateringsnamnet.

--up --update-provider

Uppdateringsprovidern.

--update-version --uv

Uppdateringsversionen.

Valfria parametrar

--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

Standardvärde: False
--resource-group -g

Namn på resursgrupp för enhetsuppdateringskonto. Du kan konfigurera standardgruppen med .az config set defaults.adu_group=<name>

--yes -y

Hoppa över användarprompter. Anger godkännande av åtgärd. Används främst för automatiseringsscenarier. Standard: falskt.

Godkända värden: false, true
Globala parametrar
--debug

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

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

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

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

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

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

az iot du update import

Importera en ny uppdateringsversion till enhetsuppdateringsinstansen.

Det här kommandot stöder funktionen --defer . När kommandot används lagrar det objektnyttolast som ska skickas till Azure i en lokal cache. Nästa användning av det här kommandot utan --defer kombinerar den nya nyttolasten för begäran med cachelagrade objekt som skickar dem tillsammans.

När det har lyckats rensas motsvarande lokala cachepost. Om ett fel inträffar tas inte cachelagrat innehåll bort. Använd az cache kommandon för att hantera lokala cacheposter oberoende av varandra.

Stöd för uppskjutning är främst avsett för uppdateringar med flera referenssteg, så att överordnade och underordnade uppdateringar kan skickas tillsammans.

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

Exempel

Importera en uppdatering med två relaterade filer och inga referenssteg, vilket uttryckligen ger manifest-hash-värde och manifeststorlek i byte.

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}

Importera en uppdatering med två relaterade filer och inga referenssteg, så att CLI kan beräkna importmanifestets hash-värde och storlek i byte.

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}

Importera en överordnad uppdatering med två underordnade uppdateringsreferenssteg, där alla tre importmanifesten har en relaterad fil. Låt CLI beräkna hash-värdet och storleken i byte för alla. Den här åtgärden förlitar sig på funktionen "--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}

Obligatoriska parametrar

--account -n

Namn på enhetsuppdateringskonto. Du kan konfigurera standardkontonamnet med .az config set defaults.adu_account=<name>

--instance -i

Namnet på enhetsuppdateringsinstansen. Du kan konfigurera standardinstansnamnet med .az config set defaults.adu_instance=<name>

--url

Dirigerbar plats från vilken importmanifestet kan laddas ned av Enhetsuppdatering för IoT Hub. Detta är vanligtvis en skrivskyddad SAS-skyddad blob-URL med en förfallotid inställd på minst 3 timmar.

Valfria parametrar

--defer

Lagra objektet tillfälligt i den lokala cachen i stället för att skicka till Azure. Använd az cache kommandon för att visa/rensa.

--file

Blankstegsavgränsad nyckel=värdepar som motsvarar import av egenskaper för manifestmetadatafil. Nödvändiga nycklar inkluderar filnamn och URL. --file kan användas 1 eller fler gånger.

--friendly-name

Eget namn som är associerat med uppdateringsdefinitionen.

--hashes

Blankstegsavgränsad nyckel=värdepar där nyckeln är hashalgoritmen som används och värdet är den base64-kodade importmanifestfilens hash. Minst en sha256-post krävs. Om det inte tillhandahålls kommer det att beräknas från den angivna URL:en.

--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

Standardvärde: False
--resource-group -g

Namn på resursgrupp för enhetsuppdateringskonto. Du kan konfigurera standardgruppen med .az config set defaults.adu_group=<name>

--size

Filstorlek i antal byte. Om det inte tillhandahålls kommer det att beräknas från den angivna URL:en.

Globala parametrar
--debug

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

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

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

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

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

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

az iot du update list

Visa en lista över uppdateringar som har importerats till enhetsuppdateringsinstansen.

När du listar uppdateringsprovidrar måste flaggan --by-provider anges utöver de vanliga argumenten för att söka efter instanser. När uppdateringsnamn anges måste uppdateringsprovidern anges. När du listar uppdateringsversioner måste uppdateringsprovidern och uppdateringsnamnet anges.

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

Exempel

Visa en lista över alla uppdateringar.

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

Visa en lista över alla uppdateringar som uppfyller ett sökvillkor för fritext, i det här fallet uppdateringsleverantören för Contoso.

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

Visa en lista över alla uppdateringar som uppfyller ett odatafilter, i det här fallet filtrering för uppdateringar som inte kan distribueras.

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

Visa en lista över alla uppdateringsleverantörer.

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

Visa en lista över alla uppdateringsnamn efter uppdateringsprovider.

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

Visa en lista över alla uppdateringsversioner efter uppdateringsprovider och uppdateringsnamn.

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

Obligatoriska parametrar

--account -n

Namn på enhetsuppdateringskonto. Du kan konfigurera standardkontonamnet med .az config set defaults.adu_account=<name>

--instance -i

Namnet på enhetsuppdateringsinstansen. Du kan konfigurera standardinstansnamnet med .az config set defaults.adu_instance=<name>

Valfria parametrar

--by-provider

Flagga som anger att resultatuppsättningen ska begränsas till uppdateringsprovidrar.

Godkända värden: false, true
--filter

Begränsar uppsättningen uppdateringar som returneras av egenskapsvärden. Stöds när uppdateringar visas utan begränsningar eller när du listar efter version.

--resource-group -g

Namn på resursgrupp för enhetsuppdateringskonto. Du kan konfigurera standardgruppen med .az config set defaults.adu_group=<name>

--search

Begär uppdateringar som matchar ett fritextsökningsuttryck. Stöds när uppdateringar visas utan begränsningar.

--un --update-name

Uppdateringsnamnet.

--up --update-provider

Uppdateringsprovidern.

Globala parametrar
--debug

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

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

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

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

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

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

az iot du update show

Visa en specifik uppdateringsversion.

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

Exempel

Visa en specifik uppdatering med avseende på uppdateringsprovider, namn och version.

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

Obligatoriska parametrar

--account -n

Namn på enhetsuppdateringskonto. Du kan konfigurera standardkontonamnet med .az config set defaults.adu_account=<name>

--instance -i

Namnet på enhetsuppdateringsinstansen. Du kan konfigurera standardinstansnamnet med .az config set defaults.adu_instance=<name>

--un --update-name

Uppdateringsnamnet.

--up --update-provider

Uppdateringsprovidern.

--update-version --uv

Uppdateringsversionen.

Valfria parametrar

--resource-group -g

Namn på resursgrupp för enhetsuppdateringskonto. Du kan konfigurera standardgruppen med .az config set defaults.adu_group=<name>

Globala parametrar
--debug

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

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

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

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

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

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

az iot du update stage

Förhandsgranskning

Det här kommandot är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Mellanlagra en uppdatering för import till en målinstans.

Mellanlagring av en uppdatering syftar på att påskynda de nödvändiga stegen för att importera en uppdatering till en målinstans. För ett visst importmanifest avgör processen relevanta filer, push-överför dem till en önskad lagringscontainer, genererar SAS-URI:er och täcker andra förberedelsesteg för en lyckad import.

Det här kommandot är beroende av en konventionsbaserad organisation av uppdateringsfiler. Alla uppdateringsfiler för ett målmanifest förväntas finnas i samma katalog som importmanifestet finns i.

Nyckelbaserad åtkomst används för att ladda upp blobartefakter och generera SAS-URI:er med 3 timmars varaktighet med läsåtkomst.

Om --then-import flaggan anges importerar kommandot den mellanlagrade uppdateringen. Annars är resultatet av den här åtgärden ett importkommando som ska köras för att uppnå samma resultat vid ett senare tillfälle.

Det här kommandot rensar och uppdaterar alla lokala cacheposter för målinstansen.

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

Exempel

Mellanlagra en fristående uppdatering. Uppdateringsfiler förväntas finnas i samma katalog som manifestet. Det resulterande importkommandot kan köras vid ett senare tillfälle för att initiera importen av den mellanlagrade uppdateringen innan SAS-token upphör att gälla.

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

Mellanlagra en fristående uppdatering. Efter mellanlagringen importerar du uppdateringen till instansen med ett önskat eget namn.

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

Mellanlagra en uppdatering med flera referenser. Uppdateringsfiler laddas upp till en lagringsblobcontainer som finns i en annan prenumeration än uppdateringskontot.

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

Mellanlagra en uppdatering med flera referenser och skriv över befintliga blobar om de finns. Efter mellanlagringen importerar du uppdateringen till instansen.

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

Obligatoriska parametrar

--account -n

Namn på enhetsuppdateringskonto. Du kan konfigurera standardkontonamnet med .az config set defaults.adu_account=<name>

--instance -i

Namnet på enhetsuppdateringsinstansen. Du kan konfigurera standardinstansnamnet med .az config set defaults.adu_instance=<name>

--manifest-path

Lokal filsökväg till importmanifestet som ska mellanlagras. Kan användas 1 eller fler gånger.

--storage-account

Önskat lagringskontonamn för att mellanlagra importmanifestartefakter.

--storage-container

Önskat namn på lagringscontainern för att mellanlagra importmanifestartefakter.

Valfria parametrar

--friendly-name

Eget namn som är associerat med uppdateringsdefinitionen.

--overwrite

Flagga som anger om befintliga blobar ska skrivas över om det finns en konflikt.

Godkända värden: false, true
Standardvärde: False
--resource-group -g

Namn på resursgrupp för enhetsuppdateringskonto. Du kan konfigurera standardgruppen med .az config set defaults.adu_group=<name>

--storage-subscription

Önskad lagringskontoprenumeration för att mellanlagra importmanifestartefakter. Gäller när lagrings- och enhetsuppdateringskontona finns i olika prenumerationer.

--then-import

Flagga som anger om uppdateringen ska importeras efter mellanlagring.

Godkända värden: false, true
Globala parametrar
--debug

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

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

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

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

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

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