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

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

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

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

Özellik	Değer
Parametre grubu:	Resource Id Arguments

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

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

Özellik	Değer
Parametre grubu:	Resource Id Arguments

--no-wait

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

Özellik	Değer
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.

Özellik	Değer
Parametre grubu:	Resource Id Arguments

--subscription

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

Özellik	Değer
Parametre grubu:	Resource Id Arguments

--vm-name

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

Özellik	Değer
Parametre grubu:	Resource Id Arguments

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.

Özellik	Değer
Default value:	False

--help -h

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

--only-show-errors

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

Özellik	Değer
Default value:	False

--output -o

Çıkış biçimi.

Özellik	Değer
Default value:	json
Kabul edilen değerler:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

Özellik	Değer
Default value:	False

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

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

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

Özellik	Değer
Parametre grubu:	Resource Id Arguments

--resource-group -g

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

Özellik	Değer
Parametre grubu:	Resource Id Arguments

--subscription

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

Özellik	Değer
Parametre grubu:	Resource Id Arguments

--vm-name

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

Özellik	Değer
Parametre grubu:	Resource Id Arguments

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.

Özellik	Değer
Default value:	False

--help -h

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

--only-show-errors

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

Özellik	Değer
Default value:	False

--output -o

Çıkış biçimi.

Özellik	Değer
Default value:	json
Kabul edilen değerler:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

Özellik	Değer
Default value:	False

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

Özellik	Değer
Şuradan alınan değerler::	az vm extension image list

--publisher

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

İsteğe Bağlı Parametreler

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

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

Özellik	Değer
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.

Özellik	Değer
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.

Özellik	Değer
Parametre grubu:	Resource Id Arguments

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

Özellik	Değer
Default value:	False
Kabul edilen değerler:	false, true

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

Özellik	Değer
Default value:	False
Kabul edilen değerler:	false, true

--no-wait

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

Özellik	Değer
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.

Özellik	Değer
Parametre grubu:	Resource Id Arguments

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

Özellik	Değer
Parametre grubu:	Resource Id Arguments

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

Özellik	Değer
Parametre grubu:	Resource Id Arguments

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.

Özellik	Değer
Default value:	False

--help -h

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

--only-show-errors

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

Özellik	Değer
Default value:	False

--output -o

Çıkış biçimi.

Özellik	Değer
Default value:	json
Kabul edilen değerler:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

Özellik	Değer
Default value:	False

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

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

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

Özellik	Değer
Parametre grubu:	Resource Id Arguments

--instance-view

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

Özellik	Değer
Default value:	False

--name -n

Uzantının adı.

Özellik	Değer
Parametre grubu:	Resource Id Arguments

--resource-group -g

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

Özellik	Değer
Parametre grubu:	Resource Id Arguments

--subscription

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

Özellik	Değer
Parametre grubu:	Resource Id Arguments

--vm-name

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

Özellik	Değer
Parametre grubu:	Resource Id Arguments

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.

Özellik	Değer
Default value:	False

--help -h

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

--only-show-errors

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

Özellik	Değer
Default value:	False

--output -o

Çıkış biçimi.

Özellik	Değer
Default value:	json
Kabul edilen değerler:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

Özellik	Değer
Default value:	False

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

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--created

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

Özellik	Değer
Parametre grubu:	Wait Condition Arguments
Default value:	False

--custom

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

Özellik	Değer
Parametre grubu:	Wait Condition Arguments

--deleted

Silinene kadar bekleyin.

Özellik	Değer
Parametre grubu:	Wait Condition Arguments
Default value:	False

--exists

Kaynak var olana kadar bekleyin.

Özellik	Değer
Parametre grubu:	Wait Condition Arguments
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.

Özellik	Değer
Parametre grubu:	Resource Id Arguments

--interval

Saniye cinsinden yoklama aralığı.

Özellik	Değer
Parametre grubu:	Wait Condition Arguments
Default value:	30

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

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

Özellik	Değer
Parametre grubu:	Resource Id Arguments

--resource-group -g

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

Özellik	Değer
Parametre grubu:	Resource Id Arguments

--subscription

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

Özellik	Değer
Parametre grubu:	Resource Id Arguments

--timeout

Saniye cinsinden en fazla bekleme.

Özellik	Değer
Parametre grubu:	Wait Condition Arguments
Default value:	3600

--updated

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

Özellik	Değer
Parametre grubu:	Wait Condition Arguments
Default value:	False

--vm-name

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

Özellik	Değer
Parametre grubu:	Resource Id Arguments

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.

Özellik	Değer
Default value:	False

--help -h

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

--only-show-errors

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

Özellik	Değer
Default value:	False

--output -o

Çıkış biçimi.

Özellik	Değer
Default value:	json
Kabul edilen değerler:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

Özellik	Değer
Default value:	False