az iot du update init

Preview
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 init-opdracht az iot du update uitvoert. Meer informatie over extensies.

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.	Toestel	Preview uitvoeren

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 .--related-file--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.nameen descriptionupdateId.version . 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

--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 om payloadbestand te downloaden, 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.

Geaccepteerde waarden: false, true

--no-validation

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

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 [vereist] 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.

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

Delen via