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

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

إشعار

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

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

• استخدم بيئة Bash في Azure Cloud Shell. لمزيد من المعلومات، راجع التشغيل السريع ل Bash في Azure Cloud Shell.

  

• إذا كنت تفضل تشغيل أوامر مرجع CLI محلياً قم بتثبيت CLI Azure. إذا كنت تعمل على نظام تشغيل Windows أو macOS، ففكر في تشغيل Azure CLI في حاوية Docker. لمزيد من المعلومات، راجع كيفية تشغيل Azure CLI في حاوية Docker.

  • إذا كنت تستخدم تثبيت محلي، يُرجى تسجيل الدخول إلى Azure CLI مستخدمًا أمر az login. لإنهاء عملية المصادقة، اتبع الخطوات المعروضة في جهازك. للحصول على خيارات أخرى لتسجيل دخول، راجع تسجيل الدخول باستخدام Azure CLI.

  • عندما يُطلب منك، قم بتثبيت ملحق Azure CLI عند الاستخدام لأول مرة. لمزيد من المعلومات بشأن الامتدادات، راجع استخدام امتدادات مع Azure CLI.

  • يُرجى تشغيل إصدار az للوصول إلى الإصدار والمكتبات التابعة التي تم تثبيتها. للتحديث لآخر إصدار، يُرجى تشغيل تحديث az.

تثبيت امتداد Azure CLI

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

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

az extension add --name connectedmachine

تمكين الملحق

لتمكين ملحق الجهاز الظاهري على خادم Azure Arc الممكن، استخدم az connectedmachine extension create مع --type--publisher --machine-name--extension-name--locationsettingsالمعلمات و.

يتيح المثال التالي ملحق Log Analytics VM على خادم 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\"}"'

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

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

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

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

مثال:

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

بشكل افتراضي، يكون إخراج أوامر Azure CLI في JSON (JavaScript Object Notation). لتغيير الإخراج الافتراضي إلى قائمة أو جدول، على سبيل المثال، استخدم az config set 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 extension update.

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

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"

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

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

بالنسبة للمعلمة --extension-targets ، تحتاج إلى تحديد الملحق وأحدث إصدار متوفر. لمعرفة أحدث إصدار متوفر، يمكنك الحصول على هذه المعلومات من صفحة الملحقات للخادم المحدد الممكن بواسطة Arc في مدخل Microsoft 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\"}}'

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

إزالة الملحقات

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

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

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

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

• يمكنك نشر ملحقات الجهاز الظاهري وإدارتها وإزالتها باستخدام Azure PowerShell أو من مدخل Microsoft Azure أو قوالب Azure Resource Manager.

• يمكن العثور على معلومات استكشاف الأخطاء وإصلاحها في دليل ملحقات الأجهزة الظاهرية وإصلاحها.

• راجع مقالة نظرة عامة على ملحق Azure CLI VM للحصول على مزيد من المعلومات حول الأوامر.