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

Makale
10/01/2024

Bu makalede, Azure Arc özellikli sunucular tarafından desteklenen VM uzantılarını Azure CLI kullanarak Linux veya Windows karma makinesine dağıtma, yükseltme, güncelleştirme ve kaldırma işlemleri gösterilmektedir.

Not

Azure Arc özellikli sunucular, Azure sanal makinelerine VM uzantıları dağıtmayı ve yönetmeyi desteklemez. Azure VM'leri için aşağıdaki 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 Arc özellikli sunucular tarafından yönetilen karma sunucunuzda Azure CLI'yı kullanarak Azure'a bağlanmadan ve VM uzantılarını yönetmeden önce ConnectedMachine uzantısını yüklemeniz gerekir. Bu yönetim işlemleri iş istasyonunuzdan gerçekleştirilebilir; bunları Azure Arc özellikli sunucuda çalıştırmanız gerekmez.

Almak 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 az connectedmachine extension create komutunu , , --extension-name, --location--type, , settingsve --publisher parametreleriyle --machine-namekullanın.

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

az connectedmachine extension create --machine-name "myMachineName" --name "OmsAgentForLinux or MicrosoftMonitoringAgent" --location "regionName" --settings '{\"workspaceId\":\"myWorkspaceId\"}' --protected-settings '{\"workspaceKey\":\"myWorkspaceKey\"}' --resource-group "myResourceGroup" --type-handler-version "1.13" --type "OmsAgentForLinux or MicrosoftMonitoringAgent" --publisher "Microsoft.EnterpriseCloud.Monitoring"

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 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 sunucunuzdaki VM uzantılarının listesini almak için ve --resource-group parametreleriyle --machine-name az connectedmachine extension list komutunu kullanın.

Örnek:

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 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ının Özel Betik Uzantısı ve Log Analytics aracısı VM uzantısı gibi Arc özellikli sunucuya yüklenmesi için yapılandırma ayarları gerekir. Bir uzantının yapılandırmasını yükseltmek için az connectedmachine extension update komutunu kullanın.

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 az connectedmachine upgrade-extension komutunu , --resource-groupve --extension-targets parametreleriyle --machine-namekullanın.

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 Arc özellikli sunucunun Uzantılar sayfasını ziyaret edin veya az vm extension image list komutunu çalıştırın. Tek bir yükseltme isteğinde, yayımcıları ve türleri (noktayla ayrılmış) ve her uzantı için hedef sürüm tarafından tanımlanan, virgülle ayrılmış bir uzantı listesi sağlayarak birden çok uzantı belirtebilirsiniz.

Windows'un daha yeni bir sürümü olan Log Analytics aracı uzantısını yükseltmek için aşağıdaki komutu çalıştırın:

az connectedmachine upgrade-extension --machine-name "myMachineName" --resource-group "myResourceGroup" --extension-targets '{"Microsoft.EnterpriseCloud.Monitoring.MicrosoftMonitoringAgent":{"targetVersion":"1.0.18053.0"}}'

Az connectedmachine extension list komutunu ç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 sunucunuzda yüklü bir VM uzantısını kaldırmak için az connectedmachine extension delete komutunu , --machine-nameve --resource-group parametreleriyle --extension-namekullanın.

Örneğin, Linux için Log Analytics VM uzantısını kaldırmak için aşağıdaki komutu çalıştırın:

az connectedmachine extension delete --machine-name "myMachineName" --name "OmsAgentForLinux" --resource-group "myResourceGroup"

Sonraki adımlar

Azure PowerShell'i kullanarak, Azure portalından veya Azure Resource Manager şablonlarından VM uzantılarını dağıtabilir, yönetebilir ve kaldırabilirsiniz.
Sorun giderme bilgilerini VM uzantıları sorunlarını giderme kılavuzunda bulabilirsiniz.
Komutlar hakkında daha fazla bilgi için Azure CLI VM uzantısına Genel Bakış makalesini gözden geçirin.

Aracılığıyla paylaş