Aracılığıyla paylaş

Azure CLI kullanarak Azure VM uzantılarını etkinleştirme

  • Makale

Bu makalede, Azure Arc özellikli sunucular tarafından desteklenen sanal makine (VM) uzantılarını dağıtma, yükseltme, güncelleştirme ve kaldırma işlemleri açıklanır. Bu görevleri Azure CLI kullanarak Linux veya Windows karma makinesinde nasıl gerçekleştirebileceğinizi gösterir.

Not

Azure Arc özellikli sunucular, Azure sanal makinelerine VM uzantıları dağıtmayı ve yönetmeyi desteklemez. Azure VM'leri için VM uzantısına genel bakış makalesine bakın.

Önkoşullar

  • Azure Cloud Shell'de Bash ortamını kullanın. Daha fazla bilgi için bkz . Azure Cloud Shell'de Bash için hızlı başlangıç.

  • CLI başvuru komutlarını yerel olarak çalıştırmayı tercih ediyorsanız Azure CLI'yı yükleyin . Windows veya macOS üzerinde çalışıyorsanız Azure CLI’yi bir Docker kapsayıcısında çalıştırmayı değerlendirin. Daha fazla bilgi için bkz . Docker kapsayıcısında Azure CLI'yi çalıştırma.

    • Yerel yükleme kullanıyorsanız az login komutunu kullanarak Azure CLI ile oturum açın. Kimlik doğrulama işlemini tamamlamak için terminalinizde görüntülenen adımları izleyin. Diğer oturum açma seçenekleri için bkz . Azure CLI ile oturum açma.

    • İstendiğinde, ilk kullanımda Azure CLI uzantısını yükleyin. Uzantılar hakkında daha fazla bilgi için bkz. Azure CLI ile uzantıları kullanma.

    • Yüklü sürümü ve bağımlı kitaplıkları bulmak için az version komutunu çalıştırın. En son sürüme yükseltmek için az upgrade komutunu çalıştırın.

Azure CLI uzantısını yükleme

ConnectedMachine komutları Azure CLI'nın bir parçası olarak gönderilmez. Azure'a bağlanmak ve Azure Arc özellikli sunucular tarafından yönetilen karma sunucunuzda VM uzantılarını yönetmek için Azure CLI'yi kullanmadan önce ConnectedMachine uzantısını yüklemeniz gerekir.

Bu yönetim işlemlerini iş istasyonunuzdan gerçekleştirebilirsiniz. Bunları Azure Arc özellikli sunucuda çalıştırmanız gerekmez.

Azure CLI ConnectedMachine uzantısını yüklemek için aşağıdaki komutu çalıştırın:

az extension add --name connectedmachine

Uzantıyı etkinleştirme

Azure Arc özellikli sunucunuzda vm uzantısını etkinleştirmek için , , --extension-name, --type--location, , settingsve --publisher parametreleriyle --machine-namekullanınaz connectedmachine extension create.

Aşağıdaki örnek, Azure Arc özellikli bir sunucuda Özel Betik Uzantısı'nı etkinleştirir:

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

Aşağıdaki örnek, Azure Arc özellikli bir sunucuda Azure Key Vault VM uzantısını etkinleştirir:

az connectedmachine extension create --resource-group "resourceGroupName" --machine-name "myMachineName" --location "regionName" --publisher "Microsoft.Azure.KeyVault" --type "KeyVaultForLinux or KeyVaultForWindows" --name "KeyVaultForLinux or KeyVaultForWindows" --settings '{"secretsManagementSettings": { "pollingIntervalInS": "60", "observedCertificates": ["observedCert1"] }, "authenticationSettings": { "msiEndpoint": "http://localhost:40342/metadata/identity" }}'

Aşağıdaki örnek, Azure Arc özellikli bir Windows sunucusunda Microsoft Kötü Amaçlı Yazılımdan Koruma uzantısını etkinleştirir:

az connectedmachine extension create --resource-group "resourceGroupName" --machine-name "myMachineName" --location "regionName" --publisher "Microsoft.Azure.Security" --type "IaaSAntimalware" --name "IaaSAntimalware" --settings '"{\"AntimalwareEnabled\": \"true\"}"'

