az vm extension

Odwołanie

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

Edytuj

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

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

--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 --debug, aby uzyskać pełne dzienniki debugowania.

az vm extension list

Edytuj

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

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

--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 --debug, aby uzyskać pełne dzienniki debugowania.

az vm extension set

Edytuj

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

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

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

--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 --debug, aby uzyskać pełne dzienniki debugowania.

az vm extension show

Edytuj

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

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

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

--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 --debug, aby uzyskać pełne dzienniki debugowania.

az vm extension wait

Edytuj

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. Na przykład 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

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

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

--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 --debug, aby uzyskać pełne dzienniki debugowania.