Microsoft.Compute virtualMachines/extensions

• الأحدث
• 2023-09-01
• 2023-07-01
• 2023-03-01
• 2022-11-01
• 2022-08-01
• 2022-03-01
• 2021-11-01
• 2021-07-01
• 2021-04-01
• 2021-03-01
• 2020-12-01

تعريف مورد Bicep

يمكن نشر نوع مورد virtualMachines/extensions مع العمليات التي تستهدف:

• مجموعات الموارد - راجع أوامر نشر مجموعة الموارد

للحصول على قائمة بالخصائص التي تم تغييرها في كل إصدار من إصدارات واجهة برمجة التطبيقات، راجع سجل التغيير.

تنسيق المورد

لإنشاء مورد Microsoft.Compute/virtualMachines/extensions، أضف Bicep التالي إلى القالب الخاص بك.

resource symbolicname 'Microsoft.Compute/virtualMachines/extensions@2023-09-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  parent: resourceSymbolicName
  properties: {
    autoUpgradeMinorVersion: bool
    enableAutomaticUpgrade: bool
    forceUpdateTag: 'string'
    instanceView: {
      name: 'string'
      statuses: [
        {
          code: 'string'
          displayStatus: 'string'
          level: 'string'
          message: 'string'
          time: 'string'
        }
      ]
      substatuses: [
        {
          code: 'string'
          displayStatus: 'string'
          level: 'string'
          message: 'string'
          time: 'string'
        }
      ]
      type: 'string'
      typeHandlerVersion: 'string'
    }
    protectedSettings: any()
    protectedSettingsFromKeyVault: {
      secretUrl: 'string'
      sourceVault: {
        id: 'string'
      }
    }
    provisionAfterExtensions: [
      'string'
    ]
    publisher: 'string'
    settings: any()
    suppressFailures: bool
    type: 'string'
    typeHandlerVersion: 'string'
  }
}

قيم Property

virtualMachines/extensions

الاسم	الوصف	القيمة
الاسم	اسم المورد تعرف على كيفية تعيين الأسماء والأنواع للموارد التابعة في Bicep.	سلسلة (مطلوبة)
الموقع	موقع المورد	سلسلة
العلامات	علامات الموارد	قاموس أسماء العلامات والقيم. راجع العلامات في القوالب
أصل	في Bicep، يمكنك تحديد المورد الأصل لمورد تابع. تحتاج فقط إلى إضافة هذه الخاصية عند الإعلان عن المورد التابع خارج المورد الأصل. لمزيد من المعلومات، راجع المورد التابع خارج المورد الأصل.	الاسم الرمزي للمورد من النوع: virtualMachines
خصائص	يصف خصائص ملحق الجهاز الظاهري.	VirtualMachineExtensionProperties

VirtualMachineExtensionProperties

الاسم	الوصف	القيمة
autoUpgradeMinorVersion	يشير إلى ما إذا كان يجب أن يستخدم الملحق إصدارا ثانويا أحدث إذا كان متوفرا في وقت التوزيع. ومع ذلك، بمجرد توزيعها، لن يعمل الملحق على ترقية الإصدارات الثانوية ما لم يتم إعادة توزيعها، حتى مع تعيين هذه الخاصية إلى صواب.	Bool
enableAutomaticUpgrade	يشير إلى ما إذا كان يجب ترقية الملحق تلقائيا بواسطة النظام الأساسي إذا كان هناك إصدار أحدث من الملحق المتوفر.	Bool
forceUpdateTag	كيف يجب إجبار معالج الملحق على التحديث حتى إذا لم يتغير تكوين الملحق.	سلسلة
instanceView	عرض مثيل ملحق الجهاز الظاهري.	VirtualMachineExtensionInstanceView
إعدادات محمية	يمكن أن يحتوي الملحق إما على protectedSettings أو protectedSettingsFromKeyVault أو لا توجد إعدادات محمية على الإطلاق.	بالنسبة إلى Bicep، يمكنك استخدام الدالة any().
protectedSettingsFromKeyVault	الإعدادات المحمية للملحقات التي يتم تمريرها حسب المرجع، واستهلاكها من مخزن المفاتيح	KeyVaultSecretReference
provisionAfterExtensions	مجموعة من أسماء الملحقات التي يجب بعد ذلك توفير هذا الملحق.	سلسلة []
الناشر	اسم ناشر معالج الملحق.	سلسلة
الإعدادات	إعدادات Json العامة المنسقة للملحق.	بالنسبة إلى Bicep، يمكنك استخدام الدالة any().
منعFailures	يشير إلى ما إذا كان سيتم منع حالات الفشل النابعة من الملحق (لن يتم منع حالات الفشل التشغيلية مثل عدم الاتصال بالجهاز الظاهري بغض النظر عن هذه القيمة). يعد الافتراضي غير صحيح.	Bool
النوع	يحدد نوع الملحق؛ مثال على ذلك هو "CustomScriptExtension".	سلسلة
typeHandlerVersion	يحدد إصدار معالج البرنامج النصي.	سلسلة

