az vm extension

  • Başvuru

VM'lerdeki uzantıları yönetin.

Uzantılar, Azure sanal makinelerinde dağıtım sonrası yapılandırma ve otomasyon görevleri sağlayan küçük uygulamalardır. Örneğin, bir sanal makine yazılım yüklemesi, virüsten koruma veya Docker yapılandırması gerektiriyorsa, bu görevleri tamamlamak için bir VM uzantısı kullanılabilir. Uzantılar yeni bir sanal makine dağıtımıyla paketlenebilir veya mevcut herhangi bir sistemde çalıştırılabilir.

Komutlar

Name Description Tür Durum
az vm extension delete

Uzantıyı silmek için silme işlemi.

 Temel GA
az vm extension image

Abonelik ve bölge için kullanılabilir VM uzantılarını bulun.

 Temel GA
az vm extension image list

Kullanılabilir uzantılarla ilgili bilgileri listeleyin.

 Temel GA
az vm extension image list-names

Kullanılabilir uzantıların adlarını listeleyin.

 Temel GA
az vm extension image list-versions

Kullanılabilir uzantıların sürümlerini listeleyin.

 Temel GA
az vm extension image show

Uzantı bilgilerini görüntüleme.

 Temel GA
az vm extension list

Vm'ye bağlı uzantıları listeleyin.

 Temel GA
az vm extension set

VM için uzantıları ayarlama.

 Temel GA
az vm extension show

Vm'ye bağlı uzantılar hakkındaki bilgileri görüntüleyin.

 Temel GA
az vm extension wait

Bir sanal makine uzantısı koşulu karşılanıncaya kadar CLI'yi bekleme durumuna yerleştirin.

 Temel GA

az vm extension delete

Düzenle

Uzantıyı silmek için silme işlemi.

az vm extension delete [--ids]
                       [--name]
                       [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                       [--resource-group]
                       [--subscription]
                       [--vm-name]

Örnekler

Bir VM'den uzantıyı silmek için VM adı ve uzantısı kullanın.

az vm extension delete -g MyResourceGroup --vm-name MyVm -n MyExtensionName

Vm'den "MyExtension" dizesini içeren kimliklere sahip uzantıları silin.

az vm extension delete --ids $(az resource list --query "[?contains(name, 'MyExtension')].id" -o tsv)

İsteğe Bağlı Parametreler

--ids

Bir veya daha fazla kaynak kimlikleri (boşlukla ayrılmış). 'Kaynak Kimliği' bağımsız değişkenlerinin tüm bilgilerini içeren eksiksiz bir kaynak kimliği olmalıdır. --ids veya diğer 'Kaynak Kimliği' bağımsız değişkenlerini sağlamanız gerekir.

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

Sanal makine uzantısının adı.

--no-wait

Uzun süre çalışan işlemin bitmesini beklemeyin.

kabul edilen değerler: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz.

--vm-name

Sanal Makinenin adı. kullanarak varsayılanı az configure --defaults vm=<name>yapılandırabilirsiniz.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
varsayılan değer: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az vm extension list

Düzenle

Vm'ye bağlı uzantıları listeleyin.

az vm extension list [--ids]
                     [--resource-group]
                     [--subscription]
                     [--vm-name]

Örnekler

Adlandırılmış bir VM'ye eklenen uzantıları listeleme.

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

İsteğe Bağlı Parametreler

--ids

Bir veya daha fazla kaynak kimlikleri (boşlukla ayrılmış). 'Kaynak Kimliği' bağımsız değişkenlerinin tüm bilgilerini içeren eksiksiz bir kaynak kimliği olmalıdır. --ids veya diğer 'Kaynak Kimliği' bağımsız değişkenlerini sağlamanız gerekir.

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz.

--vm-name

Sanal Makinenin adı. kullanarak varsayılanı az configure --defaults vm=<name>yapılandırabilirsiniz.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
varsayılan değer: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az vm extension set

Düzenle

VM için uzantıları ayarlama.

uzantı ayrıntılarını uygulamasından az vm extension image listalın.

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]

Örnekler

Linux VM'sine kullanıcı hesabı ekleyin.

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

--ids tarafından belirtilen VM'lere bir customScript uzantısı ekleyin.

az vm extension set -n customScript --publisher Microsoft.Azure.Extensions --ids {vm_id}

Bir uzantı ekleyin ve kullanılabilir uzantının daha yeni bir sürümü varsa platform tarafından otomatik yükseltmeyi etkinleştirin.

az vm extension set -n extName --publisher publisher --vm-name MyVM -g MyResourceGroup \
--enable-auto-upgrade true

Gerekli Parametreler

--name -n

Uzantının adı.

şuradan alınan değerler:: az vm extension image list
--publisher

Uzantı yayımcısının adı.

İsteğe Bağlı Parametreler

--enable-auto-upgrade

Uzantının daha yeni bir sürümü varsa, uzantının platform tarafından otomatik olarak yükseltilmesi gerektiğini belirtin.

kabul edilen değerler: false, true
--extension-instance-name

