az iot du update init

Vorschau

Note

Diese Referenz ist Teil der Azure-iot-Erweiterung für die Azure CLI (Version 2.67.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie ein az iot du update init Befehl ausführen. Erfahren Sie mehr über 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.	Extension	Preview

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.name, updateId.version und 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

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--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 für die Verwendung 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.

Eigenschaft	Wert
Zulässige Werte:	false, true

--no-validation

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

Eigenschaft	Wert
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] lokalen Dateipfad zur zugehörigen Updatedatei, properties (an den Downloadhandler übergebenes JSON-Objekt). --related-file kann 1 oder mehr verwendet werden.

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Ausgabeformat.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

Feedback

War diese Seite hilfreich?