az image

Zarządzanie niestandardowymi obrazami maszyn wirtualnych.

Polecenia

az image builder	Zarządzanie szablonami konstruktora obrazów i tworzenie ich.
az image builder cancel	Anuluj długotrwałą kompilację obrazu na podstawie szablonu obrazu.
az image builder create	Utwórz szablon konstruktora obrazów.
az image builder customizer	Zarządzanie konfiguratorami szablonów konstruktora obrazów.
az image builder customizer add	Dodaj konfigurator konstruktora obrazów do szablonu konstruktora obrazów.
az image builder customizer clear	Usuń wszystkie konfiguratory konstruktora obrazów z szablonu konstruktora obrazów.
az image builder customizer remove	Usuń konfigurator konstruktora obrazów z szablonu konstruktora obrazów.
az image builder delete	Usuń szablon konstruktora obrazów.
az image builder list	Wyświetlanie listy szablonów konstruktora obrazów.
az image builder output	Zarządzanie dystrybutorami wyjściowymi szablonu konstruktora obrazów.
az image builder output add	Dodaj dystrybutora danych wyjściowych konstruktora obrazów do szablonu konstruktora obrazów.
az image builder output clear	Usuń wszystkich dystrybutorów wyjściowych konstruktora obrazów z szablonu konstruktora obrazów.
az image builder output remove	Usuń dystrybutora danych wyjściowych konstruktora obrazów z szablonu konstruktora obrazów.
az image builder run	Tworzenie szablonu konstruktora obrazów.
az image builder show	Pokaż szablon konstruktora obrazów.
az image builder show-runs	Pokaż dane wyjściowe uruchamiania szablonu konstruktora obrazów.
az image builder update	Aktualizowanie szablonu konstruktora obrazów.
az image builder wait	Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku szablonu.
az image copy	Skopiuj obraz zarządzany (lub maszynę wirtualną) do innych regionów. Wymaga ona udostępnienia dysku źródłowego.
az image create	Utwórz niestandardowy obraz maszyny wirtualnej na podstawie dysków zarządzanych lub migawek.
az image delete	Usuwa obraz.
az image list	Wyświetl listę niestandardowych obrazów maszyn wirtualnych.
az image show	Pobiera obraz.
az image update	Aktualizowanie niestandardowych obrazów maszyn wirtualnych.

az image copy

Skopiuj obraz zarządzany (lub maszynę wirtualną) do innych regionów. Wymaga ona udostępnienia dysku źródłowego.

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

--source-object-name

Nazwa obrazu lub zasobu maszyny wirtualnej.

--source-resource-group

Nazwa grupy zasobów zasobu źródłowego.

--target-location

Rozdzielona spacją lista lokalizacji, aby utworzyć obraz w programie (np. westeurope itp.).

--target-resource-group

Nazwa grupy zasobów do tworzenia obrazów.

Parametry opcjonalne

--cleanup

Dołącz ten przełącznik, aby usunąć zasoby tymczasowe po zakończeniu.

--export-as-snapshot

Dołącz ten przełącznik, aby wyeksportować kopie jako migawki zamiast obrazów.

--parallel-degree

Liczba operacji kopiowania równoległego.

wartość domyślna: -1

--source-type

Obraz lub maszyna wirtualna.

akceptowane wartości: image, vm

wartość domyślna: image

--tags

Tagi rozdzielone spacjami: klucz[=wartość] [klucz[=wartość] ...]. Użyj ciągu "", aby wyczyścić istniejące tagi.

--target-name

Nazwa obrazu końcowego, który zostanie utworzony.

--target-subscription

Nazwa lub identyfikator subskrypcji, w której ma zostać utworzony końcowy obraz.

--temporary-resource-group-name --temporary_resource_group_name

Nazwa grupy zasobów, w której zostanie utworzone tymczasowe konto magazynu. --temporary_resource_group_name zostanie wycofana w wersji 0.2.7.

wartość domyślna: image-copy-rg

--timeout

Czas w sekundach zakończenia operacji kopiowania. Zwiększ ten czas, jeśli zamierzasz skopiować duże obrazy (dyski), takie jak 512 GB lub więcej.

wartość domyślna: 3600

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.

--query

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

--subscription

Nazwa lub identyfikator subskrypcji. Możesz skonfigurować domyślną subskrypcję przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj polecenia --debug, 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ólnionej maszyny wirtualnej w tej samej grupie zasobów.

