Freigeben über

az iot du update init

  • Vorschau
  • Referenz

Hinweis

Diese Referenz ist Teil der Azure-iot-Erweiterung für die Azure CLI (Version 2.46.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen az iot du update init-Befehl zum ersten Mal ausführen. Weitere Informationen zu Erweiterungen

Diese Befehlsgruppe befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Hilfsprogramm für die Importmanifestinitialisierung.

Befehle

Name Beschreibung Typ Status
az iot du update init v5

Initialisieren Sie ein v5-Importmanifest mit dem gewünschten Zustand.

 Erweiterung Vorschau

az iot du update init v5

Vorschau

Die Befehlsgruppe "iot du update init" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Initialisieren Sie ein v5-Importmanifest mit dem gewünschten Zustand.

Dieser Befehl unterstützt alle Attribute des v5-Importmanifests. Beachten Sie, dass es positionale Empfindlichkeit zwischen --step und --file, sowie --file und --related-file. Sehen Sie sich Beispiele und Parameterbeschreibungen an, um ausführliche Informationen zur vollständigen Nutzung des Vorgangs zu erhalten.

Weitere Informationen zur Verwendung von Anführungszeichen und Escapezeichen in verschiedenen Shells finden Sie hier: 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]

Beispiele

Initialisieren Sie ein minimales Inhaltsimportmanifest. Inline json optimiert 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

Initialisieren Sie ein minimales Inhaltsimportmanifest. Inline json optimiert 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

Initialisieren Sie ein minimales Inhaltsimportmanifest. Inline json optimiert 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

Initialisieren Sie ein minimales Inhaltsimportmanifest. Verwenden Sie die Dateieingabe 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

Initialisieren Sie ein nicht bereitgestelltes Blattupdate, auf das in einem gebündelten Update verwiesen wird. Inline json optimiert 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

Initialisieren Sie ein gebündeltes Update, das auf ein Blattupdate verweist, und definieren Sie unabhängige Schritte. Beispiel für 'bash' mit Befehlsfortsetzung zum Delineieren von Importmanifestsegmenten.

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

Erforderliche Parameter

--compat

Leertrennte Schlüssel=Wertpaare, die eigenschaften eines Geräts entsprechen, mit dem dieses Update kompatibel ist. Wird in der Regel zum Definieren von Eigenschaften wie Hersteller und Modell verwendet. --compat kann 1 oder mehr verwendet werden.

--step

Leerzeichentrennte Schlüssel=Wertpaare, die den Elementeigenschaften "instructions.steps" entsprechen. Der Client bestimmt, ob es sich bei einem Schritt um einen Inline- oder Referenzschritt handelt, der auf den bereitgestellten Schlüsselwertpaaren basiert. Wenn entweder Inline- oder Referenzschritt erfüllt werden kann, wird der Referenzschritt priorisiert. Die Verwendung von --file wird dem nächstgelegenen Inline-Schritt-Eintrag zugeordnet, der den Wert für "dateien" ableiten soll. Die folgenden Referenzschrittschlüssel werden unterstützt: updateId.provider, , updateId.version updateId.nameund description. Die folgenden Inlineschritttasten werden unterstützt: handler (z. B. 'microsoft/script:1' oder 'microsoft/swupdate:1' oder 'microsoft/apt:1'), properties (inline json-Objekt, das der Agent an den Handler übergibt) und description. --step kann 1 oder mehr mal verwendet werden.

--update-name

Der Updatename als Komponente der updateId.

--update-provider

Der Updateanbieter als Komponente der updateId.

--update-version

Die Updateversion als Komponente der updateId.

Optionale Parameter

--description

Beschreibung für das Importmanifest.

--file

Leerzeichentrennte Schlüssel=Wertpaare, die den Elementeigenschaften von "files" entsprechen. Ein Dateieintrag --datei kann die nächstgelegenen --bezogenen Dateieinträge enthalten, falls angegeben. Die folgenden Schlüssel werden unterstützt: path [erforderlich] lokaler Dateipfad zum Aktualisieren der Datei, downloadHandler (z. B. 'microsoft/delta:1') Handler zum Verwenden verwandter Dateien zum Herunterladen der Nutzlastdatei ( properties inline json-Objekt, das der Agent an den Handler übergibt). --file kann 1 oder mehr verwendet werden.

--is-deployable

Gibt an, ob das Update unabhängig bereitgestellt werden kann.

Zulässige Werte: false, true
--no-validation

Deaktiviert die clientseitige JSON-Schemaüberprüfung des Importmanifestinhalts.

Zulässige Werte: false, true
--related-file

Leerzeichentrennte Schlüssel=Wertpaare, die den Elementeigenschaften 'files[*].relatedFiles' entsprechen. Wenn vorhanden, wird ein Dateieintrag vom Typ "-related-file" dem nächstgelegenen Dateieintrag zugeordnet. Die folgenden Schlüssel werden unterstützt: path [erforderlich] lokaler Dateipfad zur zugehörigen Updatedatei ( properties inline-JSON-Objekt, das an den Downloadhandler übergeben wird). --related-file kann 1 oder mehr verwendet werden.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.