Udostępnij za pośrednictwem

az scvmm vm extension

  • Odwołanie

Uwaga

Ta dokumentacja jest częścią rozszerzenia scvmm dla interfejsu wiersza polecenia platformy Azure (wersja 2.15.0 lub nowsza). Rozszerzenie zostanie automatycznie zainstalowane przy pierwszym uruchomieniu polecenia az scvmm vm extension . Dowiedz się więcej o rozszerzeniach.

Zarządzanie rozszerzeniem maszyny wirtualnej za pomocą narzędzia scvmm.

Polecenia

Nazwa Opis Typ Stan
az scvmm vm extension create

Operacja tworzenia rozszerzenia.

 Numer wewnętrzny Ogólna dostępność
az scvmm vm extension delete

Operacja usuwania rozszerzenia.

 Numer wewnętrzny Ogólna dostępność
az scvmm vm extension list

Operacja pobierania wszystkich rozszerzeń maszyny wirtualnej spoza platformy Azure.

 Numer wewnętrzny Ogólna dostępność
az scvmm vm extension show

Operacja pobierania rozszerzenia.

 Numer wewnętrzny Ogólna dostępność
az scvmm vm extension update

Operacja aktualizowania rozszerzenia.

 Numer wewnętrzny Ogólna dostępność

az scvmm vm extension create

Operacja tworzenia rozszerzenia.

az scvmm vm extension create --location
                             --name
                             --resource-group
                             --vm-name
                             [--auto-upgrade-minor {false, true}]
                             [--enable-auto-upgrade {false, true}]
                             [--force-update-tag]
                             [--no-wait]
                             [--protected-settings]
                             [--publisher]
                             [--settings]
                             [--tags]
                             [--type]
                             [--type-handler-version]

Przykłady

Tworzenie rozszerzenia maszyny wirtualnej

az scvmm vm extension create --name contoso-extension --location eastus2euap --type CustomScriptExtension --publisher Microsoft.Compute --settings "{\"commandToExecute\":\"powershell.exe -c \\\"Get-Process | Where-Object { $_.CPU -gt 10000 }\\\"\"}" --type-handler-version 1.10 --vm-name contoso-vm --resource-group contoso-rg

Parametry wymagane

--location -l

Lokalizacja. Wartości z: az account list-locations. Lokalizację domyślną można skonfigurować przy użyciu polecenia az configure --defaults location=<location>.

--name

Nazwa rozszerzenia maszyny wirtualnej.

--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, na której ma zostać utworzone lub zaktualizowane rozszerzenie.

Parametry opcjonalne

--auto-upgrade-minor

Określ, czy rozszerzenie powinno używać nowszej wersji pomocniczej, jeśli jest ona dostępna w czasie wdrażania. Po wdrożeniu rozszerzenie nie uaktualni wersji pomocniczych, chyba że zostanie ponownie wdrożone, nawet jeśli ta właściwość ma wartość true.

akceptowane wartości: false, true
--enable-auto-upgrade

Wskazuje, czy rozszerzenie powinno zostać automatycznie uaktualnione przez platformę, jeśli jest dostępna nowsza wersja.

akceptowane wartości: false, true
--force-update-tag

Sposób, w jaki program obsługi rozszerzeń powinien zostać zmuszony do aktualizacji, nawet jeśli konfiguracja rozszerzenia nie uległa zmianie.

--no-wait

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

wartość domyślna: False
--protected-settings

Rozszerzenie może zawierać chronione Ustawienia lub chronione Ustawienia FromKeyVault lub żadne ustawienia chronione. Oczekiwana wartość: json-string/json-file/@json-file.

--publisher

Nazwa wydawcy programu obsługi rozszerzeń.

--settings

Ustawienia publiczne w formacie Json dla rozszerzenia. Oczekiwana wartość: json-string/json-file/@json-file.

--tags

Tagi rozdzielone spacjami: klucz[=wartość] [key[=value] ...]. Użyj ciągu "", aby wyczyścić istniejące tagi.

--type

Określ typ rozszerzenia; przykładem jest "CustomScriptExtension".

--type-handler-version

Określa wersję programu obsługi skryptów.

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.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: 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 scvmm vm extension delete

