az connectedmachine extension

Note

Bu başvuru, Azure CLI (sürüm 2.75.0 veya üzeri) için connectedmachine uzantısının bir parçasıdır. az connectedmachine extension komutunu ilk kez çalıştırdığınızda uzantı otomatik olarak yüklenir. Uzantılar hakkında daha fazla bilgi edinin.

Azure Arc Etkin Sunucuda VM uzantısını yönetme.

Komutlar

Name	Description	Tür	Durum
az connectedmachine extension create	Uzantıyı oluşturmak veya güncelleştirmek için oluşturma işlemi.	Extension	GA
az connectedmachine extension delete	Uzantıyı silmek için silme işlemi.	Extension	GA
az connectedmachine extension image	Azure Arc Etkin Sunucular için kullanılabilen VM uzantısı meta verilerini yönetin.	Extension	GA
az connectedmachine extension image list	Konum, yayımcı, extensionType temelinde tüm Uzantı sürümlerini listeleyin.	Extension	GA
az connectedmachine extension image show	Konum, yayımcı, extensionType ve sürüm temelinde bir Uzantı Meta Verileri alın.	Extension	GA
az connectedmachine extension list	Azure olmayan bir makinenin tüm uzantılarını alın.	Extension	GA
az connectedmachine extension show	Uzantıyı almak için alma işlemi.	Extension	GA
az connectedmachine extension update	Uzantıyı oluşturmak veya güncelleştirmek için güncelleştirme işlemi.	Extension	GA
az connectedmachine extension wait	Bir koşul karşılanıncaya kadar CLI'yi bekleme durumuna yerleştirin.	Extension	GA

az connectedmachine extension create

Uzantıyı oluşturmak veya güncelleştirmek için oluşturma işlemi.

