az iot du update

  • Odwołanie

Uwaga

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

Zarządzanie aktualizacjami aktualizacji urządzeń.

Polecenia

Nazwa Opis Typ Stan
az iot du update calculate-hash

Oblicz skróconą reprezentację pliku w formacie base64.

 Numer wewnętrzny Ogólna dostępność
az iot du update delete

Usuń określoną wersję aktualizacji.

 Numer wewnętrzny Ogólna dostępność
az iot du update file

Aktualizowanie operacji na plikach.

 Numer wewnętrzny Ogólna dostępność
az iot du update file list

Wyświetl identyfikatory plików aktualizacji w odniesieniu do dostawcy aktualizacji, nazwy i wersji.

 Numer wewnętrzny Ogólna dostępność
az iot du update file show

Pokaż szczegóły określonego pliku aktualizacji w odniesieniu do dostawcy aktualizacji, nazwy i wersji.

 Numer wewnętrzny Ogólna dostępność
az iot du update import

Zaimportuj nową wersję aktualizacji do wystąpienia usługi Device Update.

 Numer wewnętrzny Ogólna dostępność
az iot du update init

Narzędzie do inicjowania manifestu importu.

 Numer wewnętrzny Wersja zapoznawcza
az iot du update init v5

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

 Numer wewnętrzny Wersja zapoznawcza
az iot du update list

Wyświetl listę aktualizacji, które zostały zaimportowane do wystąpienia usługi Device Update.

 Numer wewnętrzny Ogólna dostępność
az iot du update show

Pokaż określoną wersję aktualizacji.

 Numer wewnętrzny Ogólna dostępność
az iot du update stage

Przygotowywanie aktualizacji do importowania do wystąpienia docelowego.

 Numer wewnętrzny Wersja zapoznawcza

az iot du update calculate-hash

Oblicz skróconą reprezentację pliku w formacie base64.

az iot du update calculate-hash --file-path
                                [--hash-algo {sha256}]

Przykłady

Oblicz reprezentację base64 skrótu sha256 dla docelowego pliku aktualizacji.

az iot du update calculate-hash --file-path /path/to/file

Oblicz reprezentację base64 skrótu sha256 dla wielu docelowych plików aktualizacji.

az iot du update calculate-hash --file-path /path/to/file1 --file-path /path/to/file2 --file-path /path/to/file3

Parametry wymagane

--file-path -f

Ścieżka lokalna do pliku docelowego na potrzeby obliczania skrótu. --file-path może być używany 1 lub więcej razy.

Parametry opcjonalne

--hash-algo

Algorytm kryptograficzny do użycia na potrzeby tworzenia skrótów.

akceptowane wartości: sha256
wartość domyślna: sha256
Parametry globalne
--debug

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

--help -h

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

--only-show-errors

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

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--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 polecenia az account set -s NAME_OR_ID.

--verbose

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

az iot du update delete

Usuń określoną wersję aktualizacji.

az iot du update delete --account
                        --instance
                        --un
                        --up
                        --update-version
                        [--no-wait]
                        [--resource-group]
                        [--yes {false, true}]

Przykłady

Usuń aktualizację docelową w odniesieniu do dostawcy aktualizacji, nazwy i wersji.

az iot du update delete -n {account_name} -i {instance_name} --update-provider {provider_name} --update-name {update_name} --update-version {update_version}

Parametry wymagane

--account -n

Nazwa konta usługi Device Update. Domyślną nazwę konta można skonfigurować przy użyciu polecenia az config set defaults.adu_account=<name>.

--instance -i

Nazwa wystąpienia usługi Device Update. Nazwę wystąpienia domyślnego można skonfigurować przy użyciu polecenia az config set defaults.adu_instance=<name>.

--un --update-name

Nazwa aktualizacji.

--up --update-provider

Dostawca aktualizacji.

--update-version --uv

Wersja aktualizacji.

