تمكين ملحقات Azure VM باستخدام Azure CLI

  • مقالة
  • قراءة خلال 4 دقائق

توضح لك هذه المقالة كيفية نشر ملحقات الأجهزة الظاهرية وترقيتها وتحديثها وإزالة تثبيتها، التي تدعمها الخوادم التي تدعم Azure Arc، إلى جهاز مختلط يعمل بنظام التشغيل Linux أو Windows باستخدام Azure CLI.

ملاحظة

لا تدعم الخوادم التي تدعم Azure Arc نشر ملحقات الأجهزة الظاهرية وإدارتها على أجهزة Azure الظاهرية. بالنسبة إلى الأجهزة الظاهرية ل Azure، راجع مقالة نظرة عامة على ملحق الجهاز الظاهري التالية.

المتطلبات الأساسية

ثبّت ملحق Azure CLI

لا يتم شحن أوامر ConnectedMachine كجزء من Azure CLI. قبل استخدام Azure CLI للاتصال ب Azure وإدارة ملحقات الأجهزة الظاهرية على الخادم المختلط الذي تديره الخوادم التي تدعم Azure Arc، تحتاج إلى تحميل ملحق ConnectedMachine. يمكن تنفيذ عمليات الإدارة هذه من محطة العمل الخاصة بك، ولا تحتاج إلى تشغيلها على الخادم الذي يدعم Azure Arc.

قم بتشغيل الأمر التالي للحصول عليه:

az extension add --name connectedmachine

تمكين الإضافة

لتمكين ملحق VM على الخادم الذي تم تمكين Azure Arc له، استخدم إنشاء ملحق az connectedmachine باستخدام المعلمات --machine-name--extension-nameو و --locationو --type، settingsو ، و --publisher

يمكن المثال التالي ملحق الجهاز الظاهري Log Analytics على خادم ممكن بواسطة Azure Arc:

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"

يمكن المثال التالي ملحق البرنامج النصي المخصص على خادم ممكن بواسطة Azure Arc:

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"

يتيح المثال التالي ملحق Key Vault VM على خادم ممكن بواسطة Azure Arc:

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" }}'

يتيح المثال التالي ملحق Microsoft Antimalware على خادم Windows ممكن بواسطة Azure Arc:

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

ملحقات القائمة المثبتة

للحصول على قائمة بملحقات الجهاز الظاهري على الخادم الذي تم تمكين Azure Arc له، استخدم قائمة ملحقات az connectedmachine مع المعلمات --machine-name والمعلمات --resource-group .

مثال:

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

بشكل افتراضي، يكون إخراج أوامر Azure CLI في JSON (تدوين كائن جافا سكريبت). لتغيير الإخراج الافتراضي إلى قائمة أو جدول، على سبيل المثال، استخدم مجموعة التهيئة az core.output=table. يمكنك أيضا الإضافة إلى أي أمر لتغيير لمرة واحدة في تنسيق الإخراج --output .

يوضح المثال التالي إخراج JSON الجزئي من 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",

تحديث تكوين الإضافة

تتطلب بعض ملحقات الأجهزة الظاهرية إعدادات التكوين لتثبيتها على الخادم الذي يدعم Arc، مثل ملحق البرنامج النصي المخصص وملحق الجهاز الظاهري لوكيل Log Analytics. لترقية تكوين ملحق، استخدم تحديث ملحق az connectedmachine.

يوضح المثال التالي كيفية تكوين ملحق البرنامج النصي المخصص:

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"

ملحقات الترقية

عند إصدار إصدار جديد من ملحق VM مدعوم، يمكنك ترقيته إلى هذا الإصدار الأخير. لترقية ملحق جهاز ظاهري، استخدم ملحق ترقية az connectedmachine مع المعلمات --machine-name، --resource-groupو --extension-targets .

بالنسبة للمعلمة --extension-targets ، تحتاج إلى تحديد الامتداد وأحدث إصدار متاح. لمعرفة أحدث إصدار متوفر، يمكنك الحصول على هذه المعلومات من صفحة الملحقات للخادم المحدد الذي تم تمكين Arc في مدخل Azure، أو عن طريق تشغيل قائمة صور ملحق az vm. يمكنك تحديد ملحقات متعددة في طلب ترقية واحد من خلال توفير قائمة إضافات مفصولة بفواصل، يحددها ناشرها ونوعها (مفصولة بنقطة) والإصدار المستهدف لكل إضافة، كما هو موضح في المثال أدناه.

لترقية ملحق عامل Log Analytics Windows يتوفر به إصدار أحدث، قم بتشغيل الأمر التالي:

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

يمكنك مراجعة إصدار ملحقات VM المثبتة في أي وقت عن طريق تشغيل قائمة ملحقات الأمر az connectedmachine. typeHandlerVersion تمثل قيمة الخاصية إصدار الملحق.

إزالة الإضافات

لإزالة ملحق VM مثبت على الخادم الذي تم تمكين Azure Arc له، استخدم az connectedmachine delete مع المعلمات --extension-name، --machine-nameو --resource-group .

على سبيل المثال، لإزالة ملحق Log Analytics VM لنظام التشغيل Linux، قم بتشغيل الأمر التالي:

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

الخطوات التالية