VirtualMachineExtensionInstanceView

الاسم	الوصف	القيمة
الاسم	اسم ملحق الجهاز الظاهري.	سلسلة
statuses	معلومات حالة المورد.	InstanceViewStatus[]
الإحصائيات الفرعية	معلومات حالة المورد.	InstanceViewStatus[]
النوع	يحدد نوع الملحق؛ مثال على ذلك هو "CustomScriptExtension".	سلسلة
typeHandlerVersion	يحدد إصدار معالج البرنامج النصي.	سلسلة

InstanceViewStatus

الاسم	الوصف	القيمة
الرمز	رمز الحالة.	سلسلة
displayStatus	التسمية القصيرة القابلة للترجمة للحالة.	سلسلة
المستوى	التعليمات البرمجية للمستوى.	"خطأ" "معلومات" "تحذير"
رسالة	رسالة الحالة التفصيلية، بما في ذلك التنبيهات ورسائل الخطأ.	سلسلة
الوقت	وقت الحالة.	سلسلة

KeyVaultSecretReference

الاسم	الوصف	القيمة
secretUrl	يشير عنوان URL إلى سر في Key Vault.	سلسلة (مطلوبة)
sourceVault	عنوان URL النسبي Key Vault يحتوي على السر.	مصدر فرعي (مطلوب)

مصدر فرعي

الاسم	الوصف	القيمة
المعرف	معرف المورد	سلسلة

قوالب التشغيل السريع

تنشر قوالب التشغيل السريع التالية نوع المورد هذا.

قالب	الوصف
إنشاء جهاز ظاهري يعمل بنظام Windows مع تمكين ملحق مكافحة البرامج الضارة	يقوم هذا القالب بإنشاء جهاز ظاهري يعمل بنظام Windows وإعداد الحماية من البرامج الضارة
خادم IIS باستخدام ملحق DSC على جهاز ظاهري يعمل بنظام Windows	يقوم هذا القالب بإنشاء جهاز ظاهري يعمل بنظام Windows وإعداد خادم IIS باستخدام ملحق DSC. ملاحظة، تحتاج وحدة تكوين DSC إلى رمز SAS مميز ليتم تمريره إذا كنت تستخدم Azure Storage. بالنسبة إلى ارتباط وحدة DSC من GitHub (الافتراضي في هذا القالب)، لا يلزم ذلك.
ملحق جهاز ESET الظاهري	إنشاء جهاز ظاهري بملحق ESET
McAfee Endpoint Security (ترخيص تجريبي) على Windows VM	ينشئ هذا القالب جهازا ظاهريا يعمل بنظام Windows وينشئ إصدارا تجريبيا من McAfee Endpoint Security
نشر جهاز Ubuntu ظاهري مع ملحق OMS	يسمح لك هذا القالب بنشر جهاز ظاهري Ubuntu مع تثبيت ملحق OMS وإلحاقه بمساحة عمل محددة
نشر جهاز ظاهري يعمل بنظام Windows مع ملحق OMS	يسمح لك هذا القالب بنشر جهاز ظاهري يعمل بنظام Windows مع تثبيت ملحق OMS وإلحاقه بمساحة عمل محددة
الإصدار التجريبي لملحق Symantec Endpoint Protection على Windows VM	ينشئ هذا القالب جهازا ظاهريا يعمل بنظام Windows وينشئ إصدارا تجريبيا من Symantec Endpoint Protection
ملحق البرنامج النصي المخصص على جهاز Ubuntu الظاهري	ينشئ هذا القالب جهازا ظاهريا ل Ubuntu ويثبت ملحق CustomScript
ملحق تصحيح نظام التشغيل على جهاز Ubuntu الظاهري	ينشئ هذا القالب جهازا ظاهريا ل Ubuntu ويثبت ملحق OSPatching
نشر جهاز Windows ظاهري متميز مع التشخيصات	يسمح لك هذا القالب بنشر جهاز Windows ظاهري Premium باستخدام بعض الخيارات المختلفة لإصدار Windows، باستخدام أحدث إصدار مصحح.
نشر جهاز ظاهري بسيط يعمل بنظام Windows مع المراقبة والتشخيص	يسمح لك هذا القالب بنشر جهاز ظاهري بسيط يعمل بنظام Windows مع ملحق التشخيص الذي يتيح المراقبة والتشخيص للجهاز الظاهري
استخدام ملحقات البرنامج النصي لتثبيت Mongo DB على Ubuntu VM	يوزع هذا القالب تكوين وتثبيت Mongo DB على جهاز Ubuntu الظاهري في برنامجين نصيين منفصلين. هذا القالب هو مثال جيد يوضح كيفية التعبير عن التبعيات بين برنامجين نصيين يعملان على نفس الجهاز الظاهري. ينشر هذا القالب أيضا حساب تخزين وشبكة ظاهرية وعناوين IP عامة وواجهة شبكة.