Parametry opcjonalne

--no-wait

Nie czekaj na zakończenie długotrwałej operacji.

wartość domyślna: False
--resource-group -g

Nazwa grupy zasobów konta usługi Device Update. Grupę domyślną można skonfigurować przy użyciu polecenia az config set defaults.adu_group=<name>.

--yes -y

Pomiń monity użytkownika. Wskazuje akceptację akcji. Używane głównie w scenariuszach automatyzacji. Wartość domyślna: false.

akceptowane wartości: false, true
Parametry globalne
--debug

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

--help -h

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

--only-show-errors

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

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--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 polecenia az account set -s NAME_OR_ID.

--verbose

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

az iot du update import

Zaimportuj nową wersję aktualizacji do wystąpienia usługi Device Update.

To polecenie obsługuje --defer możliwość. W przypadku użycia polecenia zapisze ładunek obiektu przeznaczony do wysłania na platformę Azure w lokalnej pamięci podręcznej. Następne użycie tego polecenia bez --defer połączenia nowego ładunku żądania z obiektami buforowanym wysyłającymi je razem.

Po pomyślnym pomyślnym przeczyszczeniu odpowiedniego lokalnego wpisu pamięci podręcznej. Jeśli wystąpi błąd, zawartość pamięci podręcznej nie zostanie usunięta. Użyj az cache poleceń, aby niezależnie zarządzać wpisami lokalnej pamięci podręcznej.

Obsługa odroczenia jest przeznaczona głównie dla aktualizacji z wieloma krokami referencyjnymi, dzięki czemu aktualizacje nadrzędne i podrzędne można przesyłać razem.

az iot du update import --account
                        --instance
                        --url
                        [--defer]
                        [--file]
                        [--friendly-name]
                        [--hashes]
                        [--no-wait]
                        [--resource-group]
                        [--size]

Przykłady

Zaimportuj aktualizację z dwoma powiązanymi plikami i bez kroków referencyjnych, jawnie podając wartość skrótu manifestu i rozmiar manifestu w bajtach.

az iot du update import -n {account_name} -i {instance_name} --hashes sha256={hash_value} --size {size_in_bytes} --url {manifest_location} --file filename={file1_name} url={file1_url} --file filename={file2_name} url={file2_url}

Zaimportuj aktualizację z dwoma powiązanymi plikami i bez kroków referencyjnych, umożliwiając interfejsowi wiersza polecenia obliczenie wartości skrótu manifestu i rozmiaru w bajtach.

az iot du update import -n {account_name} -i {instance_name} --url {manifest_location} --file filename={file1_name} url={file1_url} --file filename={file2_name} url={file2_url}

Zaimportuj aktualizację nadrzędną z dwoma podrzędnymi krokami odwołania aktualizacji, w których wszystkie trzy manifesty importu mają jeden powiązany plik. Pozwól interfejsowi wiersza polecenia obliczyć wartość skrótu i rozmiar w bajtach dla wszystkich. Ta operacja będzie polegać na możliwości "--defer".

az iot du update import -n {account_name} -i {instance_name} --url {parent_manifest_location} --file filename={parent_file_name} url={parent_file_url} --defer

az iot du update import -n {account_name} -i {instance_name} --url {child1_manifest_location} --file filename={child1_file_name} url={child1_file_url} --defer

az iot du update import -n {account_name} -i {instance_name} --url {child2_manifest_location} --file filename={child2_file_name} url={child2_file_url}

Parametry wymagane

--account -n

Nazwa konta usługi Device Update. Domyślną nazwę konta można skonfigurować przy użyciu polecenia az config set defaults.adu_account=<name>.

--instance -i

Nazwa wystąpienia usługi Device Update. Nazwę wystąpienia domyślnego można skonfigurować przy użyciu polecenia az config set defaults.adu_instance=<name>.

--url

