Microsoft.Compute virtualMachines/extensions 2022-11-01

• أحدث
• 2024-07-01
• 2024-03-01
• 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@2022-11-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'
      }
    }
    publisher: 'string'
    settings: any()
    suppressFailures: bool
    type: 'string'
    typeHandlerVersion: 'string'
  }
}

قيم الخصائص

الأجهزة الظاهرية/الملحقات

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

خصائص VirtualMachineExtension

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

VirtualMachineExtensionInstanceView

اسم	وصف	قيمة
اسم	اسم ملحق الجهاز الظاهري.	خيط
حالات	معلومات حالة المورد.	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 VM	ينشئ هذا القالب جهازا ظاهريا ل Ubuntu ويثبت ملحق CustomScript
ملحق تصحيح نظام التشغيل على جهاز Ubuntu الظاهري	ينشئ هذا القالب جهازا ظاهريا ل Ubuntu ويثبت ملحق OSPatching
نشر جهاز Windows ظاهري Premium مع التشخيص	يسمح لك هذا القالب بنشر Premium Windows VM باستخدام بعض الخيارات المختلفة لإصدار 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": "2022-11-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"
      }
    },
    "publisher": "string",
    "settings": {},
    "suppressFailures": "bool",
    "type": "string",
    "typeHandlerVersion": "string"
  }
}

قيم الخصائص

الأجهزة الظاهرية/الملحقات

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

خصائص VirtualMachineExtension

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

VirtualMachineExtensionInstanceView

اسم	وصف	قيمة
اسم	اسم ملحق الجهاز الظاهري.	خيط
حالات	معلومات حالة المورد.	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 VM	ينشئ هذا القالب جهازا ظاهريا ل Ubuntu ويثبت ملحق CustomScript
ملحق تصحيح نظام التشغيل على جهاز Ubuntu الظاهري	ينشئ هذا القالب جهازا ظاهريا ل Ubuntu ويثبت ملحق OSPatching
نشر جهاز Windows ظاهري Premium مع التشخيص	يسمح لك هذا القالب بنشر Premium Windows VM باستخدام بعض الخيارات المختلفة لإصدار 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@2022-11-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"
        }
      }
      publisher = "string"
      suppressFailures = bool
      type = "string"
      typeHandlerVersion = "string"
    }
  })
}

قيم الخصائص

الأجهزة الظاهرية/الملحقات

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

خصائص VirtualMachineExtension

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

VirtualMachineExtensionInstanceView

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

InstanceViewStatus

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

KeyVaultSecretReference

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

مصدر فرعي

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