تعريف مورد قالب ARM

يمكن نشر نوع مورد virtualMachines/extensions مع العمليات التي تستهدف:

• مجموعات الموارد - راجع أوامر نشر مجموعة الموارد

للحصول على قائمة بالخصائص التي تم تغييرها في كل إصدار من إصدارات واجهة برمجة التطبيقات، راجع سجل التغيير.

تنسيق المورد

لإنشاء مورد Microsoft.Compute/virtualMachines/extensions، أضف JSON التالي إلى القالب الخاص بك.

{
  "type": "Microsoft.Compute/virtualMachines/extensions",
  "apiVersion": "2023-09-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "properties": {
    "autoUpgradeMinorVersion": "bool",
    "enableAutomaticUpgrade": "bool",
    "forceUpdateTag": "string",
    "instanceView": {
      "name": "string",
      "statuses": [
        {
          "code": "string",
          "displayStatus": "string",
          "level": "string",
          "message": "string",
          "time": "string"
        }
      ],
      "substatuses": [
        {
          "code": "string",
          "displayStatus": "string",
          "level": "string",
          "message": "string",
          "time": "string"
        }
      ],
      "type": "string",
      "typeHandlerVersion": "string"
    },
    "protectedSettings": {},
    "protectedSettingsFromKeyVault": {
      "secretUrl": "string",
      "sourceVault": {
        "id": "string"
      }
    },
    "provisionAfterExtensions": [ "string" ],
    "publisher": "string",
    "settings": {},
    "suppressFailures": "bool",
    "type": "string",
    "typeHandlerVersion": "string"
  }
}

قيم Property

virtualMachines/extensions

الاسم	الوصف	القيمة
النوع	نوع المورد	'Microsoft.Compute/virtualMachines/extensions'
apiVersion	إصدار واجهة برمجة تطبيقات المورد	'2023-09-01'
الاسم	اسم المورد تعرف على كيفية تعيين الأسماء والأنواع للموارد التابعة في قوالب JSON ARM.	سلسلة (مطلوب)
الموقع	موقع المورد	سلسلة
العلامات	علامات الموارد	قاموس أسماء العلامات والقيم. راجع العلامات في القوالب
خصائص	يصف خصائص ملحق الجهاز الظاهري.	VirtualMachineExtensionProperties

VirtualMachineExtensionProperties