Lokalizacja routingu, z której manifest importu można pobrać za pomocą usługi Device Update dla usługi IoT Hub. Jest to zazwyczaj adres URL obiektu blob chronionego tylko do odczytu z wygaśnięciem ustawionym na co najmniej 3 godziny.

Parametry opcjonalne

--defer

Tymczasowo przechowuj obiekt w lokalnej pamięci podręcznej zamiast wysyłania na platformę Azure. Użyj az cache poleceń, aby wyświetlić/wyczyścić.

--file

Pary klucz=wartość rozdzielane spacjami odpowiadające właściwościom pliku metadanych manifestu. Wymagane klucze obejmują nazwę pliku i adres URL. --file może być używany 1 lub więcej razy.

--friendly-name

Przyjazna nazwa skojarzona z definicją aktualizacji.

--hashes

Pary klucz=wartość rozdzielane spacjami, w których klucz jest używanym algorytmem skrótu, a wartość jest skrótem pliku manifestu importu zakodowanego w formacie base64. Wymagany jest co najmniej wpis sha256. Jeśli nie zostanie podana, zostanie ona obliczona na podstawie podanego adresu URL.

--no-wait

Nie czekaj na zakończenie długotrwałej operacji.

wartość domyślna: False
--resource-group -g

Nazwa grupy zasobów konta usługi Device Update. Grupę domyślną można skonfigurować przy użyciu polecenia az config set defaults.adu_group=<name>.

--size

Rozmiar pliku w liczbie bajtów. Jeśli nie zostanie podana, zostanie ona obliczona na podstawie podanego adresu URL.

Parametry globalne
--debug

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

--help -h

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

--only-show-errors

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

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--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 polecenia az account set -s NAME_OR_ID.

--verbose

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

az iot du update list

Wyświetl listę aktualizacji, które zostały zaimportowane do wystąpienia usługi Device Update.

Podczas wyświetlania listy dostawców aktualizacji należy podać tylko flagę --by-provider oprócz typowych argumentów wyszukiwania wystąpień. Podczas wyświetlania listy nazw aktualizacji należy podać dostawcę aktualizacji. Podczas wyświetlania listy wersji aktualizacji należy podać dostawcę aktualizacji i nazwę aktualizacji.

az iot du update list --account
                      --instance
                      [--by-provider {false, true}]
                      [--filter]
                      [--resource-group]
                      [--search]
                      [--un]
                      [--up]

Przykłady

Wyświetl listę wszystkich aktualizacji.

az iot du update list -n {account_name} -i {instance_name}

Wyświetl listę wszystkich aktualizacji spełniających kryteria wyszukiwania bez tekstu, w tym przypadku dostawcy aktualizacji firmy Contoso.

az iot du update list -n {account_name} -i {instance_name} --search 'Contoso'

Wyświetl listę wszystkich aktualizacji spełniających filtr odata, w tym przypadku filtrowanie pod kątem aktualizacji, które nie można wdrożyć.

az iot du update list -n {account_name} -i {instance_name} --filter 'isDeployable eq false'

Wyświetl listę wszystkich dostawców aktualizacji.

az iot du update list -n {account_name} -i {instance_name} --by-provider

Wyświetl listę wszystkich nazw aktualizacji według dostawcy aktualizacji.

az iot du update list -n {account_name} -i {instance_name} --update-provider {provider_name}

Wyświetl listę wszystkich wersji aktualizacji według dostawcy aktualizacji i nazwę aktualizacji.

az iot du update list -n {account_name} -i {instance_name} --update-provider {provider_name} --update-name {update_name}

Parametry wymagane

--account -n

Nazwa konta usługi Device Update. Domyślną nazwę konta można skonfigurować przy użyciu polecenia az config set defaults.adu_account=<name>.

--instance -i

Nazwa wystąpienia usługi Device Update. Nazwę wystąpienia domyślnego można skonfigurować przy użyciu polecenia az config set defaults.adu_instance=<name>.