az connectedmachine extension create --extension-name --name
                                     --machine-name
                                     --resource-group
                                     [--acquire-policy-token]
                                     [--auto-upgrade-min --auto-upgrade-minor-version {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--change-reference]
                                     [--enable-auto-upgrade --enable-automatic-upgrade {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--force-update-tag]
                                     [--instance-view]
                                     [--location]
                                     [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--protected-settings]
                                     [--publisher]
                                     [--settings]
                                     [--tags]
                                     [--type]
                                     [--type-handler-version]

Örnekler

uzantı oluşturma için örnek komut

az connectedmachine extension create --resource-group myResourceGroup --machine-name myMachine --extension-name CustomScriptExtension --location eastus2euap --publisher Microsoft.Compute --type-handler-version 1.10 --type CustomScriptExtension --settings "{commandToExecute:'powershell.exe -c "Get-Process | Where-Object { $_.CPU -gt 10000 }"'}"

Gerekli Parametreler

--extension-name --name -n

Makine uzantısının adı.

--machine-name

Uzantının oluşturulması veya güncelleştirilmesi gereken makinenin adı.

--resource-group -g

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

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

--acquire-policy-token

Bu kaynak işlemi için otomatik olarak bir Azure İlkesi belirteci alma.

Özellik	Değer
Parametre grubu:	Global Policy Arguments

--auto-upgrade-min --auto-upgrade-minor-version

Dağıtım zamanında kullanılabilir durumdaysa uzantının daha yeni bir ikincil sürüm kullanıp kullanmayacağını gösterir. Ancak dağıtıldıktan sonra, bu özellik true olarak ayarlanmış olsa bile uzantı yeniden dağıtılmadığı sürece ikincil sürümleri yükseltmez.

Özellik	Değer
Parametre grubu:	Properties Arguments
Kabul edilen değerler:	0, 1, f, false, n, no, t, true, y, yes

--change-reference

Bu kaynak işlemi için ilgili değişiklik başvuru kimliği.

Özellik	Değer
Parametre grubu:	Global Policy Arguments

--enable-auto-upgrade --enable-automatic-upgrade

Kullanılabilir daha yeni bir sürüm varsa uzantının platform tarafından otomatik olarak yükseltilip yükseltilmeyeceğini gösterir.

Özellik	Değer
Parametre grubu:	Properties Arguments
Kabul edilen değerler:	0, 1, f, false, n, no, t, true, y, yes

--force-update-tag

Uzantı yapılandırması değişmemiş olsa bile uzantı işleyicisinin nasıl güncelleştirilmeye zorlanması gerektiği.

Özellik	Değer
Parametre grubu:	Properties Arguments

--instance-view

Makine uzantısı örneği görünümü. Kısa söz dizimi, json-file ve yaml-file desteği. Daha fazla göstermek için "??" seçeneğini deneyin.

Özellik	Değer
Parametre grubu:	Properties Arguments

--location -l

Kaynağın bulunduğu coğrafi konum Belirtilmediğinde kaynak grubunun konumu kullanılır.

Özellik	Değer
Parametre grubu:	ExtensionParameters 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

--protected-settings

Uzantı protectedSettings veya protectedSettingsFromKeyVault içerebilir veya hiç korumalı ayar içeremez. Kısa söz dizimi, json-file ve yaml-file desteği. Daha fazla göstermek için "??" seçeneğini deneyin.

Özellik	Değer
Parametre grubu:	Properties Arguments

--publisher

Uzantı işleyici yayımcısının adı.

Özellik	Değer
Parametre grubu:	Properties Arguments

--settings

Uzantı için Json tarafından biçimlendirilmiş genel ayarlar. Kısa söz dizimi, json-file ve yaml-file desteği. Daha fazla göstermek için "??" seçeneğini deneyin.

Özellik	Değer
Parametre grubu:	Properties Arguments

--tags

Kaynak etiketleri. Kısa söz dizimi, json-file ve yaml-file desteği. Daha fazla göstermek için "??" seçeneğini deneyin.

Özellik	Değer
Parametre grubu:	ExtensionParameters Arguments

--type

Uzantının türünü belirtir; "CustomScriptExtension" örnektir.

Özellik	Değer
Parametre grubu:	Properties Arguments

--type-handler-version

Betik işleyicisinin sürümünü belirtir.

Özellik	Değer
Parametre grubu:	Properties 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/.

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

Özellik	Değer
Default value:	False

az connectedmachine extension delete

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

az connectedmachine extension delete [--acquire-policy-token]
                                     [--change-reference]
                                     [--extension-name --name]
                                     [--ids]
                                     [--machine-name]
                                     [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--resource-group]
                                     [--subscription]
                                     [--yes]

Örnekler

uzantı silme için örnek komut

az connectedmachine extension delete --resource-group myResourceGroup --machine-name myMachine --extension-name MMA

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

--acquire-policy-token

Bu kaynak işlemi için otomatik olarak bir Azure İlkesi belirteci alma.

Özellik	Değer
Parametre grubu:	Global Policy Arguments

--change-reference

Bu kaynak işlemi için ilgili değişiklik başvuru kimliği.

Özellik	Değer
Parametre grubu:	Global Policy Arguments

--extension-name --name -n

Makine uzantısının adı.

Özellik	Değer
Parametre grubu:	Resource Id Arguments

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

--machine-name

Uzantının silinmesi gereken makinenin 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

--yes -y

Onay istemde bulunmayın.

Özellik	Değer
Default value:	False

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 connectedmachine extension list

Azure olmayan bir makinenin tüm uzantılarını alın.

az connectedmachine extension list --machine-name
                                   --resource-group
                                   [--expand]
                                   [--max-items]
                                   [--next-token]

Örnekler

Uzantı listesi için örnek komut

az connectedmachine extension list --machine-name myMachine --resource-group myResourceGroup

Gerekli Parametreler

--machine-name

Uzantıyı içeren makinenin adı.

--resource-group -g

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

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

--expand

İşleme uygulanacak genişletme ifadesi.

--max-items

Komutun çıkışında döndürülecek toplam öğe sayısı. Kullanılabilir öğelerin toplam sayısı belirtilen değerden fazlaysa, komutun çıkışında bir belirteç sağlanır. Sayfalandırmayı sürdürmek için sonraki bir komutun --next-token bağımsız değişkeninde belirteç değerini sağlayın.

Özellik	Değer
Parametre grubu:	Pagination Arguments

--next-token

Sayfalandırmanın nereden başlatılacağını belirtmek için belirteç. Bu, daha önce kesilmiş bir yanıttan alınan belirteç değeridir.

Özellik	Değer
Parametre grubu:	Pagination 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/.

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

Özellik	Değer
Default value:	False

az connectedmachine extension show

Uzantıyı almak için alma işlemi.

az connectedmachine extension show [--extension-name --name]
                                   [--ids]
                                   [--machine-name]
                                   [--resource-group]
                                   [--subscription]

Örnekler

uzantı gösterisi için örnek komut

az connectedmachine extension show --resource-group myResourceGroup --machine-name myMachine --extension-name CustomScriptExtension

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

--extension-name --name -n

Makine uzantısının adı.

Özellik	Değer
Parametre grubu:	Resource Id Arguments

--ids

Özellik	Değer
Parametre grubu:	Resource Id Arguments

--machine-name

Uzantıyı içeren makinenin 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

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 connectedmachine extension update

Uzantıyı oluşturmak veya güncelleştirmek için güncelleştirme işlemi.

az connectedmachine extension update [--acquire-policy-token]
                                     [--auto-upgrade-min --auto-upgrade-minor-version {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--change-reference]
                                     [--enable-auto-upgrade --enable-automatic-upgrade {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--extension-name --name]
                                     [--force-update-tag]
                                     [--ids]
                                     [--machine-name]
                                     [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--protected-settings]
                                     [--publisher]
                                     [--resource-group]
                                     [--settings]
                                     [--subscription]
                                     [--tags]
                                     [--type]
                                     [--type-handler-version]

Örnekler

uzantı güncelleştirmesi için örnek komut

az connectedmachine extension update --name CustomScriptExtension --type CustomScriptExtension --publisher Microsoft.Compute --type-handler-version 1.10 --machine-name myMachine --resource-group myResourceGroup

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

--acquire-policy-token

Bu kaynak işlemi için otomatik olarak bir Azure İlkesi belirteci alma.

Özellik	Değer
Parametre grubu:	Global Policy Arguments

--auto-upgrade-min --auto-upgrade-minor-version

Özellik	Değer
Parametre grubu:	Properties Arguments
Kabul edilen değerler:	0, 1, f, false, n, no, t, true, y, yes

--change-reference

Bu kaynak işlemi için ilgili değişiklik başvuru kimliği.

Özellik	Değer
Parametre grubu:	Global Policy Arguments

--enable-auto-upgrade --enable-automatic-upgrade

Kullanılabilir daha yeni bir sürüm varsa uzantının platform tarafından otomatik olarak yükseltilip yükseltilmeyeceğini gösterir.

Özellik	Değer
Parametre grubu:	Properties Arguments
Kabul edilen değerler:	0, 1, f, false, n, no, t, true, y, yes

--extension-name --name -n

Makine uzantısının adı.

Özellik	Değer
Parametre grubu:	Resource Id Arguments

--force-update-tag

Uzantı yapılandırması değişmemiş olsa bile uzantı işleyicisinin nasıl güncelleştirilmeye zorlanması gerektiği.

Özellik	Değer
Parametre grubu:	Properties Arguments

--ids

Özellik	Değer
Parametre grubu:	Resource Id Arguments

--machine-name

Uzantının oluşturulması veya güncelleştirilmesi gereken makinenin 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

--protected-settings

Özellik	Değer
Parametre grubu:	Properties Arguments

--publisher

Uzantı işleyici yayımcısının adı.

Özellik	Değer
Parametre grubu:	Properties 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

--settings

Uzantı için Json tarafından biçimlendirilmiş genel ayarlar. Kısa söz dizimi, json-file ve yaml-file desteği. Daha fazla göstermek için "??" seçeneğini deneyin.

Özellik	Değer
Parametre grubu:	Properties 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

--tags

Kaynak etiketleri Kısa söz dizimi, json-file ve yaml-file'yi destekler. Daha fazla göstermek için "??" seçeneğini deneyin.

Özellik	Değer
Parametre grubu:	ExtensionParameters Arguments

--type

Uzantının türünü belirtir; "CustomScriptExtension" örnektir.

Özellik	Değer
Parametre grubu:	Properties Arguments

--type-handler-version

Betik işleyicisinin sürümünü belirtir.

Özellik	Değer
Parametre grubu:	Properties 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 connectedmachine extension wait

Bir koşul karşılanıncaya kadar CLI'yi bekleme durumuna yerleştirin.

az connectedmachine extension wait [--acquire-policy-token]
                                   [--change-reference]
                                   [--created]
                                   [--custom]
                                   [--deleted]
                                   [--exists]
                                   [--extension-name --name]
                                   [--ids]
                                   [--interval]
                                   [--machine-name]
                                   [--resource-group]
                                   [--subscription]
                                   [--timeout]
                                   [--updated]

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

--acquire-policy-token

Bu kaynak işlemi için otomatik olarak bir Azure İlkesi belirteci alma.

Özellik	Değer
Parametre grubu:	Global Policy Arguments

--change-reference

Bu kaynak işlemi için ilgili değişiklik başvuru kimliği.

Özellik	Değer
Parametre grubu:	Global Policy Arguments

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

--extension-name --name -n

Makine uzantısının adı.

Özellik	Değer
Parametre grubu:	Resource Id Arguments

--ids

Özellik	Değer
Parametre grubu:	Resource Id Arguments

--interval

Saniye cinsinden yoklama aralığı.

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

--machine-name

Uzantıyı içeren makinenin 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

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

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?