الاسم	الوصف	القيمة
autoUpgradeMinorVersion	يشير إلى ما إذا كان يجب أن يستخدم الملحق إصدارا ثانويا أحدث إذا كان متوفرا في وقت التوزيع. ومع ذلك، بمجرد توزيعها، لن يعمل الملحق على ترقية الإصدارات الثانوية ما لم يتم إعادة توزيعها، حتى مع تعيين هذه الخاصية إلى صواب.	Bool
enableAutomaticUpgrade	يشير إلى ما إذا كان يجب ترقية الملحق تلقائيا بواسطة النظام الأساسي إذا كان هناك إصدار أحدث من الملحق المتوفر.	Bool
forceUpdateTag	كيف يجب إجبار معالج الملحق على التحديث حتى إذا لم يتغير تكوين الملحق.	سلسلة
instanceView	طريقة عرض مثيل ملحق الجهاز الظاهري.	VirtualMachineExtensionInstanceView
إعدادات محمية	يمكن أن يحتوي الملحق إما على protectedSettings أو protectedSettingsFromKeyVault أو لا توجد إعدادات محمية على الإطلاق.
protectedSettingsFromKeyVault	الإعدادات المحمية للملحقات التي يتم تمريرها بواسطة المرجع، والمستهلكة من مخزن المفاتيح	KeyVaultSecretReference
provisionAfterExtensions	مجموعة من أسماء الملحقات التي يجب بعد ذلك توفير هذا الملحق.	سلسلة []
الناشر	اسم ناشر معالج الملحق.	سلسلة
الإعدادات	إعدادات Json العامة المنسقة للملحق.
منعFailures	يشير إلى ما إذا كان سيتم منع حالات الفشل النابعة من الملحق (لن يتم منع حالات الفشل التشغيلية مثل عدم الاتصال بالجهاز الظاهري بغض النظر عن هذه القيمة). يعد الافتراضي غير صحيح.	Bool
النوع	يحدد نوع الملحق؛ مثال على ذلك هو "CustomScriptExtension".	سلسلة
typeHandlerVersion	يحدد إصدار معالج البرنامج النصي.	سلسلة

VirtualMachineExtensionInstanceView

الاسم	الوصف	القيمة
الاسم	اسم ملحق الجهاز الظاهري.	سلسلة
statuses	معلومات حالة المورد.	InstanceViewStatus[]
الإحصائيات الفرعية	معلومات حالة المورد.	InstanceViewStatus[]
النوع	يحدد نوع الملحق؛ مثال على ذلك هو "CustomScriptExtension".	سلسلة
typeHandlerVersion	يحدد إصدار معالج البرنامج النصي.	سلسلة

InstanceViewStatus

الاسم	الوصف	القيمة
الرمز	رمز الحالة.	سلسلة
displayStatus	التسمية القصيرة القابلة للترجمة للحالة.	سلسلة
المستوى	التعليمات البرمجية للمستوى.	"خطأ" "معلومات" "تحذير"
رسالة	رسالة الحالة التفصيلية، بما في ذلك التنبيهات ورسائل الخطأ.	سلسلة
الوقت	وقت الحالة.	سلسلة

KeyVaultSecretReference

الاسم	الوصف	القيمة
secretUrl	يشير عنوان URL إلى سر في Key Vault.	سلسلة (مطلوبة)
sourceVault	عنوان URL النسبي Key Vault يحتوي على السر.	مصدر فرعي (مطلوب)

مصدر فرعي

الاسم	الوصف	القيمة
المعرف	معرف المورد	سلسلة

قوالب التشغيل السريع

تنشر قوالب التشغيل السريع التالية نوع المورد هذا.