Parametry opcjonalne

--by-provider

Flaga wskazująca, że zestaw wyników powinien być ograniczony do aktualizacji dostawców.

akceptowane wartości: false, true
--filter

Ogranicza zestaw aktualizacji zwracanych przez wartości właściwości. Obsługiwane w przypadku wyświetlania listy aktualizacji bez ograniczeń ani wyświetlania listy według wersji.

--resource-group -g

Nazwa grupy zasobów konta usługi Device Update. Grupę domyślną można skonfigurować przy użyciu polecenia az config set defaults.adu_group=<name>.

--search

Żądanie aktualizacji pasujących do wyrażenia wyszukiwania w formacie swobodnym. Obsługiwane podczas wyświetlania listy aktualizacji bez ograniczeń.

--un --update-name

Nazwa aktualizacji.

--up --update-provider

Dostawca aktualizacji.

Parametry globalne
--debug

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

--help -h

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

--only-show-errors

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

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--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 polecenia az account set -s NAME_OR_ID.

--verbose

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

az iot du update show

Pokaż określoną wersję aktualizacji.

az iot du update show --account
                      --instance
                      --un
                      --up
                      --update-version
                      [--resource-group]

Przykłady

Pokaż określoną aktualizację w odniesieniu do dostawcy aktualizacji, nazwy i wersji.

az iot du update show -n {account_name} -i {instance_name} --update-provider {provider_name} --update-name {update_name} --update-version {update_version}

Parametry wymagane

--account -n

Nazwa konta usługi Device Update. Domyślną nazwę konta można skonfigurować przy użyciu polecenia az config set defaults.adu_account=<name>.

--instance -i

Nazwa wystąpienia usługi Device Update. Nazwę wystąpienia domyślnego można skonfigurować przy użyciu polecenia az config set defaults.adu_instance=<name>.

--un --update-name

Nazwa aktualizacji.

--up --update-provider

Dostawca aktualizacji.

--update-version --uv

Wersja aktualizacji.

Parametry opcjonalne

--resource-group -g

Nazwa grupy zasobów konta usługi Device Update. Grupę domyślną można skonfigurować przy użyciu polecenia az config set defaults.adu_group=<name>.

Parametry globalne
--debug

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

--help -h

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

--only-show-errors

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

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--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 polecenia az account set -s NAME_OR_ID.

--verbose

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

az iot du update stage

Wersja zapoznawcza

To polecenie jest w wersji zapoznawczej i jest opracowywane. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Przygotowywanie aktualizacji do importowania do wystąpienia docelowego.

Przemieszczanie aktualizacji oznacza przyspieszenie kroków wstępnych importowania aktualizacji do wystąpienia docelowego. W przypadku danego manifestu importu proces określi odpowiednie pliki, wypchnie je do żądanego kontenera magazynu, wygeneruj identyfikatory URI sygnatury dostępu współdzielonego i obejmie inne kroki przygotowania do udanego importu.

To polecenie zależy od konwencji opartej na organizacji plików aktualizacji. Wszystkie pliki aktualizacji manifestu docelowego powinny znajdować się w tym samym katalogu, w którym znajduje się manifest importu.

Dostęp oparty na kluczach służy do przekazywania artefaktów obiektów blob i generowania 3-godzinnych identyfikatorów URI sygnatur dostępu współdzielonego z dostępem do odczytu.

Jeśli --then-import zostanie podana flaga, polecenie zaimportuje aktualizację etapową. W przeciwnym razie wynikiem tej operacji jest polecenie importu, które ma zostać uruchomione, aby osiągnąć ten sam wynik w późniejszym czasie.

To polecenie spowoduje przeczyszczenie i odświeżenie dowolnego lokalnego wpisu pamięci podręcznej dla wystąpienia docelowego.

