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

Redagować

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, jeden lub więcej może być potrzebnych 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łasność	Wartość
Grupa parametrów:	Resource Id Arguments

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

Nazwa rozszerzenia maszyny wirtualnej.

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

--no-wait

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

Własność	Wartość
Akceptowane 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łasność	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łasność	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łasność	Wartość
Grupa parametrów:	Resource Id Arguments

Parametry globalne

--debug

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

Własność	Wartość
Wartość domyślna:	False

--help -h

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

--only-show-errors

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

Własność	Wartość
Wartość domyślna:	False

--output -o

Format danych wyjściowych.

Własność	Wartość
Wartość domyślna:	json
Akceptowane 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łasność	Wartość
Wartość domyślna:	False

az vm extension list

Redagować

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, jeden lub więcej może być potrzebnych do pomyślnego wykonania polecenia.

--ids

Własność	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łasność	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łasność	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łasność	Wartość
Grupa parametrów:	Resource Id Arguments

Parametry globalne

--debug

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

Własność	Wartość
Wartość domyślna:	False

--help -h

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

--only-show-errors

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

Własność	Wartość
Wartość domyślna:	False

--output -o

Format danych wyjściowych.

Własność	Wartość
Wartość domyślna:	json
Akceptowane 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łasność	Wartość
Wartość domyślna:	False

az vm extension set

Redagować

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

Wymagane parametry

--name -n

Nazwa rozszerzenia.

Własność	Wartość
Wartość z:	az vm extension image list

--publisher

Nazwa wydawcy rozszerzenia.

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu, jeden lub więcej może być potrzebnych 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łasność	Wartość
Akceptowane 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łasność	Wartość
Wartość domyślna:	False

--ids

Własność	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łasność	Wartość
Wartość domyślna:	False
Akceptowane 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łasność	Wartość
Wartość domyślna:	False
Akceptowane wartości:	false, true

--no-wait

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

Własność	Wartość
Wartość domyślna:	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łasność	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łasność	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łasność	Wartość
Grupa parametrów:	Resource Id Arguments

Parametry globalne

--debug

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

Własność	Wartość
Wartość domyślna:	False

--help -h

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

--only-show-errors

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

Własność	Wartość
Wartość domyślna:	False

--output -o

Format danych wyjściowych.

Własność	Wartość
Wartość domyślna:	json
Akceptowane 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łasność	Wartość
Wartość domyślna:	False

az vm extension show

Redagować

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, jeden lub więcej może być potrzebnych do pomyślnego wykonania polecenia.

--ids

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

--instance-view

Widok wystąpienia rozszerzenia maszyny wirtualnej.

Własność	Wartość
Wartość domyślna:	False

--name -n

Nazwa rozszerzenia.

Własność	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łasność	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łasność	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łasność	Wartość
Grupa parametrów:	Resource Id Arguments

Parametry globalne

--debug

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

Własność	Wartość
Wartość domyślna:	False

--help -h

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

--only-show-errors

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

Własność	Wartość
Wartość domyślna:	False

--output -o

Format danych wyjściowych.

Własność	Wartość
Wartość domyślna:	json
Akceptowane 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łasność	Wartość
Wartość domyślna:	False

az vm extension wait

Redagować

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, jeden lub więcej może być potrzebnych do pomyślnego wykonania polecenia.

--created

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

Własność	Wartość
Grupa parametrów:	Wait Condition Arguments
Wartość domyślna:	False

--custom

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

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

--deleted

Poczekaj na usunięcie.

Własność	Wartość
Grupa parametrów:	Wait Condition Arguments
Wartość domyślna:	False

--exists

Zaczekaj, aż zasób istnieje.

Własność	Wartość
Grupa parametrów:	Wait Condition Arguments
Wartość domyślna:	False

--expand

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

--ids

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

--interval

Interwał sondowania w sekundach.

Własność	Wartość
Grupa parametrów:	Wait Condition Arguments
Wartość domyślna:	30

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

Nazwa rozszerzenia maszyny wirtualnej.

Własność	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łasność	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łasność	Wartość
Grupa parametrów:	Resource Id Arguments

--timeout

Maksymalny czas oczekiwania w sekundach.

Własność	Wartość
Grupa parametrów:	Wait Condition Arguments
Wartość domyślna:	3600

--updated

Zaczekaj na zaktualizowanie stanu provisioningState o 'Powodzenie'.

Własność	Wartość
Grupa parametrów:	Wait Condition Arguments
Wartość domyślna:	False

--vm-name

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

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

Parametry globalne

--debug

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

Własność	Wartość
Wartość domyślna:	False

--help -h

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

--only-show-errors

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

Własność	Wartość
Wartość domyślna:	False

--output -o

Format danych wyjściowych.

Własność	Wartość
Wartość domyślna:	json
Akceptowane 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łasność	Wartość
Wartość domyślna:	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

Wymagane parametry

Parametry opcjonalne

az vm extension show

Przykłady

Parametry opcjonalne

az vm extension wait

Parametry opcjonalne

Sprzężenie zwrotne