قالب	الوصف
إنشاء جهاز ظاهري يعمل بنظام Windows مع تمكين ملحق مكافحة البرامج الضارة	يقوم هذا القالب بإنشاء جهاز ظاهري يعمل بنظام Windows وإعداد الحماية من البرامج الضارة
خادم IIS باستخدام ملحق DSC على جهاز ظاهري يعمل بنظام Windows	يقوم هذا القالب بإنشاء جهاز ظاهري يعمل بنظام Windows وإعداد خادم IIS باستخدام ملحق DSC. ملاحظة، تحتاج وحدة تكوين DSC إلى رمز SAS مميز ليتم تمريره إذا كنت تستخدم Azure Storage. بالنسبة إلى ارتباط وحدة DSC من GitHub (الافتراضي في هذا القالب)، لا يلزم ذلك.
ملحق جهاز ESET الظاهري	إنشاء جهاز ظاهري بملحق ESET
McAfee Endpoint Security (ترخيص تجريبي) على Windows VM	ينشئ هذا القالب جهازا ظاهريا يعمل بنظام Windows وينشئ إصدارا تجريبيا من McAfee Endpoint Security
نشر جهاز Ubuntu ظاهري مع ملحق OMS	يسمح لك هذا القالب بنشر جهاز ظاهري Ubuntu مع تثبيت ملحق OMS وإلحاقه بمساحة عمل محددة
نشر جهاز ظاهري يعمل بنظام Windows مع ملحق OMS	يسمح لك هذا القالب بنشر جهاز ظاهري يعمل بنظام Windows مع تثبيت ملحق OMS وإلحاقه بمساحة عمل محددة
الإصدار التجريبي لملحق Symantec Endpoint Protection على Windows VM	ينشئ هذا القالب جهازا ظاهريا يعمل بنظام Windows وينشئ إصدارا تجريبيا من Symantec Endpoint Protection
ملحق البرنامج النصي المخصص على جهاز Ubuntu الظاهري	ينشئ هذا القالب جهازا ظاهريا ل Ubuntu ويثبت ملحق CustomScript
ملحق تصحيح نظام التشغيل على جهاز Ubuntu الظاهري	ينشئ هذا القالب جهازا ظاهريا ل Ubuntu ويثبت ملحق OSPatching
نشر جهاز Windows ظاهري متميز مع التشخيصات	يسمح لك هذا القالب بنشر جهاز Windows ظاهري Premium باستخدام بعض الخيارات المختلفة لإصدار Windows، باستخدام أحدث إصدار مصحح.
نشر جهاز ظاهري بسيط يعمل بنظام Windows مع المراقبة والتشخيص	يسمح لك هذا القالب بنشر جهاز ظاهري بسيط يعمل بنظام Windows مع ملحق التشخيص الذي يتيح المراقبة والتشخيص للجهاز الظاهري
استخدام ملحقات البرنامج النصي لتثبيت Mongo DB على Ubuntu VM	يوزع هذا القالب تكوين وتثبيت Mongo DB على جهاز Ubuntu الظاهري في برنامجين نصيين منفصلين. هذا القالب هو مثال جيد يوضح كيفية التعبير عن التبعيات بين برنامجين نصيين يعملان على نفس الجهاز الظاهري. ينشر هذا القالب أيضا حساب تخزين وشبكة ظاهرية وعناوين IP عامة وواجهة شبكة.

تعريف مورد Terraform (موفر AzAPI)

يمكن نشر نوع مورد virtualMachines/extensions مع العمليات التي تستهدف:

• مجموعات الموارد

للحصول على قائمة بالخصائص التي تم تغييرها في كل إصدار من إصدارات واجهة برمجة التطبيقات، راجع سجل التغيير.

تنسيق المورد

لإنشاء مورد Microsoft.Compute/virtualMachines/extensions، أضف Terraform التالي إلى القالب الخاص بك.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/virtualMachines/extensions@2023-09-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      autoUpgradeMinorVersion = bool
      enableAutomaticUpgrade = bool
      forceUpdateTag = "string"
      instanceView = {
        name = "string"
        statuses = [
          {
            code = "string"
            displayStatus = "string"
            level = "string"
            message = "string"
            time = "string"
          }
        ]
        substatuses = [
          {
            code = "string"
            displayStatus = "string"
            level = "string"
            message = "string"
            time = "string"
          }
        ]
        type = "string"
        typeHandlerVersion = "string"
      }
      protectedSettingsFromKeyVault = {
        secretUrl = "string"
        sourceVault = {
          id = "string"
        }
      }
      provisionAfterExtensions = [
        "string"
      ]
      publisher = "string"
      suppressFailures = bool
      type = "string"
      typeHandlerVersion = "string"
    }
  })
}

قيم Property

