az image
Uwaga
Ta grupa poleceń zawiera polecenia zdefiniowane zarówno w interfejsie wiersza polecenia platformy Azure, jak i w co najmniej jednym rozszerzeniu. Zainstaluj każde rozszerzenie, aby korzystać z rozszerzonych możliwości. Dowiedz się więcej o rozszerzeniach.
Zarządzanie niestandardowymi obrazami maszyn wirtualnych.
Polecenia
Nazwa | Opis | Typ | Stan |
---|---|---|---|
az image builder |
Zarządzanie szablonami konstruktora obrazów i tworzenie ich. |
Podstawowe funkcje | Ogólna dostępność |
az image builder cancel |
Anuluj długotrwałą kompilację obrazu na podstawie szablonu obrazu. |
Podstawowe funkcje | Ogólna dostępność |
az image builder create |
Utwórz szablon konstruktora obrazów. |
Podstawowe funkcje | Ogólna dostępność |
az image builder customizer |
Zarządzanie konfiguratorami szablonów konstruktora obrazów. |
Podstawowe funkcje | Ogólna dostępność |
az image builder customizer add |
Dodaj konfigurator konstruktora obrazów do szablonu konstruktora obrazów. |
Podstawowe funkcje | Ogólna dostępność |
az image builder customizer clear |
Usuń wszystkie konfiguratory konstruktora obrazów z szablonu konstruktora obrazów. |
Podstawowe funkcje | Ogólna dostępność |
az image builder customizer remove |
Usuń konfigurator konstruktora obrazów z szablonu konstruktora obrazów. |
Podstawowe funkcje | Ogólna dostępność |
az image builder delete |
Usuń szablon konstruktora obrazów. |
Podstawowe funkcje | Ogólna dostępność |
az image builder error-handler |
Zarządzanie procedurą obsługi błędów szablonu konstruktora obrazów. |
Podstawowe funkcje | Ogólna dostępność |
az image builder error-handler add |
Dodaj procedurę obsługi błędów do istniejącego szablonu konstruktora obrazów. |
Podstawowe funkcje | Ogólna dostępność |
az image builder error-handler remove |
Usuń procedurę obsługi błędów z istniejącego szablonu konstruktora obrazów. |
Podstawowe funkcje | Ogólna dostępność |
az image builder error-handler show |
Pokaż procedurę obsługi błędów istniejącego szablonu konstruktora obrazów. |
Podstawowe funkcje | Ogólna dostępność |
az image builder identity |
Zarządzanie tożsamościami szablonu konstruktora obrazów. |
Podstawowe funkcje | Ogólna dostępność |
az image builder identity assign |
Dodaj tożsamości zarządzane do istniejącego szablonu konstruktora obrazów. Obecnie obsługiwana jest tylko jedna tożsamość użytkownika. |
Podstawowe funkcje | Ogólna dostępność |
az image builder identity remove |
Usuń tożsamości zarządzane z istniejącego szablonu konstruktora obrazów. |
Podstawowe funkcje | Ogólna dostępność |
az image builder identity show |
Wyświetlanie tożsamości zarządzanych szablonu konstruktora obrazów. |
Podstawowe funkcje | Ogólna dostępność |
az image builder list |
Wyświetlanie listy szablonów konstruktora obrazów. |
Podstawowe funkcje | Ogólna dostępność |
az image builder optimizer |
Zarządzaj optymalizatorem szablonów konstruktora obrazów. |
Podstawowe funkcje | Ogólna dostępność |
az image builder optimizer add |
Dodaj optymalizator do istniejącego szablonu konstruktora obrazów. |
Podstawowe funkcje | Ogólna dostępność |
az image builder optimizer remove |
Usuń optymalizator z istniejącego szablonu konstruktora obrazów. |
Podstawowe funkcje | Ogólna dostępność |
az image builder optimizer show |
Pokaż optymalizator istniejącego szablonu konstruktora obrazów. |
Podstawowe funkcje | Ogólna dostępność |
az image builder optimizer update |
Zaktualizuj optymalizator na podstawie istniejącego szablonu konstruktora obrazów. |
Podstawowe funkcje | Ogólna dostępność |
az image builder output |
Zarządzanie dystrybutorami wyjściowymi szablonu konstruktora obrazów. |
Podstawowe funkcje | Ogólna dostępność |
az image builder output add |
Dodaj dystrybutor danych wyjściowych konstruktora obrazów do szablonu konstruktora obrazów. |
Podstawowe funkcje | Ogólna dostępność |
az image builder output clear |
Usuń wszystkich dystrybutorów wyjściowych konstruktora obrazów z szablonu konstruktora obrazów. |
Podstawowe funkcje | Ogólna dostępność |
az image builder output remove |
Usuń dystrybutor danych wyjściowych konstruktora obrazów z szablonu konstruktora obrazów. |
Podstawowe funkcje | Ogólna dostępność |
az image builder output versioning |
Zarządzanie wersjonerem wyjściowym szablonu konstruktora obrazów. |
Podstawowe funkcje | Ogólna dostępność |
az image builder output versioning remove |
Usuń wszystkie opcje przechowywania wersji w określonych danych wyjściowych. |
Podstawowe funkcje | Ogólna dostępność |
az image builder output versioning set |
Ustaw program wersji wyjściowej konstruktora obrazów szablonu konstruktora obrazów. |
Podstawowe funkcje | Ogólna dostępność |
az image builder output versioning show |
Pokaż opcje przechowywania wersji dla określonych danych wyjściowych. |
Podstawowe funkcje | Ogólna dostępność |
az image builder run |
Tworzenie szablonu konstruktora obrazów. |
Podstawowe funkcje | Ogólna dostępność |
az image builder show |
Pokaż szablon konstruktora obrazów. |
Podstawowe funkcje | Ogólna dostępność |
az image builder show-runs |
Pokaż dane wyjściowe uruchamiania szablonu konstruktora obrazów. |
Podstawowe funkcje | Ogólna dostępność |
az image builder trigger |
Zarządzanie wyzwalaczem szablonu konstruktora obrazów. |
Podstawowe funkcje | Ogólna dostępność |
az image builder trigger create |
Utwórz wyzwalacz dla określonego szablonu obrazu maszyny wirtualnej. |
Podstawowe funkcje | Ogólna dostępność |
az image builder trigger delete |
Usuń wyzwalacz dla określonego szablonu obrazu maszyny wirtualnej. |
Podstawowe funkcje | Ogólna dostępność |
az image builder trigger list |
Wyświetl listę wszystkich wyzwalaczy dla określonego zasobu szablonu obrazu. |
Podstawowe funkcje | Ogólna dostępność |
az image builder trigger show |
Pobierz określony wyzwalacz dla określonego zasobu szablonu obrazu. |
Podstawowe funkcje | Ogólna dostępność |
az image builder trigger wait |
Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku. |
Podstawowe funkcje | Ogólna dostępność |
az image builder update |
Aktualizowanie szablonu konstruktora obrazów. |
Podstawowe funkcje | Ogólna dostępność |
az image builder validator |
Zarządzanie weryfikacją szablonu konstruktora obrazów. |
Podstawowe funkcje | Ogólna dostępność |
az image builder validator add |
Dodaj walidację do istniejącego szablonu konstruktora obrazów. |
Podstawowe funkcje | Ogólna dostępność |
az image builder validator remove |
Usuń walidację z istniejącego szablonu konstruktora obrazów. |
Podstawowe funkcje | Ogólna dostępność |
az image builder validator show |
Pokaż weryfikację istniejącego szablonu konstruktora obrazów. |
Podstawowe funkcje | Ogólna dostępność |
az image builder wait |
Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku szablonu. |
Podstawowe funkcje | Ogólna dostępność |
az image copy |
Skopiuj obraz zarządzany (lub maszynę wirtualną) do innych regionów. Wymaga, aby dysk źródłowy był dostępny. |
Numer wewnętrzny | Ogólna dostępność |
az image create |
Utwórz niestandardowy obraz maszyny wirtualnej na podstawie dysków zarządzanych lub migawek. |
Podstawowe funkcje | Ogólna dostępność |
az image delete |
Usuń obraz. |
Podstawowe funkcje | Ogólna dostępność |
az image list |
Lista obrazów w grupie zasobów. |
Podstawowe funkcje | Ogólna dostępność |
az image show |
Pobierz obraz. |
Podstawowe funkcje | Ogólna dostępność |
az image update |
Aktualizowanie niestandardowych obrazów maszyn wirtualnych. |
Podstawowe funkcje | Ogólna dostępność |
az image wait |
Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku. |
Podstawowe funkcje | Ogólna dostępność |
az image copy
Skopiuj obraz zarządzany (lub maszynę wirtualną) do innych regionów. Wymaga, aby dysk źródłowy był dostępny.
az image copy --source-object-name
--source-resource-group
--target-location
--target-resource-group
[--cleanup]
[--export-as-snapshot]
[--parallel-degree]
[--source-type {image, vm}]
[--tags]
[--target-name]
[--target-subscription]
[--temporary-resource-group-name]
[--timeout]
Przykłady
Skopiuj obraz do kilku regionów i wyczyść na końcu.
az image copy --source-resource-group mySources-rg --source-object-name myImage \
--target-location uksouth northeurope --target-resource-group "images-repo-rg" --cleanup
Użyj już uogólnionej maszyny wirtualnej do tworzenia obrazów w innych regionach.
az image copy --source-resource-group mySources-rg --source-object-name myVm \
--source-type vm --target-location uksouth northeurope --target-resource-group "images-repo-rg"
Parametry wymagane
Nazwa zasobu obrazu lub maszyny wirtualnej.
Nazwa grupy zasobów zasobu źródłowego.
Lista lokalizacji rozdzielonych spacjami w celu utworzenia obrazu w programie (np. westeurope itp.).
Nazwa grupy zasobów do utworzenia obrazów.
Parametry opcjonalne
Dołącz ten przełącznik, aby usunąć zasoby tymczasowe po zakończeniu.
Dołącz ten przełącznik, aby wyeksportować kopie jako migawki zamiast obrazów.
Liczba operacji kopiowania równoległego.
Obraz lub maszyna wirtualna.
Tagi rozdzielone spacjami: klucz[=wartość] [key[=value] ...]. Użyj ciągu "", aby wyczyścić istniejące tagi.
Nazwa obrazu końcowego, który zostanie utworzony.
Nazwa lub identyfikator subskrypcji, w której ma zostać utworzony końcowy obraz.
Nazwa grupy zasobów, w której zostanie utworzone tymczasowe konto magazynu.
Czas w sekundach zakończenia operacji kopiowania. Zwiększ ten czas, jeśli chcesz skopiować duże obrazy (dyski), takie jak 512 GB lub więcej.
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.
az image create
Utwórz niestandardowy obraz maszyny wirtualnej na podstawie dysków zarządzanych lub migawek.
az image create --name
--resource-group
--source
[--data-disk-caching {None, ReadOnly, ReadWrite}]
[--data-disk-sources]
[--edge-zone]
[--hyper-v-generation {V1, V2}]
[--location]
[--os-disk-caching {None, ReadOnly, ReadWrite}]
[--os-type {Linux, Windows}]
[--storage-sku {PremiumV2_LRS, Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS}]
[--tags]
[--zone-resilient {false, true}]
Przykłady
Utwórz obraz na podstawie istniejącego dysku.
az image create -g MyResourceGroup -n image1 --os-type Linux \
--source /subscriptions/db5eb68e-73e2-4fa8-b18a-0123456789999/resourceGroups/rg1/providers/Microsoft.Compute/snapshots/s1
Utwórz obraz, przechwytując istniejącą uogólnioną maszynę wirtualną w tej samej grupie zasobów.
az image create -g MyResourceGroup -n image1 --source MyVm1
Parametry wymagane
Nowa nazwa obrazu.
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>
.
Źródło dysku systemu operacyjnego z tego samego regionu, w tym identyfikator lub nazwa maszyny wirtualnej, identyfikator URI obiektu blob dysku systemu operacyjnego, identyfikator dysku zarządzanego systemu operacyjnego lub nazwa albo identyfikator migawki systemu operacyjnego lub nazwa.
Parametry opcjonalne
Typ buforowania magazynu dla dysku danych obrazu.
Rozdzielona spacjami lista źródeł dysków danych, w tym niezarządzany identyfikator URI obiektu blob, identyfikator dysku zarządzanego lub nazwa albo identyfikator migawki lub nazwa.
Nazwa strefy krawędzi.
Generacja funkcji hypervisor maszyny wirtualnej utworzona na podstawie obrazu.
Lokalizacja. Wartości z: az account list-locations
. Lokalizację domyślną można skonfigurować przy użyciu polecenia az configure --defaults location=<location>
.
Typ buforowania magazynu dla dysku systemu operacyjnego obrazu.
Jednostka SKU konta magazynu, za pomocą którego ma zostać utworzony obraz maszyny wirtualnej. Nieużywane, jeśli określono źródłową maszynę wirtualną.
Tagi rozdzielone spacjami: klucz[=wartość] [key[=value] ...]. Użyj ciągu "", aby wyczyścić istniejące tagi.
Określa, czy obraz jest odporny na strefy, czy nie. Wartość domyślna to „fałsz”. Obrazy odporne na strefy można tworzyć tylko w regionach, które zapewniają magazyn strefowo nadmiarowy.
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.
az image delete
Usuń obraz.
az image delete [--ids]
[--image-name]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--subscription]
Parametry opcjonalne
Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być pełny identyfikator zasobu zawierający wszystkie informacje o argumentach "Identyfikator zasobu". Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".
Nazwa obrazu.
Nie czekaj na zakończenie długotrwałej operacji.
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>
.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
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.
az image list
Lista obrazów w grupie zasobów.
az image list [--max-items]
[--next-token]
[--resource-group]
Parametry opcjonalne
Łączna liczba elementów do zwrócenia w danych wyjściowych polecenia. Jeśli łączna liczba dostępnych elementów jest większa niż określona wartość, token jest udostępniany w danych wyjściowych polecenia. Aby wznowić stronicowanie, podaj wartość tokenu w --next-token
argumencie kolejnego polecenia.
Token do określenia, gdzie rozpocząć stronicowanie. Jest to wartość tokenu z wcześniej obciętej odpowiedzi.
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>
.
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.
az image show
Pobierz obraz.
az image show [--expand]
[--ids]
[--image-name]
[--resource-group]
[--subscription]
Parametry opcjonalne
Wyrażenie expand, które ma być stosowane w operacji.
Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być pełny identyfikator zasobu zawierający wszystkie informacje o argumentach "Identyfikator zasobu". Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".
Nazwa obrazu.
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>
.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
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.
az image update
Aktualizowanie niestandardowych obrazów maszyn wirtualnych.
az image update [--add]
[--force-string]
[--ids]
[--name]
[--remove]
[--resource-group]
[--set]
[--subscription]
[--tags]
Przykłady
Dodawanie lub aktualizowanie tagów.
az image update -n ImageName -g ResourceGroup --tags tag1=val1 tag2=val2
Usuń wszystkie tagi.
az image update -n ImageName -g resourceGroup --tags
Parametry opcjonalne
Dodaj obiekt do listy obiektów, określając pary ścieżki i wartości klucza. Przykład: --add property.listProperty <key=value, string or JSON string>
.
W przypadku używania polecenia "set" lub "add" zachowaj literały ciągu zamiast próbować konwertować na format JSON.
Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być pełny identyfikator zasobu zawierający wszystkie informacje o argumentach "Identyfikator zasobu". Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".
Nazwa obrazu. Wymagany.
Usuń właściwość lub element z listy. Przykład: --remove property.list <indexToRemove>
OR --remove propertyToRemove
.
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>
.
Zaktualizuj obiekt, określając ścieżkę właściwości i wartość do ustawienia. Przykład: --set property1.property2=<value>
.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Tagi rozdzielone spacjami: klucz[=wartość] [key[=value] ...]. Użyj ciągu "", aby wyczyścić istniejące tagi.
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.
az image wait
Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku.
az image wait [--created]
[--custom]
[--deleted]
[--exists]
[--expand]
[--ids]
[--image-name]
[--interval]
[--resource-group]
[--subscription]
[--timeout]
[--updated]
Parametry opcjonalne
Zaczekaj na utworzenie polecenia "provisioningState" o godzinie "Succeeded".
Poczekaj, aż warunek spełnia niestandardowe zapytanie JMESPath. Np. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].
Poczekaj na usunięcie.
Zaczekaj, aż zasób istnieje.
Wyrażenie expand, które ma być stosowane w operacji.
Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być pełny identyfikator zasobu zawierający wszystkie informacje o argumentach "Identyfikator zasobu". Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".
Nazwa obrazu.
Interwał sondowania w sekundach.
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>
.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Maksymalny czas oczekiwania w sekundach.
Zaczekaj na zaktualizowanie stanu provisioningState o 'Powodzenie'.
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.