az iot du update init
Uwaga
Ta dokumentacja jest częścią rozszerzenia azure-iot dla interfejsu wiersza polecenia platformy Azure (wersja 2.46.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. |
Numer wewnętrzny | Wersja Preview |
az iot du update init v5
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
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.
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
i description
updateId.version
. Obsługiwane są następujące wbudowane klucze kroków: (np. handler
"microsoft/script:1" lub "microsoft/swupdate:1" lub "microsoft/apt:1"), properties
(wbudowany obiekt json, który agent przekaże do procedury obsługi) i description
. --Krok może być używany 1 lub więcej razy.
Nazwa aktualizacji jako składnik updateId.
Dostawca aktualizacji jako składnik updateId.
Wersja aktualizacji jako składnik updateId.
Parametry opcjonalne
Opis manifestu importu.
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: [required] lokalna ścieżka pliku do aktualizacji pliku, downloadHandler
(np. path
program obsługi "microsoft/delta:1") do używania powiązanych plików do pobierania pliku properties
ładunku (w wierszu obiektu json agent zostanie przekazany do programu obsługi). --file może być używany 1 lub więcej razy.
Wskazuje, czy aktualizacja jest niezależnie wdrażana.
Wyłącza weryfikację schematu json po stronie klienta dla zawartości manifestu importu.
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
[required] lokalna ścieżka pliku do powiązanego pliku properties
aktualizacji (obiekt json w wierszu przekazany do procedury obsługi pobierania). --related-file może być używany 1 lub więcej razy.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.