az iot du update init

Preview

Note

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

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

Hulpprogramma voor het initialiseren van manifesten.

Opdracht

Name	Description	Type	Status
az iot du update init v5	Initialiseer een v5-importmanifest met de gewenste status.	Extension	Preview

az iot du update init v5

Preview

Opdrachtgroep 'iot du update init' is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Initialiseer een v5-importmanifest met de gewenste status.

Deze opdracht ondersteunt alle kenmerken van het v5-importmanifest. Houd er rekening mee dat er positionele gevoeligheid is tussen --step en , en --file .--file--related-file Bekijk voorbeelden en parameterbeschrijvingen voor meer informatie over hoe u de bewerking volledig kunt gebruiken.

Lees hier meer over het gebruik van aanhalingstekens en escapetekens in verschillende shells: 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]

Voorbeelden

Initialiseer een minimummanifest voor het importeren van inhoud. Inline json geoptimaliseerd voor '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

Initialiseer een minimummanifest voor het importeren van inhoud. Inline json geoptimaliseerd voor 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

Initialiseer een minimummanifest voor het importeren van inhoud. Inline json geoptimaliseerd voor 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

Initialiseer een minimummanifest voor het importeren van inhoud. Gebruik bestandsinvoer voor 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

Initialiseer een niet-implementeerbare leaf-update waarnaar wordt verwezen in een gebundelde update. Inline json geoptimaliseerd voor '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

Initialiseer een gebundelde update die verwijst naar een leaf-update en definieer onafhankelijke stappen. Voorbeeld geoptimaliseerd voor 'bash' met behulp van opdrachtvervolging om manifestsegmenten voor importeren af te bakenen.

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

Vereiste parameters

--compat

Door spaties gescheiden sleutelparen=waardeparen die overeenkomen met eigenschappen van een apparaat waarmee deze update compatibel is. Doorgaans gebruikt voor het definiëren van eigenschappen zoals fabrikant en model. --compat kan 1 of meer keer worden gebruikt.

--step

Door spaties gescheiden sleutel-waardeparen die overeenkomen met de elementeigenschappen 'instructions.steps'. De client bepaalt of een stap een inline- of referentiestap is op basis van de opgegeven sleutelwaardeparen. Als aan de inline- of referentiestap kan worden voldaan, wordt de verwijzingsstap geprioriteerd. Het gebruik van --file wordt gekoppeld aan de dichtstbijzijnde inline-stapvermelding, waardoor de waarde voor 'bestanden' wordt afgeleid. De volgende referentiestapsleutels worden ondersteund: updateId.provider, updateId.name, updateId.version en description. De volgende inlinestapsleutels worden ondersteund: handler (bijvoorbeeld 'microsoft/script:1' of 'microsoft/swupdate:1' of 'microsoft/apt:1'), properties (inline json-object dat de agent doorgeeft aan de handler) en description. --step kan 1 of meer keren worden gebruikt.

--update-name

De naam van de update als onderdeel van updateId.

--update-provider

De updateprovider als onderdeel van updateId.

--update-version

De updateversie als onderdeel van updateId.

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.

--description

Beschrijving voor het importmanifest.

--file

Door spaties gescheiden sleutelparen=waardeparen die overeenkomen met elementeigenschappen van bestanden. Een --file entry kan de dichtstbijzijnde --related-file vermeldingen bevatten, indien opgegeven. De volgende sleutels worden ondersteund: path [vereist] lokaal bestandspad voor het bijwerken van bestand, downloadHandler (bijvoorbeeld'microsoft/delta:1') voor het gebruik van gerelateerde bestanden voor het downloaden van nettoladingbestand, properties (inline json-object dat de agent doorgeeft aan de handler). --file kan 1 of meer keren worden gebruikt.

--is-deployable

Geeft aan of de update onafhankelijk kan worden geïmplementeerd.

Eigenschap	Waarde
Geaccepteerde waarden:	false, true

--no-validation

Schakelt json-schemavalidatie aan de clientzijde uit van de inhoud van het importmanifest.

Eigenschap	Waarde
Geaccepteerde waarden:	false, true

--related-file

Door spaties gescheiden sleutel-waardeparen die overeenkomen met de elementeigenschappen 'files[*].relatedFiles'. Een --related-file entry wordt gekoppeld aan de dichtstbijzijnde --file entry als deze bestaat. De volgende sleutels worden ondersteund: path lokaal bestandspad naar gerelateerd updatebestand properties (inline json-object doorgegeven aan de downloadhandler). --related-file kan 1 of meer keren worden gebruikt.

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

Feedback

Is deze pagina nuttig?