az vm extension

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

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

Default value: 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

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

Default value: 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

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.

Default value: 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

Default value: 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

Default value: False

--no-wait

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

Default value: 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

Default value: 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

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

Default value: 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

Default value: 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

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.

Default value: 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.

Default value: False

--exists

Kaynak var olana kadar bekleyin.

Default value: 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ığı.

Default value: 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.

Default value: 3600

--updated

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

Default value: 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

Default value: 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.