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, można użyć rozszerzenia maszyny wirtualnej do wykonania tych zadań. Rozszerzenia można powiązać z nowym wdrożeniem maszyny wirtualnej lub uruchamiać w dowolnym istniejącym systemie.

Polecenia

az vm extension delete

Usuwanie rozszerzenia dołączonego do maszyny wirtualnej.

az vm extension image

Znajdź dostępne rozszerzenia maszyn wirtualnych dla subskrypcji i regionu.

az vm extension image list

Wyświetl listę informacji o dostępnych rozszerzeniach.

az vm extension image list-names

Lista nazw dostępnych rozszerzeń.

az vm extension image list-versions

Wyświetl listę wersji dostępnych rozszerzeń.

az vm extension image show

Wyświetlanie informacji o rozszerzeniu.

az vm extension list

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

az vm extension set

Ustawianie rozszerzeń dla maszyny wirtualnej.

az vm extension show

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

az vm extension wait

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

az vm extension delete

Usuwanie rozszerzenia dołączonego do maszyny wirtualnej.

az vm extension delete [--ids]
                       [--name]
                       [--no-wait]
                       [--resource-group]
                       [--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 extension_name

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 on być kompletnym identyfikatorem zasobu zawierającym wszystkie informacje o argumentach "Identyfikator zasobu". Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

--name -n

Nazwa rozszerzenia.

--no-wait

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

--resource-group -g

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

--vm-name

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

az vm extension list

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

az vm extension list --resource-group
                     --vm-name

Przykłady

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

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

Parametry wymagane

--resource-group -g

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

--vm-name

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

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]
                    [--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 jest dostępna nowsza wersja rozszerzenia.

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.

--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien on być kompletnym identyfikatorem zasobu zawierającym wszystkie informacje o argumentach "Identyfikator zasobu". Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

--no-auto-upgrade

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.

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.

akceptowane wartości: false, true
--no-wait

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

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

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

az vm extension show

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

az vm extension show [--expand]
                     [--ids]
                     [--instance-view]
                     [--name]
                     [--resource-group]
                     [--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

--expand

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

--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien on być kompletnym identyfikatorem zasobu zawierającym wszystkie informacje o argumentach "Identyfikator zasobu". Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

--instance-view

Widok wystąpienia rozszerzenia maszyny wirtualnej.

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

--vm-name

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

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]
                     [--expand]
                     [--ids]
                     [--interval]
                     [--name]
                     [--resource-group]
                     [--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" w lokalizacji "Succeeded".

--custom

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

--deleted

Zaczekaj na usunięcie.

--exists

Zaczekaj, aż zasób istnieje.

--expand

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

--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien on być kompletnym identyfikatorem zasobu zawierającym wszystkie informacje o argumentach "Identyfikator zasobu". Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

--interval

Interwał sondowania w sekundach.

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

--timeout

Maksymalny czas oczekiwania w sekundach.

wartość domyślna: 3600
--updated

Zaczekaj na zaktualizowanie parametru provisioningState o godzinie "Succeeded".

--vm-name

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