az image create -g MyResourceGroup -n image1 --source MyVm1

Parametry wymagane

--name -n

Nowa nazwa obrazu.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--source

Źródło dysku systemu operacyjnego z tego samego regionu, w tym identyfikator lub nazwa maszyny wirtualnej, identyfikator URI lub nazwa dysku dysku systemu operacyjnego, identyfikator dysku systemu operacyjnego lub nazwa dysku systemu operacyjnego.

Parametry opcjonalne

--data-disk-caching

Typ buforowania magazynu dla dysku danych obrazu.

akceptowane wartości: None, ReadOnly, ReadWrite

--data-disk-sources

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.

--edge-zone

Nazwa strefy krawędzi.

--hyper-v-generation

Generowanie funkcji hypervisor maszyny wirtualnej utworzonej na podstawie obrazu.

akceptowane wartości: V1, V2

wartość domyślna: V1

--location -l

Lokalizacja. Wartości z: az account list-locations. Lokalizację domyślną można skonfigurować przy użyciu polecenia az configure --defaults location=<location>.

--os-disk-caching

Typ buforowania magazynu dla dysku systemu operacyjnego obrazu.

akceptowane wartości: None, ReadOnly, ReadWrite

--os-type

akceptowane wartości: Linux, Windows

--storage-sku

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ą.

akceptowane wartości: PremiumV2_LRS, Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS

--tags

Tagi rozdzielone spacjami: klucz[=wartość] [klucz[=wartość] ...]. Użyj ciągu "", aby wyczyścić istniejące tagi.

--zone-resilient

Określa, czy obraz jest odporny na strefy, czy nie. Wartość domyślna to false. Obrazy odporne na strefy można tworzyć tylko w regionach, które zapewniają strefowo nadmiarowy magazyn.

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.

--query

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

--subscription

Nazwa lub identyfikator subskrypcji. Możesz skonfigurować domyślną subskrypcję przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

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

az image delete

Usuwa obraz.

az image delete [--ids]
                [--name]
                [--resource-group]

Parametry opcjonalne

--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacją). Powinien to być kompletny identyfikator zasobu zawierający wszystkie informacje o argumentach "Identyfikator zasobu". Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

--name -n

Nazwa obrazu.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults 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.

--query

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

--subscription

Nazwa lub identyfikator subskrypcji. Możesz skonfigurować domyślną subskrypcję przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

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

az image list

Wyświetl listę niestandardowych obrazów maszyn wirtualnych.

az image list [--resource-group]

Parametry opcjonalne

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults 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.

--query

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

--subscription

Nazwa lub identyfikator subskrypcji. Możesz skonfigurować domyślną subskrypcję przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

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

az image show

Pobiera obraz.

az image show [--expand]
              [--ids]
              [--name]
              [--resource-group]

Parametry opcjonalne

--expand

Wyrażenie rozwiń, które ma być stosowane w operacji. Wartość domyślna to Brak.

--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacją). Powinien to być kompletny identyfikator zasobu zawierający wszystkie informacje o argumentach "Identyfikator zasobu". Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

--name -n

Nazwa obrazu.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults 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.

--query

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

--subscription

Nazwa lub identyfikator subskrypcji. Możesz skonfigurować domyślną subskrypcję przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj polecenia --debug, 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]
                [--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

--add

Dodaj obiekt do listy obiektów, określając pary ścieżki i wartości klucza. Przykład: --add property.listProperty <key=value, string lub JSON string>.

--force-string

W przypadku używania polecenia "set" lub "add" zachowaj literały ciągu zamiast próbować przekonwertować na kod JSON.

--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacją). Powinien to być kompletny identyfikator zasobu zawierający wszystkie informacje o argumentach "Identyfikator zasobu". Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

--name -n

Nazwa obrazu.

--remove

Usuń właściwość lub element z listy. Przykład: --remove property.list OR --remove propertyToRemove.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--set

Zaktualizuj obiekt, określając ścieżkę właściwości i wartość do ustawienia. Przykład: --set property1.property2=.

--tags

Tagi rozdzielone spacjami: klucz[=wartość] [klucz[=wartość] ...]. Użyj ciągu "", aby wyczyścić istniejące tagi.

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.

--query

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

--subscription

Nazwa lub identyfikator subskrypcji. Możesz skonfigurować domyślną subskrypcję przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

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