az vm extension

Zarządzanie rozszerzeniami na maszynach wirtualnych.

Rozszerzenia to małe aplikacje, które zapewniają konfigurację po wdrożeniu i zadania automatyzacji na maszynach wirtualnych platformy Azure. Jeśli na przykład maszyna wirtualna wymaga instalacji oprogramowania, ochrony przed wirusami lub konfiguracji platformy Docker, rozszerzenie maszyny wirtualnej może służyć do wykonywania tych zadań. Rozszerzenia można powiązać z nowym wdrożeniem maszyny wirtualnej lub uruchamiać względem dowolnego istniejącego systemu.

Polecenia

Nazwa	Opis	Typ	Stan
az vm extension delete	Operacja usuwania w celu usunięcia rozszerzenia.	Core	ogólna dostępność
az vm extension image	Znajdź dostępne rozszerzenia maszyn wirtualnych dla subskrypcji i regionu.	Core	ogólna dostępność
az vm extension image list	Wyświetl listę informacji o dostępnych rozszerzeniach.	Core	ogólna dostępność
az vm extension image list-names	Lista nazw dostępnych rozszerzeń.	Core	ogólna dostępność
az vm extension image list-versions	Wyświetl listę wersji dostępnych rozszerzeń.	Core	ogólna dostępność
az vm extension image show	Wyświetlanie informacji o rozszerzeniu.	Core	ogólna dostępność
az vm extension list	Wyświetl listę rozszerzeń dołączonych do maszyny wirtualnej.	Core	ogólna dostępność
az vm extension set	Ustawianie rozszerzeń dla maszyny wirtualnej.	Core	ogólna dostępność
az vm extension show	Wyświetlanie informacji o rozszerzeniach dołączonych do maszyny wirtualnej.	Core	ogólna dostępność
az vm extension wait	Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku.	Core	ogólna dostępność

az vm extension delete

Edytuj

Operacja usuwania w celu usunięcia rozszerzenia.

