Udostępnij przez

az iot du update init

  • Wersja zapoznawcza

Note

Ta dokumentacja jest częścią rozszerzenia azure-iot dla interfejsu wiersza polecenia platformy Azure (wersja 2.67.0 lub nowsza). Rozszerzenie zostanie automatycznie zainstalowane przy pierwszym uruchomieniu polecenia az iot du update init. Dowiedz się więcej o rozszerzeniach.

Ta grupa poleceń jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Narzędzie do inicjowania manifestu importu.

Polecenia

Nazwa Opis Typ Stan
az iot du update init v5

Zainicjuj manifest importu w wersji 5 z żądanym stanem.

 Extension Preview

az iot du update init v5

Wersja zapoznawcza

Grupa poleceń "iot du update init" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Zainicjuj manifest importu w wersji 5 z żądanym stanem.

To polecenie obsługuje wszystkie atrybuty manifestu importu w wersji 5. Należy pamiętać, że istnieje czułość pozycyjna między --step i --file, a także --file .--related-file Przejrzyj przykłady i opisy parametrów, aby uzyskać szczegółowe informacje na temat sposobu pełnego wykorzystania operacji.

Przeczytaj więcej na temat używania cudzysłowów i znaków ucieczki w różnych powłokach tutaj: 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]

Przykłady

Zainicjuj minimalny manifest importowania zawartości. Wbudowany kod json zoptymalizowany pod kątem powłoki "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

Zainicjuj minimalny manifest importowania zawartości. Wbudowany kod json zoptymalizowany pod kątem polecenia "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

Zainicjuj minimalny manifest importowania zawartości. Wbudowany kod json zoptymalizowany pod kątem polecenia "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

Zainicjuj minimalny manifest importowania zawartości. Użyj danych wejściowych pliku dla formatu 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

Zainicjuj niewdróżniową aktualizację liścia, do których ma się odwoływać w ramach aktualizacji dołączonej. Wbudowany kod json zoptymalizowany pod kątem powłoki "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

Zainicjuj aktualizację pakietu odwołującą się do aktualizacji liścia, a także definiowanie niezależnych kroków. Przykład zoptymalizowany pod kątem powłoki "bash" przy użyciu kontynuacji polecenia w celu wyliniowania segmentów manifestu importu.

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

Parametry wymagane

--compat

Pary klucz=wartość rozdzielane spacjami odpowiadające właściwościom urządzenia, z które ta aktualizacja jest zgodna. Zazwyczaj używane do definiowania właściwości, takich jak producent i model. --compat może być używany co najmniej 1 razy.

--step

Pary klucz=wartość rozdzielane spacjami odpowiadające właściwościom elementu "instructions.steps". Klient określi, czy krok jest krokiem wbudowanym lub referencyjnym w oparciu o podane pary wartości klucza. Jeśli krok śródliniowy lub referencyjny może być spełniony, krok odwołania będzie mieć priorytet. Użycie --file zostanie skojarzone z najbliższym wbudowanym wpisem --step, wyprowadzając wartość dla "files". Obsługiwane są następujące klucze kroków referencyjnych: updateId.provider, updateId.name, updateId.version i description. Obsługiwane są następujące wbudowane klucze kroków: handler (np. "microsoft/script:1" lub "microsoft/swupdate:1" lub "microsoft/apt:1"), properties (wbudowany obiekt json, który agent przekaże do programu obsługi) i description. --Krok może być używany 1 lub więcej razy.

--update-name

Nazwa aktualizacji jako składnik updateId.

--update-provider

Dostawca aktualizacji jako składnik updateId.

--update-version

Wersja aktualizacji jako składnik updateId.

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--description

Opis manifestu importu.

--file

Pary klucz=wartość rozdzielane spacjami odpowiadające właściwościom elementu "files". Wpis --file może zawierać najbliższe wpisy --related-file, jeśli podano. Obsługiwane są następujące klucze: path [wymagane] lokalnej ścieżki pliku do aktualizacji pliku, downloadHandler (np. "microsoft/delta:1") procedury obsługi w celu wykorzystania powiązanych plików do pobrania pliku ładunku, properties (obiekt json w wierszu, który agent przekaże do programu obsługi). --file może być używany 1 lub więcej razy.

--is-deployable

Wskazuje, czy aktualizacja jest niezależnie wdrażana.

Właściwość Wartość
Dopuszczalne wartości: false, true
--no-validation

Wyłącza weryfikację schematu json po stronie klienta dla zawartości manifestu importu.

Właściwość Wartość
Dopuszczalne wartości: false, true
--related-file

Pary klucz=wartość rozdzielane spacjami odpowiadające właściwościom elementu "files[*].relatedFiles". Wpis --related-file zostanie skojarzony z najbliższym wpisem --file, jeśli istnieje. Obsługiwane są następujące klucze: path [wymagane] lokalnej ścieżki pliku do powiązanego pliku aktualizacji, properties (obiekt json w wierszu przekazany do procedury obsługi pobierania). --related-file może być używany 1 lub więcej razy.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False