Dela via

az iot du update init

  • Förhandsgranskning
  • 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 kommandot az iot du update init . Läs mer om tillägg.

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

Verktyg för importmanifestinitiering.

Kommandon

Name Description Typ Status
az iot du update init v5

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

 Anknytning Förhandsversion

az iot du update init v5

Förhandsgranskning

Kommandogruppen "iot du update init" är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

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

Det här kommandot stöder alla attribut för v5-importmanifestet. Observera att det finns positionskänslighet mellan --step och --file, samt --file och --related-file. Granska exempel och parameterbeskrivningar för mer information om hur du använder åtgärden fullt ut.

Läs mer om att använda citattecken och escape-tecken i olika gränssnitt här: https://aka.ms/aziotcli-json.

az iot du update init v5 --compat
                         --step
                         --update-name
                         --update-provider
                         --update-version
                         [--description]
                         [--file]
                         [--is-deployable {false, true}]
                         [--no-validation {false, true}]
                         [--related-file]

Exempel

Initiera ett manifest för minsta innehållsimport. Infogad json optimerad för "bash".

az iot du update init v5 --update-provider Microsoft --update-name myAptUpdate --update-version 1.0.0 --description "My minimum update" --compat manufacturer=Contoso model=Vacuum --step handler=microsoft/apt:1 properties='{"installedCriteria": "1.0"}' --file path=/my/apt/manifest/file

Initiera ett manifest för minsta innehållsimport. Infogad json optimerad för "powershell".

az iot du update init v5 --update-provider Microsoft --update-name myAptUpdate --update-version 1.0.0 --description "My minimum update" --compat manufacturer=Contoso model=Vacuum --step handler=microsoft/apt:1 properties='{\"installedCriteria\": \"1.0\"}' --file path=/my/apt/manifest/file

Initiera ett manifest för minsta innehållsimport. Infogad json optimerad för "cmd".

az iot du update init v5 --update-provider Microsoft --update-name myAptUpdate --update-version 1.0.0 --description "My minimum update" --compat manufacturer=Contoso model=Vacuum --step handler=microsoft/apt:1 properties="{\"installedCriteria\": \"1.0\"}" --file path=/my/apt/manifest/file

Initiera ett manifest för minsta innehållsimport. Använd filindata för json.

az iot du update init v5 --update-provider Microsoft --update-name myAptUpdate --update-version 1.0.0 --description "My minimum update" --compat manufacturer=Contoso model=Vacuum --step handler=microsoft/apt:1 properties="@/path/to/file" --file path=/my/apt/manifest/file

Initiera en icke-distributionsbar lövuppdatering som ska refereras i en paketerad uppdatering. Infogad json optimerad för "bash".

az iot du update init v5 --update-provider Microsoft --update-name mySwUpdate --update-version 1.1.0 --compat manufacturer=Contoso model=Microphone --step handler=microsoft/swupdate:1 description="Deploy Update" properties='{"installedCriteria": "1.0"}' --file path=/my/update/image/file1 --file path=/my/update/image/file2 --is-deployable false

Initiera en paketerad uppdatering som refererar till en lövuppdatering och definiera oberoende steg. Exempel optimerat för "bash" med hjälp av kommandofortsättning för att avgränsa importmanifestsegment.

az iot du update init v5 \
--update-provider Microsoft --update-name myBundled --update-version 2.0 \
--compat manufacturer=Contoso model=SpaceStation \
--step handler=microsoft/script:1 properties='{"arguments": "--pre"}' description="Pre-install script" \
--file path=/my/update/scripts/preinstall.sh downloadHandler=microsoft/delta:1 \
--related-file path=/my/update/scripts/related_preinstall.json properties='{"microsoft.sourceFileHashAlgorithm": "sha256"}' \
--step updateId.provider=Microsoft updateId.name=SwUpdate updateId.version=1.1 \
--step handler=microsoft/script:1 properties='{"arguments": "--post"}' description="Post-install script" \
--file path=/my/update/scripts/postinstall.sh

Obligatoriska parametrar

--compat

Blankstegsavgränsad nyckel=värdepar som motsvarar egenskaperna för en enhet som uppdateringen är kompatibel med. Används vanligtvis för att definiera egenskaper som tillverkare och modell. --compat kan användas 1 eller fler gånger.

--step

Blankstegsavgränsad nyckel=värdepar som motsvarar elementegenskaperna "instructions.steps". Klienten avgör om ett steg är ett infogat steg eller ett referenssteg baserat på de angivna nyckelvärdeparen. Om antingen infogat eller referenssteg kan uppfyllas prioriteras referenssteget. Användningen av --file associeras med den närmaste infogade posten --step, vilket härleder värdet för "filer". Följande referensstegnycklar stöds: updateId.provider, updateId.nameupdateId.version och description. Följande infogade stegnycklar stöds: handler (t.ex. "microsoft/script:1" eller "microsoft/swupdate:1" eller "microsoft/apt:1", properties (infogat json-objekt som agenten skickar till hanteraren) och description. --step kan användas 1 eller fler gånger.

--update-name

Uppdateringsnamnet som en komponent i updateId.

--update-provider

Uppdateringsprovidern som en komponent i updateId.

--update-version

Uppdateringsversionen som en komponent i updateId.

Valfria parametrar

--description

Beskrivning för importmanifestet.

--file

Blankstegsavgränsade nyckel=värdepar som motsvarar elementegenskaperna för filer. En --file-post kan innehålla de närmaste --related-file-posterna om det tillhandahålls. Följande nycklar stöds: path [obligatorisk] lokal filsökväg för att uppdatera filen, downloadHandler (t.ex. hanteraren microsoft/delta:1) för att använda relaterade filer för att ladda ned nyttolastfilen properties (in-line json-objekt som agenten skickar till hanteraren). --file kan användas 1 eller fler gånger.

--is-deployable

Anger om uppdateringen kan distribueras separat.

Godkända värden: false, true
--no-validation

Inaktiverar json-schemavalidering på klientsidan av importmanifestinnehållet.

Godkända värden: false, true
--related-file

Blankstegsavgränsade nyckel=värdepar som motsvarar elementegenskaperna "files[*].relatedFiles". En --related-file-post associeras till den närmaste --file-posten om den finns. Följande nycklar stöds: path [obligatorisk] lokal filsökväg till relaterad uppdateringsfil ( properties infogat json-objekt som skickas till nedladdningshanteraren). --related-file kan användas 1 eller fler gånger.

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.