Aşağıdaki örnek, Azure Arc özellikli bir Windows sunucusunda Datadog uzantısını etkinleştirir:

az connectedmachine extension create --resource-group "resourceGroupName" --machine-name "myMachineName" --location "regionName" --publisher "Datadog.Agent" --type "DatadogWindowsAgent" --settings '{"site": "us3.datadoghq.com"}' --protected-settings '{"api_key": "YourDatadogAPIKey" }'

Yüklü uzantıları listeleme

Azure Arc özellikli sunucunuzda VM uzantılarının listesini almak için ve --resource-group parametreleriyle kullanın.az connectedmachine extension list --machine-name

Bir örnek aşağıda verilmiştir:

az connectedmachine extension list --machine-name "myMachineName" --resource-group "myResourceGroup"

Varsayılan olarak, Azure CLI komutlarının çıkışı JSON (JavaScript Nesne Gösterimi) şeklindedir. Varsayılan çıkışı bir liste veya tabloyla değiştirmek için, örneğin az config set core.output=table komutunu kullanın. Çıkış biçiminde bir kerelik değişiklik yapmak için herhangi bir komuta da ekleyebilirsiniz --output .

Aşağıdaki örnekte komutundan alınan kısmi JSON çıkışı gösterilmektedir az connectedmachine extension -list :

[
  {
    "autoUpgradingMinorVersion": "false",
    "forceUpdateTag": null,
    "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.HybridCompute/machines/SVR01/extensions/DependencyAgentWindows",
    "location": "regionName",
    "name": "DependencyAgentWindows",
    "namePropertiesInstanceViewName": "DependencyAgentWindows",

Uzantı yapılandırmasını güncelleştirme

Bazı VM uzantıları, bunları Azure Arc özellikli bir sunucuya (Özel Betik Uzantısı gibi) yükleyebilmeniz için yapılandırma ayarları gerektirir. Bir uzantının yapılandırmasını yükseltmek için kullanın az connectedmachine extension update.

Aşağıdaki örnekte Özel Betik Uzantısının nasıl yapılandırılması gösterilmektedir:

az connectedmachine extension update --name "CustomScriptExtension" --type "CustomScriptExtension" --publisher "Microsoft.HybridCompute" --settings "{\"commandToExecute\":\"powershell.exe -c \\\"Get-Process | Where-Object { $_.CPU -lt 100 }\\\"\"}" --type-handler-version "1.10" --machine-name "myMachine" --resource-group "myResourceGroup"

Uzantıları yükseltme

Desteklenen bir VM uzantısının yeni bir sürümü yayınlandığında, bunu bu en son sürüme yükseltebilirsiniz. Vm uzantısını yükseltmek için , --resource-groupve --extension-targets parametreleriyle --machine-namekullanınaz connectedmachine upgrade-extension.

parametresi için --extension-targets uzantıyı ve kullanılabilir en son sürümü belirtmeniz gerekir. Bir uzantı için kullanılabilen en son sürümü belirlemek için Azure portalında seçili Azure Arc özellikli sunucunun Uzantılar sayfasına gidin veya az vm extension image list komutunu çalıştırın. Her ikisini de sağlayarak tek bir yükseltme isteğinde birden çok uzantı belirtebilirsiniz:

  • Yayımcıları ve türleri (noktayla ayrılmış) tarafından tanımlanan, virgülle ayrılmış uzantı listesi
  • Her uzantı için hedef sürüm

komutunu az connectedmachine extension listçalıştırarak yüklü VM uzantılarının sürümünü istediğiniz zaman gözden geçirebilirsiniz. typeHandlerVersion Özellik değeri uzantının sürümünü temsil eder.

Uzantıları kaldırma

Azure Arc özellikli sunucunuzdan yüklü bir VM uzantısını kaldırmak için , ve parametreleriyle kullanın az connectedmachine extension delete --extension-name.--resource-group --machine-name

İlgili içerik