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.	Podstawowe funkcje	Ogólna dostępność
az vm extension image	Znajdź dostępne rozszerzenia maszyn wirtualnych dla subskrypcji i regionu.	Podstawowe funkcje	Ogólna dostępność
az vm extension image list	Wyświetl listę informacji o dostępnych rozszerzeniach.	Podstawowe funkcje	Ogólna dostępność
az vm extension image list-names	Lista nazw dostępnych rozszerzeń.	Podstawowe funkcje	Ogólna dostępność
az vm extension image list-versions	Wyświetl listę wersji dostępnych rozszerzeń.	Podstawowe funkcje	Ogólna dostępność
az vm extension image show	Wyświetlanie informacji o rozszerzeniu.	Podstawowe funkcje	Ogólna dostępność
az vm extension list	Wyświetl listę rozszerzeń dołączonych do maszyny wirtualnej.	Podstawowe funkcje	Ogólna dostępność
az vm extension set	Ustawianie rozszerzeń dla maszyny wirtualnej.	Podstawowe funkcje	Ogólna dostępność
az vm extension show	Wyświetlanie informacji o rozszerzeniach dołączonych do maszyny wirtualnej.	Podstawowe funkcje	Ogólna dostępność
az vm extension wait	Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku rozszerzenia maszyny wirtualnej.	Podstawowe funkcje	Ogólna dostępność

az vm extension delete

Operacja usuwania w celu usunięcia rozszerzenia.

az vm extension delete [--ids]
                       [--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

--ids

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

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

Nazwa rozszerzenia maszyny wirtualnej.

--no-wait

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

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 polecenia az configure --defaults group=<name>.

--subscription

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

--vm-name

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

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc

Domyślna wartość: 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 vm extension list

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

--ids

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

--resource-group -g

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

--subscription

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

--vm-name

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

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc

Domyślna wartość: 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 vm extension set

Ustawianie rozszerzeń dla maszyny wirtualnej.

Pobierz szczegóły rozszerzenia z witryny 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.

Wartość od: az vm extension image list

--publisher

Nazwa wydawcy rozszerzenia.

Parametry opcjonalne

--enable-auto-upgrade

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

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.

Domyślna wartość: False

--ids

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

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

Dopuszczalne wartości: false, true

Domyślna wartość: False

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

Dopuszczalne wartości: false, true

Domyślna wartość: False

--no-wait

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

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 polecenia az configure --defaults group=<name>.

--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 polecenia az account set -s NAME_OR_ID.

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

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.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc

Domyślna wartość: 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 vm extension show

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

--ids

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

--instance-view

Widok wystąpienia rozszerzenia maszyny wirtualnej.

Domyślna wartość: False

--name -n

Nazwa rozszerzenia.

--resource-group -g

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

--subscription

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

--vm-name

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

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc

Domyślna wartość: 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 vm extension wait

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

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

Przykłady

Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku rozszerzenia maszyny wirtualnej. (automatycznie wygenerowane)

az vm extension wait --created --name MyExtension --resource-group MyResourceGroup --vm-name MyVm

Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku rozszerzenia maszyny wirtualnej. (automatycznie wygenerowane)

az vm extension wait --exists --name MyExtension --resource-group MyResourceGroup --vm-name MyVm

Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku rozszerzenia maszyny wirtualnej. (automatycznie wygenerowane)

az vm extension wait --ids @- --name MyExtension --subscription MySubscription --updated --vm-name MyVm

Parametry opcjonalne

--created

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

Domyślna wartość: False

--custom

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

--deleted

Poczekaj na usunięcie.

Domyślna wartość: False

--exists

Zaczekaj, aż zasób istnieje.

Domyślna wartość: False

--ids

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

--interval

Interwał sondowania w sekundach.

Domyślna wartość: 30

--name -n

Nazwa rozszerzenia.

--resource-group -g

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

--subscription

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

--timeout

Maksymalny czas oczekiwania w sekundach.

Domyślna wartość: 3600

--updated

Zaczekaj na zaktualizowanie stanu provisioningState o 'Powodzenie'.

Domyślna wartość: False

--vm-name

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

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc

Domyślna wartość: 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.