virtualMachines/extensions

الاسم	الوصف	القيمة
النوع	نوع المورد	"Microsoft.Compute/virtualMachines/extensions@2023-09-01"
الاسم	اسم المورد	سلسلة (مطلوبة)
الموقع	موقع المورد	سلسلة
parent_id	معرف المورد الأصل لهذا المورد.	معرف المورد من النوع: virtualMachines
العلامات	علامات الموارد	قاموس أسماء العلامات والقيم.
خصائص	يصف خصائص ملحق الجهاز الظاهري.	VirtualMachineExtensionProperties

VirtualMachineExtensionProperties

الاسم	الوصف	القيمة
autoUpgradeMinorVersion	يشير إلى ما إذا كان يجب أن يستخدم الملحق إصدارا ثانويا أحدث إذا كان متوفرا في وقت التوزيع. ومع ذلك، بمجرد توزيعها، لن يعمل الملحق على ترقية الإصدارات الثانوية ما لم يتم إعادة توزيعها، حتى مع تعيين هذه الخاصية إلى صواب.	Bool
enableAutomaticUpgrade	يشير إلى ما إذا كان يجب ترقية الملحق تلقائيا بواسطة النظام الأساسي إذا كان هناك إصدار أحدث من الملحق المتوفر.	Bool
forceUpdateTag	كيف يجب إجبار معالج الملحق على التحديث حتى إذا لم يتغير تكوين الملحق.	سلسلة
instanceView	عرض مثيل ملحق الجهاز الظاهري.	VirtualMachineExtensionInstanceView
إعدادات محمية	يمكن أن يحتوي الملحق إما على protectedSettings أو protectedSettingsFromKeyVault أو لا توجد إعدادات محمية على الإطلاق.
protectedSettingsFromKeyVault	الإعدادات المحمية للملحقات التي يتم تمريرها حسب المرجع، واستهلاكها من مخزن المفاتيح	KeyVaultSecretReference
provisionAfterExtensions	مجموعة من أسماء الملحقات التي يجب بعد ذلك توفير هذا الملحق.	سلسلة []
الناشر	اسم ناشر معالج الملحق.	سلسلة
الإعدادات	إعدادات Json العامة المنسقة للملحق.
منعFailures	يشير إلى ما إذا كان سيتم منع حالات الفشل النابعة من الملحق (لن يتم منع حالات الفشل التشغيلية مثل عدم الاتصال بالجهاز الظاهري بغض النظر عن هذه القيمة). يعد الافتراضي غير صحيح.	Bool
النوع	يحدد نوع الملحق؛ مثال على ذلك هو "CustomScriptExtension".	سلسلة
typeHandlerVersion	يحدد إصدار معالج البرنامج النصي.	سلسلة

VirtualMachineExtensionInstanceView

الاسم	الوصف	القيمة
الاسم	اسم ملحق الجهاز الظاهري.	سلسلة
statuses	معلومات حالة المورد.	InstanceViewStatus[]
الإحصائيات الفرعية	معلومات حالة المورد.	InstanceViewStatus[]
النوع	يحدد نوع الملحق؛ مثال على ذلك هو "CustomScriptExtension".	سلسلة
typeHandlerVersion	يحدد إصدار معالج البرنامج النصي.	سلسلة

InstanceViewStatus

الاسم	الوصف	القيمة
الرمز	رمز الحالة.	سلسلة
displayStatus	التسمية القصيرة القابلة للترجمة للحالة.	سلسلة
المستوى	التعليمات البرمجية للمستوى.	"خطأ" "معلومات" "تحذير"
رسالة	رسالة الحالة التفصيلية، بما في ذلك التنبيهات ورسائل الخطأ.	سلسلة
الوقت	وقت الحالة.	سلسلة

KeyVaultSecretReference

الاسم	الوصف	القيمة
secretUrl	يشير عنوان URL إلى سر في Key Vault.	سلسلة (مطلوبة)
sourceVault	عنوان URL النسبي Key Vault يحتوي على السر.	مصدر فرعي (مطلوب)

مصدر فرعي

الاسم	الوصف	القيمة
المعرف	معرف المورد	سلسلة