az vm extension delete [--ids]
                       [--name --vm-extension-name]
                       [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                       [--resource-group]
                       [--subscription]
                       [--vm-name]

Przykłady

Użyj nazwy i rozszerzenia maszyny wirtualnej, aby usunąć rozszerzenie z maszyny wirtualnej.

az vm extension delete -g MyResourceGroup --vm-name MyVm -n MyExtensionName

Usuń rozszerzenia z identyfikatorami zawierającymi ciąg "MyExtension" z maszyny wirtualnej.

az vm extension delete --ids $(az resource list --query "[?contains(name, 'MyExtension')].id" -o tsv)

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.

--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być kompletny identyfikator zasobu, zawierający wszystkie informacje dotyczące argumentów „Identyfikator zasobu”. Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

Właściwość	Wartość
Grupa parametrów:	Resource Id Arguments

--name --vm-extension-name -n

Nazwa rozszerzenia maszyny wirtualnej.

Właściwość	Wartość
Grupa parametrów:	Resource Id Arguments

--no-wait

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

Właściwość	Wartość
Dopuszczalne wartości:	0, 1, f, false, n, no, t, true, y, yes

--resource-group -g

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

Właściwość	Wartość
Grupa parametrów:	Resource Id Arguments

--subscription

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

Właściwość	Wartość
Grupa parametrów:	Resource Id Arguments

--vm-name

Nazwa maszyny wirtualnej. Wartość domyślną można skonfigurować przy użyciu polecenia az configure --defaults vm=<name>.

Właściwość	Wartość
Grupa parametrów:	Resource Id Arguments

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.

--verbose

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

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

az vm extension list

Edytuj

Wyświetl listę rozszerzeń dołączonych do maszyny wirtualnej.

az vm extension list [--ids]
                     [--resource-group]
                     [--subscription]
                     [--vm-name]

Przykłady

Wyświetl listę dołączonych rozszerzeń do nazwanej maszyny wirtualnej.

az vm extension list -g MyResourceGroup --vm-name MyVm

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.

--ids

Właściwość	Wartość
Grupa parametrów:	Resource Id Arguments

--resource-group -g

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

Właściwość	Wartość
Grupa parametrów:	Resource Id Arguments

--subscription

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

Właściwość	Wartość
Grupa parametrów:	Resource Id Arguments

--vm-name

Nazwa maszyny wirtualnej. Wartość domyślną można skonfigurować przy użyciu polecenia az configure --defaults vm=<name>.

Właściwość	Wartość
Grupa parametrów:	Resource Id Arguments

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.

--verbose

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

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

az vm extension set

Edytuj

Ustawianie rozszerzeń dla maszyny wirtualnej.

Pobierz szczegóły rozszerzenia z az vm extension image list.

az vm extension set --name
                    --publisher
                    [--enable-auto-upgrade {false, true}]
                    [--extension-instance-name]
                    [--force-update]
                    [--ids]
                    [--no-auto-upgrade {false, true}]
                    [--no-auto-upgrade-minor-version {false, true}]
                    [--no-wait]
                    [--protected-settings]
                    [--resource-group]
                    [--settings]
                    [--subscription]
                    [--version]
                    [--vm-name]

Przykłady

Dodaj konto użytkownika do maszyny wirtualnej z systemem Linux.

az vm extension set -n VMAccessForLinux --publisher Microsoft.OSTCExtensions --version 1.4 \
    --vm-name MyVm --resource-group MyResourceGroup \
    --protected-settings '{"username":"user1", "ssh_key":"ssh_rsa ..."}'

Dodaj rozszerzenie customScript do maszyn wirtualnych określonych przez parametr --ids.

az vm extension set -n customScript --publisher Microsoft.Azure.Extensions --ids {vm_id}

Dodaj rozszerzenie i włącz automatyczne uaktualnianie przez platformę, jeśli jest dostępna nowsza wersja rozszerzenia.

az vm extension set -n extName --publisher publisher --vm-name MyVM -g MyResourceGroup \
--enable-auto-upgrade true

Parametry wymagane

--name -n

Nazwa rozszerzenia.

Właściwość	Wartość
Wartość od:	az vm extension image list

--publisher

Nazwa wydawcy rozszerzenia.

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.

--enable-auto-upgrade

Wskaż, że rozszerzenie powinno zostać automatycznie uaktualnione przez platformę, jeśli dostępna jest nowsza wersja rozszerzenia.

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

--extension-instance-name

Nazwa wystąpienia rozszerzenia, które można dostosować. Ustawienie domyślne: nazwa rozszerzenia.

--force-update

Wymuś aktualizację, nawet jeśli konfiguracja rozszerzenia nie uległa zmianie.

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

--ids

Właściwość	Wartość
Grupa parametrów:	Resource Id Arguments

--no-auto-upgrade

Przestarzałe

Opcja "--no-auto-upgrade" została wycofana i zostanie usunięta w przyszłej wersji. Zamiast tego użyj polecenia "--no-auto-upgrade-minor-version".

W przypadku ustawienia usługa rozszerzenia nie będzie automatycznie wybierać ani uaktualniać do najnowszej wersji pomocniczej, nawet jeśli rozszerzenie zostanie ponownie wdrożone.

Właściwość	Wartość
Domyślna wartość:	False
Dopuszczalne wartości:	false, true

--no-auto-upgrade-minor-version

W przypadku ustawienia usługa rozszerzenia nie będzie automatycznie wybierać ani uaktualniać do najnowszej wersji pomocniczej, nawet jeśli rozszerzenie zostanie ponownie wdrożone.

Właściwość	Wartość
Domyślna wartość:	False
Dopuszczalne wartości:	false, true

--no-wait

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

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

--protected-settings

Ustawienia chronione w formacie JSON dla poufnych informacji, takich jak poświadczenia. Akceptowana jest również ścieżka pliku JSON.

--resource-group -g

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

Właściwość	Wartość
Grupa parametrów:	Resource Id Arguments

--settings

Ustawienia rozszerzenia w formacie JSON. Akceptowana jest również ścieżka pliku JSON.

--subscription

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

Właściwość	Wartość
Grupa parametrów:	Resource Id Arguments

--version

Wersja rozszerzenia. Aby przypiąć wersję rozszerzenia do tej wartości, określ wartość --no-auto-upgrade-minor-version.

--vm-name

Nazwa maszyny wirtualnej. Wartość domyślną można skonfigurować przy użyciu polecenia az configure --defaults vm=<name>.

Właściwość	Wartość
Grupa parametrów:	Resource Id Arguments

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.

--verbose

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

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

az vm extension show

Edytuj

Wyświetlanie informacji o rozszerzeniach dołączonych do maszyny wirtualnej.

az vm extension show [--ids]
                     [--instance-view]
                     [--name]
                     [--resource-group]
                     [--subscription]
                     [--vm-name]

Przykłady

Użyj nazwy maszyny wirtualnej i nazwy rozszerzenia, aby wyświetlić rozszerzenia dołączone do maszyny wirtualnej.

az vm extension show -g MyResourceGroup --vm-name MyVm -n extension_name

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.

--ids

Właściwość	Wartość
Grupa parametrów:	Resource Id Arguments

--instance-view

Widok wystąpienia rozszerzenia maszyny wirtualnej.

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

--name -n

Nazwa rozszerzenia.

Właściwość	Wartość
Grupa parametrów:	Resource Id Arguments

--resource-group -g

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

Właściwość	Wartość
Grupa parametrów:	Resource Id Arguments

--subscription

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

Właściwość	Wartość
Grupa parametrów:	Resource Id Arguments

--vm-name

Nazwa maszyny wirtualnej. Wartość domyślną można skonfigurować przy użyciu polecenia az configure --defaults vm=<name>.

Właściwość	Wartość
Grupa parametrów:	Resource Id Arguments

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.

--verbose

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

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

az vm extension wait

Edytuj

Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku.

az vm extension wait [--created]
                     [--custom]
                     [--deleted]
                     [--exists]
                     [--expand]
                     [--ids]
                     [--interval]
                     [--name --vm-extension-name]
                     [--resource-group]
                     [--subscription]
                     [--timeout]
                     [--updated]
                     [--vm-name]

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.

--created

Zaczekaj na utworzenie polecenia "provisioningState" o godzinie "Succeeded".

Właściwość	Wartość
Grupa parametrów:	Wait Condition Arguments
Domyślna wartość:	False

--custom

Poczekaj, aż warunek spełnia niestandardowe zapytanie JMESPath. Np. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

Właściwość	Wartość
Grupa parametrów:	Wait Condition Arguments

--deleted

Poczekaj na usunięcie.

Właściwość	Wartość
Grupa parametrów:	Wait Condition Arguments
Domyślna wartość:	False

--exists

Zaczekaj, aż zasób istnieje.

Właściwość	Wartość
Grupa parametrów:	Wait Condition Arguments
Domyślna wartość:	False

--expand

Wyrażenie expand, które ma być stosowane w operacji.

--ids

Właściwość	Wartość
Grupa parametrów:	Resource Id Arguments

--interval

Interwał sondowania w sekundach.

Właściwość	Wartość
Grupa parametrów:	Wait Condition Arguments
Domyślna wartość:	30

--name --vm-extension-name -n

Nazwa rozszerzenia maszyny wirtualnej.

Właściwość	Wartość
Grupa parametrów:	Resource Id Arguments

--resource-group -g

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

Właściwość	Wartość
Grupa parametrów:	Resource Id Arguments

--subscription

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

Właściwość	Wartość
Grupa parametrów:	Resource Id Arguments

--timeout

Maksymalny czas oczekiwania w sekundach.

Właściwość	Wartość
Grupa parametrów:	Wait Condition Arguments
Domyślna wartość:	3600

--updated

Zaczekaj na zaktualizowanie stanu provisioningState o 'Powodzenie'.

Właściwość	Wartość
Grupa parametrów:	Wait Condition Arguments
Domyślna wartość:	False

--vm-name

Nazwa maszyny wirtualnej. Wartość domyślną można skonfigurować przy użyciu polecenia az configure --defaults vm=<name>.

Właściwość	Wartość
Grupa parametrów:	Resource Id Arguments

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.

--verbose

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

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

Sprzężenie zwrotne

Czy ta strona była pomocna?

Udostępnij przez

az vm extension

Polecenia

az vm extension delete

Przykłady

Parametry opcjonalne

az vm extension list

Przykłady

Parametry opcjonalne

az vm extension set

Przykłady

Parametry wymagane

Parametry opcjonalne

az vm extension show

Przykłady

Parametry opcjonalne

az vm extension wait

Parametry opcjonalne

Sprzężenie zwrotne