Operacja usuwania rozszerzenia.

az scvmm vm extension delete [--ids]
                             [--name]
                             [--no-wait]
                             [--resource-group]
                             [--subscription]
                             [--vm-name]
                             [--yes]

Przykłady

Usuwanie rozszerzenia maszyny wirtualnej

az scvmm vm extension delete --name contoso-extension --vm-name contoso-vm --resource-group contoso-rg

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

Nazwa rozszerzenia maszyny wirtualnej.

--no-wait

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

wartość domyślna: False
--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, na której ma zostać usunięte rozszerzenie.

--yes -y

Nie monituj o potwierdzenie.

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

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: 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 scvmm vm extension list

Operacja pobierania wszystkich rozszerzeń maszyny wirtualnej spoza platformy Azure.

az scvmm vm extension list --resource-group
                           --vm-name
                           [--expand]

Przykłady

Pobieranie wszystkich rozszerzeń maszyn wirtualnych

az scvmm vm extension list --vm-name contoso-vm --resource-group contoso-rg

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 zawierającej rozszerzenie.

Parametry opcjonalne

--expand

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

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.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: 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 scvmm vm extension show

Operacja pobierania rozszerzenia.

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

Przykłady

Pobieranie rozszerzenia maszyny wirtualnej

az scvmm vm extension show --name contoso-extension --vm-name contoso-vm --resource-group contoso-rg

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

Nazwa rozszerzenia maszyny wirtualnej.

--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 zawierającej rozszerzenie.

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.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: 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 scvmm vm extension update

Operacja aktualizowania rozszerzenia.

az scvmm vm extension update --name
                             --resource-group
                             --vm-name
                             [--auto-upgrade-minor {false, true}]
                             [--enable-auto-upgrade {false, true}]
                             [--force-update-tag]
                             [--no-wait]
                             [--protected-settings]
                             [--publisher]
                             [--settings]
                             [--tags]
                             [--type]
                             [--type-handler-version]

Przykłady

Aktualizowanie rozszerzenia maszyny wirtualnej

az scvmm vm extension update --name contoso-extension --type CustomScriptExtension --publisher Microsoft.Compute --settings "{\"commandToExecute\":\"powershell.exe -c \\\"Get-Process | Where-Object { $_.CPU -lt 100 }\\\"\"}" --type-handler-version 1.10 --vm-name contoso-vm --resource-group contoso-rg

Parametry wymagane

--name

Nazwa rozszerzenia maszyny wirtualnej.

--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, na której ma zostać utworzone lub zaktualizowane rozszerzenie.

Parametry opcjonalne

--auto-upgrade-minor

Określ, czy rozszerzenie powinno używać nowszej wersji pomocniczej, jeśli jest ona dostępna w czasie wdrażania. Po wdrożeniu rozszerzenie nie uaktualni wersji pomocniczych, chyba że zostanie ponownie wdrożone, nawet jeśli ta właściwość ma wartość true.

akceptowane wartości: false, true
--enable-auto-upgrade

Wskazuje, czy rozszerzenie powinno zostać automatycznie uaktualnione przez platformę, jeśli jest dostępna nowsza wersja.

akceptowane wartości: false, true
--force-update-tag

Sposób, w jaki program obsługi rozszerzeń powinien zostać zmuszony do aktualizacji, nawet jeśli konfiguracja rozszerzenia nie uległa zmianie.

--no-wait

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

wartość domyślna: False
--protected-settings

Rozszerzenie może zawierać chronione Ustawienia lub chronione Ustawienia FromKeyVault lub żadne ustawienia chronione. Oczekiwana wartość: json-string/json-file/@json-file.

--publisher

Nazwa wydawcy programu obsługi rozszerzeń.

--settings

Ustawienia publiczne w formacie Json dla rozszerzenia. Oczekiwana wartość: json-string/json-file/@json-file.

--tags

Tagi rozdzielone spacjami: klucz[=wartość] [key[=value] ...]. Użyj ciągu "", aby wyczyścić istniejące tagi.

--type

Określ typ rozszerzenia; przykładem jest "CustomScriptExtension".

--type-handler-version

Określa wersję programu obsługi skryptów.

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.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: 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.