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.	Çekirdek	Georgia
az vm extension image	Abonelik ve bölge için kullanılabilir VM uzantılarını bulun.	Çekirdek	Georgia
az vm extension image list	Kullanılabilir uzantılarla ilgili bilgileri listeleyin.	Çekirdek	Georgia
az vm extension image list-names	Kullanılabilir uzantıların adlarını listeleyin.	Çekirdek	Georgia
az vm extension image list-versions	Kullanılabilir uzantıların sürümlerini listeleyin.	Çekirdek	Georgia
az vm extension image show	Uzantı bilgilerini görüntüleme.	Çekirdek	Georgia
az vm extension list	Vm'ye bağlı uzantıları listeleyin.	Çekirdek	Georgia
az vm extension set	VM için uzantıları ayarlama.	Çekirdek	Georgia
az vm extension show	Vm'ye bağlı uzantılar hakkındaki bilgileri görüntüleyin.	Çekirdek	Georgia
az vm extension wait	Bir koşul karşılanıncaya kadar CLI'yi bekleme durumuna yerleştirin.	Çekirdek	Georgia

az vm extension delete

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

az vm extension delete [--ids]
                       [--name --vm-extension-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 kimliği (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' parametrelerini vermelisiniz.

--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ı. az configure --defaults group=<name>kullanarak varsayılan grubu yapılandırabilirsiniz.

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayı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. az account set -s NAME_OR_IDkullanarak varsayı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 kimliği (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' parametrelerini vermelisiniz.

--resource-group -g

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

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayı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. az account set -s NAME_OR_IDkullanarak varsayı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ı 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 kimliği (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' parametrelerini vermelisiniz.

--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ı. az configure --defaults group=<name>kullanarak varsayılan grubu yapılandırabilirsiniz.

--settings

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

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayı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. az account set -s NAME_OR_IDkullanarak varsayı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 kimliği (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' parametrelerini vermelisiniz.

--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ı. az configure --defaults group=<name>kullanarak varsayılan grubu yapılandırabilirsiniz.

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayı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. az account set -s NAME_OR_IDkullanarak varsayı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 koşul karşılanıncaya kadar CLI'yi bekleme durumuna yerleştirin.

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

İ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

--expand

İşleme uygulanacak genişletme ifadesi.

--ids

Bir veya daha fazla kaynak kimliği (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' parametrelerini vermelisiniz.

--interval

Saniye cinsinden yoklama aralığı.

Default value: 30

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

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

--resource-group -g

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

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayı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. az account set -s NAME_OR_IDkullanarak varsayı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.