az iot du update stage --account
                       --instance
                       --manifest-path
                       --storage-account
                       --storage-container
                       [--friendly-name]
                       [--overwrite {false, true}]
                       [--resource-group]
                       [--storage-subscription]
                       [--then-import {false, true}]

Przykłady

Przygotuj autonomiczną aktualizację. Oczekuje się, że pliki aktualizacji znajdują się w tym samym katalogu co manifest. Wynikowe polecenie importu można wykonać w późniejszym czasie, aby zainicjować importowanie przygotowanej aktualizacji przed wygaśnięciem tokenu SAS.

az iot du update stage -n {account_name} -i {instance_name} --storage-account {storage_account_name} --storage-container {storage_container_name} --manifest-path /path/to/manifest.json

Przygotuj autonomiczną aktualizację. Po przejściu zaimportuj aktualizację do wystąpienia przy użyciu żądanej przyjaznej nazwy.

az iot du update stage -n {account_name} -i {instance_name} --storage-account {storage_account_name} --storage-container {storage_container_name} --manifest-path /path/to/manifest.json --then-import --friendly-name myAptUpdate

Przygotuj aktualizację z wieloma odwołaniami. Pliki aktualizacji zostaną przekazane do kontenera obiektów blob magazynu znajdującego się w innej subskrypcji do konta aktualizacji.

az iot du update stage -n {account_name} -i {instance_name} --storage-account {storage_account_name} --storage-container {storage_container_name} --storage-subscription {storage_account_subscription} --manifest-path /path/to/parent/parent.manifest.json --manifest-path /path/to/leaf1/leaf1.manifest.json --manifest-path /path/to/leaf2/leaf2.manifest.json

Przygotuj aktualizację z wieloma odwołaniami, zastępując istniejące obiekty blob, jeśli istnieją. Po przejściu do inscenizacji zaimportuj aktualizację do wystąpienia.

az iot du update stage -n {account_name} -i {instance_name} --storage-account {storage_account_name} --storage-container {storage_container_name} --manifest-path /path/to/parent/parent.manifest.json --manifest-path /path/to/leaf1/leaf1.manifest.json --manifest-path /path/to/leaf2/leaf2.manifest.json --then-import --overwrite

Parametry wymagane

--account -n

Nazwa konta usługi Device Update. Domyślną nazwę konta można skonfigurować przy użyciu polecenia az config set defaults.adu_account=<name>.

--instance -i

Nazwa wystąpienia usługi Device Update. Nazwę wystąpienia domyślnego można skonfigurować przy użyciu polecenia az config set defaults.adu_instance=<name>.

--manifest-path

Ścieżka pliku lokalnego do manifestu importu, który powinien zostać przygotowany. Można użyć co najmniej 1 razy.

--storage-account

Żądana nazwa konta magazynu do etapu importowania artefaktów manifestu.

--storage-container

Żądana nazwa kontenera magazynu do etapu importowania artefaktów manifestu.

Parametry opcjonalne

--friendly-name

Przyjazna nazwa skojarzona z definicją aktualizacji.

--overwrite

Flaga wskazująca, czy istniejące obiekty blob powinny zostać zastąpione, jeśli istnieje konflikt.

akceptowane wartości: false, true
wartość domyślna: False
--resource-group -g

Nazwa grupy zasobów konta usługi Device Update. Grupę domyślną można skonfigurować przy użyciu polecenia az config set defaults.adu_group=<name>.

--storage-subscription

Żądana subskrypcja konta magazynu do etapu importowania artefaktów manifestu. Dotyczy to, gdy konta magazynu i aktualizacji urządzeń znajdują się w różnych subskrypcjach.

--then-import

Flaga wskazująca, czy aktualizacja ma zostać zaimportowana po przejściu przejściowym.

akceptowane wartości: false, true
Parametry globalne
--debug

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

--help -h

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

--only-show-errors

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

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--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 polecenia az account set -s NAME_OR_ID.

--verbose

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