Özelleştirilebilen uzantı örneğinin adı. Varsayılan: uzantının adı.

--force-update

Uzantı yapılandırması değişmemiş olsa bile güncelleştirmeyi zorla.

varsayılan değer: False
--ids

Bir veya daha fazla kaynak kimlikleri (boşlukla ayrılmış). 'Kaynak Kimliği' bağımsız değişkenlerinin tüm bilgilerini içeren eksiksiz bir kaynak kimliği olmalıdır. --ids veya diğer 'Kaynak Kimliği' bağımsız değişkenlerini sağlamanız gerekir.

--no-auto-upgrade
Kullanım Dışı

'--otomatik yükseltme yok' seçeneği kullanım dışı bırakıldı ve gelecek bir sürümde kaldırılacak. Bunun yerine '--no-auto-upgrade-minor-version' kullanın.

Ayarlanırsa, uzantı yeniden dağıtılsa bile uzantı hizmeti otomatik olarak en son ikincil sürümü seçmez veya yükseltmez.

kabul edilen değerler: false, true
varsayılan değer: False
--no-auto-upgrade-minor-version

Ayarlanırsa, uzantı yeniden dağıtılsa bile uzantı hizmeti otomatik olarak en son ikincil sürümü seçmez veya yükseltmez.

kabul edilen değerler: false, true
varsayılan değer: False
--no-wait

Uzun süre çalışan işlemin bitmesini beklemeyin.

varsayılan değer: False
--protected-settings

Kimlik bilgileri gibi hassas bilgiler için JSON biçiminde korumalı ayarlar. JSON dosya yolu da kabul edilir.

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

--settings

Uzantı ayarları JSON biçimindedir. JSON dosya yolu da kabul edilir.

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz.

--version

Uzantının sürümü. Uzantı sürümünü bu değere sabitlemek için lütfen --no-auto-upgrade-minor-version belirtin.

--vm-name

Sanal Makinenin adı. kullanarak varsayılanı az configure --defaults vm=<name>yapılandırabilirsiniz.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
varsayılan değer: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az vm extension show

Düzenle

Vm'ye bağlı uzantılar hakkındaki bilgileri görüntüleyin.

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

Örnekler

VM'ye bağlı uzantıları göstermek için VM adını ve uzantı adını kullanın.

az vm extension show -g MyResourceGroup --vm-name MyVm -n extension_name

İsteğe Bağlı Parametreler

--ids

Bir veya daha fazla kaynak kimlikleri (boşlukla ayrılmış). 'Kaynak Kimliği' bağımsız değişkenlerinin tüm bilgilerini içeren eksiksiz bir kaynak kimliği olmalıdır. --ids veya diğer 'Kaynak Kimliği' bağımsız değişkenlerini sağlamanız gerekir.

--instance-view

Sanal makine uzantısının örnek görünümü.

varsayılan değer: False
--name -n

Uzantının adı.

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz.

--vm-name

Sanal Makinenin adı. kullanarak varsayılanı az configure --defaults vm=<name>yapılandırabilirsiniz.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
varsayılan değer: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az vm extension wait

Düzenle

Bir sanal makine uzantısı koşulu karşılanıncaya kadar CLI'yi bekleme durumuna yerleştirin.

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

Örnekler

Bir sanal makine uzantısı koşulu karşılanıncaya kadar CLI'yi bekleme durumuna yerleştirin. (otomatik olarak oluşturulmuş)

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

Bir sanal makine uzantısı koşulu karşılanıncaya kadar CLI'yi bekleme durumuna yerleştirin. (otomatik olarak oluşturulmuş)

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

Bir sanal makine uzantısı koşulu karşılanıncaya kadar CLI'yi bekleme durumuna yerleştirin. (otomatik olarak oluşturulmuş)

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

İsteğe Bağlı Parametreler

--created

'ProvisioningState' ile 'Succeeded' konumunda oluşturulana kadar bekleyin.

varsayılan değer: False
--custom

Koşul özel bir JMESPath sorgusunu karşılayana kadar bekleyin. Örneğin provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Silinene kadar bekleyin.

varsayılan değer: False
--exists

Kaynak var olana kadar bekleyin.

varsayılan değer: False
--ids

Bir veya daha fazla kaynak kimlikleri (boşlukla ayrılmış). 'Kaynak Kimliği' bağımsız değişkenlerinin tüm bilgilerini içeren eksiksiz bir kaynak kimliği olmalıdır. --ids veya diğer 'Kaynak Kimliği' bağımsız değişkenlerini sağlamanız gerekir.

--interval

Saniye cinsinden yoklama aralığı.

varsayılan değer: 30
--name -n

Uzantının adı.

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz.

--timeout

Saniye cinsinden en fazla bekleme.

varsayılan değer: 3600
--updated

'Başarılı' konumunda provisioningState ile güncelleştirilene kadar bekleyin.

varsayılan değer: False
--vm-name

Sanal Makinenin adı. kullanarak varsayılanı az configure --defaults vm=<name>yapılandırabilirsiniz.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
varsayılan değer: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.