مشاركة عبر

مجمعات مضيف Microsoft.DesktopVirtualization

تعريف مورد Bicep

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

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

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

تنسيق المورد

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

resource symbolicname 'Microsoft.DesktopVirtualization/hostPools@2026-01-01-preview' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  kind: 'string'
  location: 'string'
  managedBy: 'string'
  name: 'string'
  plan: {
    name: 'string'
    product: 'string'
    promotionCode: 'string'
    publisher: 'string'
    version: 'string'
  }
  properties: {
    agentUpdate: {
      maintenanceWindows: [
        {
          dayOfWeek: 'string'
          hour: int
        }
      ]
      maintenanceWindowTimeZone: 'string'
      type: 'string'
      useSessionHostLocalTime: bool
    }
    allowRDPShortPathWithPrivateLink: 'string'
    customRdpProperty: 'string'
    deploymentScope: 'string'
    description: 'string'
    directUDP: 'string'
    friendlyName: 'string'
    hostPoolType: 'string'
    loadBalancerType: 'string'
    managedPrivateUDP: 'string'
    managementType: 'string'
    maxSessionLimit: int
    oboTenantId: 'string'
    personalDesktopAssignmentType: 'string'
    preferredAppGroupType: 'string'
    publicNetworkAccess: 'string'
    publicUDP: 'string'
    registrationInfo: {
      expirationTime: 'string'
      registrationTokenOperation: 'string'
      token: 'string'
    }
    relayUDP: 'string'
    ring: int
    ssoadfsAuthority: 'string'
    ssoClientId: 'string'
    ssoClientSecretKeyVaultPath: 'string'
    ssoSecretType: 'string'
    startVMOnConnect: bool
    validationEnvironment: bool
    vmTemplate: 'string'
  }
  sku: {
    capacity: int
    family: 'string'
    name: 'string'
    size: 'string'
    tier: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

قيم الخصائص

Microsoft.DesktopVirtualization/hostPools

اسم وصف قيمة
الهوية هويات الخدمة المدارة المعينة لهذا المورد. ManagedServiceIdentity
نوع بيانات التعريف المستخدمة من قبل المدخل/الأدوات/إلخ لتقديم تجارب تجربة المستخدم المختلفة للموارد من نفس النوع؛ على سبيل المثال، ApiApps هي نوع من أنواع Microsoft.Web/sites. إذا كان مدعوما، يجب على موفر الموارد التحقق من صحة هذه القيمة واستمرارها. خيط

القيود:
النمط = ^[-\w\._,\(\)]+$
مكان الموقع الجغرافي حيث يعيش المورد سلسلة (مطلوب)
مدارة بواسطة معرف المورد المؤهل بالكامل للمورد الذي يدير هذا المورد. يشير إلى ما إذا كان هذا المورد مدارا بواسطة مورد Azure آخر. إذا كان هذا موجودا، فلن يؤدي نشر الوضع الكامل إلى حذف المورد إذا تمت إزالته من القالب نظرا لأنه تتم إدارته بواسطة مورد آخر. خيط
اسم اسم المورد خيط

القيود:
الحد الأدنى للطول = 3
الحد الأقصى للطول = 64
النمط = ^[A-Za-z0-9@.\-_ ]*$ (مطلوب)
خطة تفاصيل خطة الموارد. خطة
خصائص خصائص مفصلة ل HostPool HostPoolProperties (مطلوب)
سكو وحدة حفظ المخزون (وحدة حفظ المخزون) المعينة لهذا المورد. Sku
العلامات علامات الموارد قاموس أسماء العلامات والقيم. راجع العلامات في القوالب

خصائص تحديث العامل

اسم وصف قيمة
صيانةWindows قائمة نوافذ الصيانة. نوافذ الصيانة 2 ساعة طويلة. MaintenanceWindowProperties []
الصيانةWindowTimeZone المنطقة الزمنية للصيانة كما هو محدد في /dotnet/api/system.timezoneinfo.findsystemtimezonebyid?view=net-5.0. يجب تعيين إذا كان useLocalTime صحيحا. خيط
نوع نوع الصيانة لمكونات مضيف جلسة العمل. "افتراضي"
"مجدول"
استخدامSessionHostLocalTime ما إذا كنت تريد استخدام localTime للجهاز الظاهري. قيمة منطقية

خصائص مجمع المضيف

اسم وصف قيمة
تحديث الوكيل تكوين مضيف جلسة العمل لتحديث العامل وعامل المراقبة ومكون المكدس. خصائص تحديث العامل
allowRDPShortPathWithPrivateLink يتحكم في ما إذا كان يسمح باستخدام نقل RDPShortPath، وربما تجاوز مسارات الروابط الخاصة. "معطل"
"ممكن"
CustomRdpProperty خاصية rdp المخصصة ل HostPool. خيط
نطاق النشر نوع DeploymentScope ل HostPool. 'جغرافيائي'
"إقليمي"
وصف وصف HostPool. خيط
دايركت يو دي بي الافتراضي: يتم استخدام الإعدادات على مستوى AVD لتحديد توفر الاتصال، ممكن: سيحاول UDP هذا النوع من الاتصال عند إجراء اتصالات. وهذا يعني أن هذا الاتصال ممكن، ولكنه غير مضمون، نظرا لوجود عوامل أخرى قد تمنع نوع الاتصال هذا، معطل: لن يحاول UDP هذا النوع من الاتصال عند إجراء اتصالات "افتراضي"
"معطل"
"ممكن"
اسم مألوف اسم مألوف ل HostPool. خيط
نوعPool المضيف نوع HostPool لسطح المكتب. "BYODesktop"
"شخصي"
"مجمع" (مطلوب)
نوع موازن التحميل نوع موازن التحميل. 'أداة الاتساع'
"العمق أولا"
"متعدد الأقسام"
"مستمر" (مطلوب)
managedPrivateUDP الافتراضي: يتم استخدام الإعدادات على مستوى AVD لتحديد توفر الاتصال، ممكن: سيحاول UDP هذا النوع من الاتصال عند إجراء اتصالات. وهذا يعني أن هذا الاتصال ممكن، ولكنه غير مضمون، نظرا لوجود عوامل أخرى قد تمنع نوع الاتصال هذا، معطل: لن يحاول UDP هذا النوع من الاتصال عند إجراء اتصالات "افتراضي"
"معطل"
"ممكن"
نوع الإدارة نوع الإدارة ل hostpool أو Automated أو Standard هذا. القيمة الافتراضية هي Automated. "تلقائي"
"قياسي"
maxSessionLimit الحد الأقصى لجلسة عمل HostPool. الباحث
معرف المستأجر المستأجر الذي يطلب المورد نيابة عنه. خيط
personalDesktopAssignmentType نوع PersonalDesktopAssignment ل HostPool. "تلقائي"
"مباشر"
نوع مجموعة التطبيقات المفضلة نوع مجموعة التطبيقات المفضلة، افتراضيا لمجموعة تطبيقات سطح المكتب "سطح المكتب"
"بلا"
'RailApplications' (مطلوب)
publicNetworkAccess يسمح التمكين بالوصول إلى هذا المورد من كل من الشبكات العامة والخاصة، يسمح Disabled بالوصول إلى هذا المورد فقط عبر نقاط النهاية الخاصة "معطل"
"ممكن"
"EnabledForClientsOnly"
"EnabledForSessionHostsOnly"
PUBLICUDP الافتراضي: يتم استخدام الإعدادات على مستوى AVD لتحديد توفر الاتصال، ممكن: سيحاول UDP هذا النوع من الاتصال عند إجراء اتصالات. وهذا يعني أن هذا الاتصال ممكن، ولكنه غير مضمون، نظرا لوجود عوامل أخرى قد تمنع نوع الاتصال هذا، معطل: لن يحاول UDP هذا النوع من الاتصال عند إجراء اتصالات "افتراضي"
"معطل"
"ممكن"
معلومات التسجيل معلومات التسجيل الخاصة ب HostPool. معلومات تسجيل
relayUDP الافتراضي: يتم استخدام الإعدادات على مستوى AVD لتحديد توفر الاتصال، ممكن: سيحاول UDP هذا النوع من الاتصال عند إجراء اتصالات. وهذا يعني أن هذا الاتصال ممكن، ولكنه غير مضمون، نظرا لوجود عوامل أخرى قد تمنع نوع الاتصال هذا، معطل: لن يحاول UDP هذا النوع من الاتصال عند إجراء اتصالات "افتراضي"
"معطل"
"ممكن"
خاتم رقم حلقة HostPool. الباحث
ssoadfsAuthority عنوان URL إلى خادم ADFS للعميل لتوقيع شهادات WVD SSO. خيط
معرف ssoClientId ClientId لجهة الاعتماد المسجلة المستخدمة لإصدار شهادات WVD SSO. خيط
ssoClientSecretKeyVaultPath المسار إلى Azure KeyVault لتخزين البيانات السرية المستخدمة للاتصال ب ADFS. خيط
نوع ssoSecretType نوع تسجيل الدخول الأحادي على نوع البيانات السرية. "الشهادة"
"CertificateInKeyVault"
"مفتاح مشترك"
"SharedKeyInKeyVault"
startVMOnConnect العلامة لتشغيل/إيقاف تشغيل ميزة StartVMOnConnect. قيمة منطقية
التحقق من صحة البيئات هي بيئة التحقق من الصحة. قيمة منطقية
قالب vmTemplate قالب الجهاز الظاهري لتكوين sessionhosts داخل hostpool. خيط

صيانةWindowProperties

اسم وصف قيمة
يومالأسبوع يوم من الأسبوع. "الجمعة"
"الاثنين"
"السبت"
"الأحد"
'الخميس'
"الثلاثاء"
'الأربعاء'
ساعة ساعة بدء التحديث من اليوم. (0 - 23) الباحث

معرف الخدمة المدارة

اسم وصف قيمة
نوع نوع هوية الخدمة المدارة (حيث يسمح بكل من الأنواع SystemAssigned وUserAssigned). "بلا"
"تم تعيين النظام"
"تم تعيين النظام، UserAssigned
"UserAssigned" (مطلوب)
معرفات تعيين المستخدم مجموعة الهويات المعينة من قبل المستخدم المقترنة بالمورد. ستكون مفاتيح قاموس userAssignedIdentities معرفات موارد ARM في النموذج: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. يمكن أن تكون قيم القاموس كائنات فارغة ({}) في الطلبات. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

اسم وصف قيمة

خطة

اسم وصف قيمة
اسم اسم معرف من قبل المستخدم لأداة الطرف الثالث التي يتم شراؤها. سلسلة (مطلوب)
حاصل الضرب أداة الطرف الثالث التي يتم شراؤها. على سبيل المثال NewRelic. يتم تعيين المنتج إلى OfferID المحدد للبيانات الاصطناعية في وقت إلحاق سوق البيانات. سلسلة (مطلوب)
رمز الترقية قدم ناشر رمز الترويج كما هو متوفر في سوق البيانات للمنتج/البيانات الاصطناعية المذكورة. خيط
ناشر ناشر أداة الطرف الثالث التي يتم شراؤها. على سبيل المثال NewRelic سلسلة (مطلوب)
الإصدار إصدار المنتج/البيانات الاصطناعية المطلوبة. خيط

معلومات التسجيل

اسم وصف قيمة
وقت انتهاء الصلاحية وقت انتهاء صلاحية الرمز المميز للتسجيل. خيط
registrationTokenOperation نوع إعادة تعيين الرمز المميز. "حذف"
"بلا"
"تحديث"
رمز مميز سلسلة رمز التسجيل base64 المشفرة. خيط

سكو

اسم وصف قيمة
سعة إذا كان SKU يدعم التوسيع/التضمين، فيجب تضمين عدد صحيح للسعة. إذا لم يكن التوسيع/التوسيع ممكنا للمورد، فقد يتم حذفه. الباحث
أسرة إذا كانت الخدمة تحتوي على أجيال مختلفة من الأجهزة، لنفس SKU، فيمكن التقاط ذلك هنا. خيط
اسم اسم SKU. على سبيل المثال P3. عادة ما يكون رمز حرف+رقم سلسلة (مطلوب)
حجم حجم SKU. عندما يكون حقل الاسم هو مزيج من الطبقة وقيمة أخرى، سيكون هذا هو الرمز المستقل. خيط
المستوي هذا الحقل مطلوب ليتم تنفيذه من قبل موفر الموارد إذا كانت الخدمة تحتوي على أكثر من مستوى واحد، ولكن غير مطلوب على PUT. "أساسي"
"مجاني"
"بريميوم"
"قياسي"

تتبع المواردالعلامات

اسم وصف قيمة

معرف تعيين المستخدم

اسم وصف قيمة

أمثلة الاستخدام

الوحدات النمطية التي تم التحقق منها من Azure

يمكن استخدام الوحدات النمطية Azure Verified لنشر نوع المورد هذا.

الوحده النمطيه وصف
تجمع مضيف Azure Virtual Desktop (AVD) وحدة موارد AVM لتجمع مضيف Azure Virtual Desktop (AVD)

نماذج Azure Quickstart

تحتوي قوالب Azure Quickstart التالية على نماذج Bicep لنشر نوع المورد هذا.

ملف Bicep وصف
إنشاء AVD باستخدام Microsoft Entra ID Join يسمح لك هذا القالب بإنشاء موارد Azure Virtual Desktop مثل تجمع المضيف ومجموعة التطبيقات ومساحة العمل ومضيف جلسة اختبار وملحقاته مع انضمام معرف Microsoft Entra

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

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

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

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

تنسيق المورد

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

{
  "type": "Microsoft.DesktopVirtualization/hostPools",
  "apiVersion": "2026-01-01-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "kind": "string",
  "location": "string",
  "managedBy": "string",
  "plan": {
    "name": "string",
    "product": "string",
    "promotionCode": "string",
    "publisher": "string",
    "version": "string"
  },
  "properties": {
    "agentUpdate": {
      "maintenanceWindows": [
        {
          "dayOfWeek": "string",
          "hour": "int"
        }
      ],
      "maintenanceWindowTimeZone": "string",
      "type": "string",
      "useSessionHostLocalTime": "bool"
    },
    "allowRDPShortPathWithPrivateLink": "string",
    "customRdpProperty": "string",
    "deploymentScope": "string",
    "description": "string",
    "directUDP": "string",
    "friendlyName": "string",
    "hostPoolType": "string",
    "loadBalancerType": "string",
    "managedPrivateUDP": "string",
    "managementType": "string",
    "maxSessionLimit": "int",
    "oboTenantId": "string",
    "personalDesktopAssignmentType": "string",
    "preferredAppGroupType": "string",
    "publicNetworkAccess": "string",
    "publicUDP": "string",
    "registrationInfo": {
      "expirationTime": "string",
      "registrationTokenOperation": "string",
      "token": "string"
    },
    "relayUDP": "string",
    "ring": "int",
    "ssoadfsAuthority": "string",
    "ssoClientId": "string",
    "ssoClientSecretKeyVaultPath": "string",
    "ssoSecretType": "string",
    "startVMOnConnect": "bool",
    "validationEnvironment": "bool",
    "vmTemplate": "string"
  },
  "sku": {
    "capacity": "int",
    "family": "string",
    "name": "string",
    "size": "string",
    "tier": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

قيم الخصائص

Microsoft.DesktopVirtualization/hostPools

اسم وصف قيمة
apiVersion إصدار واجهة برمجة التطبيقات 'معاينة 2026-01-01-01'
الهوية هويات الخدمة المدارة المعينة لهذا المورد. ManagedServiceIdentity
نوع بيانات التعريف المستخدمة من قبل المدخل/الأدوات/إلخ لتقديم تجارب تجربة المستخدم المختلفة للموارد من نفس النوع؛ على سبيل المثال، ApiApps هي نوع من أنواع Microsoft.Web/sites. إذا كان مدعوما، يجب على موفر الموارد التحقق من صحة هذه القيمة واستمرارها. خيط

القيود:
النمط = ^[-\w\._,\(\)]+$
مكان الموقع الجغرافي حيث يعيش المورد سلسلة (مطلوب)
مدارة بواسطة معرف المورد المؤهل بالكامل للمورد الذي يدير هذا المورد. يشير إلى ما إذا كان هذا المورد مدارا بواسطة مورد Azure آخر. إذا كان هذا موجودا، فلن يؤدي نشر الوضع الكامل إلى حذف المورد إذا تمت إزالته من القالب نظرا لأنه تتم إدارته بواسطة مورد آخر. خيط
اسم اسم المورد خيط

القيود:
الحد الأدنى للطول = 3
الحد الأقصى للطول = 64
النمط = ^[A-Za-z0-9@.\-_ ]*$ (مطلوب)
خطة تفاصيل خطة الموارد. خطة
خصائص خصائص مفصلة ل HostPool HostPoolProperties (مطلوب)
سكو وحدة حفظ المخزون (وحدة حفظ المخزون) المعينة لهذا المورد. Sku
العلامات علامات الموارد قاموس أسماء العلامات والقيم. راجع العلامات في القوالب
نوع نوع المورد "Microsoft.DesktopVirtualization/hostPools"

خصائص تحديث العامل

اسم وصف قيمة
صيانةWindows قائمة نوافذ الصيانة. نوافذ الصيانة 2 ساعة طويلة. MaintenanceWindowProperties []
الصيانةWindowTimeZone المنطقة الزمنية للصيانة كما هو محدد في /dotnet/api/system.timezoneinfo.findsystemtimezonebyid?view=net-5.0. يجب تعيين إذا كان useLocalTime صحيحا. خيط
نوع نوع الصيانة لمكونات مضيف جلسة العمل. "افتراضي"
"مجدول"
استخدامSessionHostLocalTime ما إذا كنت تريد استخدام localTime للجهاز الظاهري. قيمة منطقية

خصائص مجمع المضيف

اسم وصف قيمة
تحديث الوكيل تكوين مضيف جلسة العمل لتحديث العامل وعامل المراقبة ومكون المكدس. خصائص تحديث العامل
allowRDPShortPathWithPrivateLink يتحكم في ما إذا كان يسمح باستخدام نقل RDPShortPath، وربما تجاوز مسارات الروابط الخاصة. "معطل"
"ممكن"
CustomRdpProperty خاصية rdp المخصصة ل HostPool. خيط
نطاق النشر نوع DeploymentScope ل HostPool. 'جغرافيائي'
"إقليمي"
وصف وصف HostPool. خيط
دايركت يو دي بي الافتراضي: يتم استخدام الإعدادات على مستوى AVD لتحديد توفر الاتصال، ممكن: سيحاول UDP هذا النوع من الاتصال عند إجراء اتصالات. وهذا يعني أن هذا الاتصال ممكن، ولكنه غير مضمون، نظرا لوجود عوامل أخرى قد تمنع نوع الاتصال هذا، معطل: لن يحاول UDP هذا النوع من الاتصال عند إجراء اتصالات "افتراضي"
"معطل"
"ممكن"
اسم مألوف اسم مألوف ل HostPool. خيط
نوعPool المضيف نوع HostPool لسطح المكتب. "BYODesktop"
"شخصي"
"مجمع" (مطلوب)
نوع موازن التحميل نوع موازن التحميل. 'أداة الاتساع'
"العمق أولا"
"متعدد الأقسام"
"مستمر" (مطلوب)
managedPrivateUDP الافتراضي: يتم استخدام الإعدادات على مستوى AVD لتحديد توفر الاتصال، ممكن: سيحاول UDP هذا النوع من الاتصال عند إجراء اتصالات. وهذا يعني أن هذا الاتصال ممكن، ولكنه غير مضمون، نظرا لوجود عوامل أخرى قد تمنع نوع الاتصال هذا، معطل: لن يحاول UDP هذا النوع من الاتصال عند إجراء اتصالات "افتراضي"
"معطل"
"ممكن"
نوع الإدارة نوع الإدارة ل hostpool أو Automated أو Standard هذا. القيمة الافتراضية هي Automated. "تلقائي"
"قياسي"
maxSessionLimit الحد الأقصى لجلسة عمل HostPool. الباحث
معرف المستأجر المستأجر الذي يطلب المورد نيابة عنه. خيط
personalDesktopAssignmentType نوع PersonalDesktopAssignment ل HostPool. "تلقائي"
"مباشر"
نوع مجموعة التطبيقات المفضلة نوع مجموعة التطبيقات المفضلة، افتراضيا لمجموعة تطبيقات سطح المكتب "سطح المكتب"
"بلا"
'RailApplications' (مطلوب)
publicNetworkAccess يسمح التمكين بالوصول إلى هذا المورد من كل من الشبكات العامة والخاصة، يسمح Disabled بالوصول إلى هذا المورد فقط عبر نقاط النهاية الخاصة "معطل"
"ممكن"
"EnabledForClientsOnly"
"EnabledForSessionHostsOnly"
PUBLICUDP الافتراضي: يتم استخدام الإعدادات على مستوى AVD لتحديد توفر الاتصال، ممكن: سيحاول UDP هذا النوع من الاتصال عند إجراء اتصالات. وهذا يعني أن هذا الاتصال ممكن، ولكنه غير مضمون، نظرا لوجود عوامل أخرى قد تمنع نوع الاتصال هذا، معطل: لن يحاول UDP هذا النوع من الاتصال عند إجراء اتصالات "افتراضي"
"معطل"
"ممكن"
معلومات التسجيل معلومات التسجيل الخاصة ب HostPool. معلومات تسجيل
relayUDP الافتراضي: يتم استخدام الإعدادات على مستوى AVD لتحديد توفر الاتصال، ممكن: سيحاول UDP هذا النوع من الاتصال عند إجراء اتصالات. وهذا يعني أن هذا الاتصال ممكن، ولكنه غير مضمون، نظرا لوجود عوامل أخرى قد تمنع نوع الاتصال هذا، معطل: لن يحاول UDP هذا النوع من الاتصال عند إجراء اتصالات "افتراضي"
"معطل"
"ممكن"
خاتم رقم حلقة HostPool. الباحث
ssoadfsAuthority عنوان URL إلى خادم ADFS للعميل لتوقيع شهادات WVD SSO. خيط
معرف ssoClientId ClientId لجهة الاعتماد المسجلة المستخدمة لإصدار شهادات WVD SSO. خيط
ssoClientSecretKeyVaultPath المسار إلى Azure KeyVault لتخزين البيانات السرية المستخدمة للاتصال ب ADFS. خيط
نوع ssoSecretType نوع تسجيل الدخول الأحادي على نوع البيانات السرية. "الشهادة"
"CertificateInKeyVault"
"مفتاح مشترك"
"SharedKeyInKeyVault"
startVMOnConnect العلامة لتشغيل/إيقاف تشغيل ميزة StartVMOnConnect. قيمة منطقية
التحقق من صحة البيئات هي بيئة التحقق من الصحة. قيمة منطقية
قالب vmTemplate قالب الجهاز الظاهري لتكوين sessionhosts داخل hostpool. خيط

صيانةWindowProperties

اسم وصف قيمة
يومالأسبوع يوم من الأسبوع. "الجمعة"
"الاثنين"
"السبت"
"الأحد"
'الخميس'
"الثلاثاء"
'الأربعاء'
ساعة ساعة بدء التحديث من اليوم. (0 - 23) الباحث

معرف الخدمة المدارة

اسم وصف قيمة
نوع نوع هوية الخدمة المدارة (حيث يسمح بكل من الأنواع SystemAssigned وUserAssigned). "بلا"
"تم تعيين النظام"
"تم تعيين النظام، UserAssigned
"UserAssigned" (مطلوب)
معرفات تعيين المستخدم مجموعة الهويات المعينة من قبل المستخدم المقترنة بالمورد. ستكون مفاتيح قاموس userAssignedIdentities معرفات موارد ARM في النموذج: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. يمكن أن تكون قيم القاموس كائنات فارغة ({}) في الطلبات. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

اسم وصف قيمة

خطة

اسم وصف قيمة
اسم اسم معرف من قبل المستخدم لأداة الطرف الثالث التي يتم شراؤها. سلسلة (مطلوب)
حاصل الضرب أداة الطرف الثالث التي يتم شراؤها. على سبيل المثال NewRelic. يتم تعيين المنتج إلى OfferID المحدد للبيانات الاصطناعية في وقت إلحاق سوق البيانات. سلسلة (مطلوب)
رمز الترقية قدم ناشر رمز الترويج كما هو متوفر في سوق البيانات للمنتج/البيانات الاصطناعية المذكورة. خيط
ناشر ناشر أداة الطرف الثالث التي يتم شراؤها. على سبيل المثال NewRelic سلسلة (مطلوب)
الإصدار إصدار المنتج/البيانات الاصطناعية المطلوبة. خيط

معلومات التسجيل

اسم وصف قيمة
وقت انتهاء الصلاحية وقت انتهاء صلاحية الرمز المميز للتسجيل. خيط
registrationTokenOperation نوع إعادة تعيين الرمز المميز. "حذف"
"بلا"
"تحديث"
رمز مميز سلسلة رمز التسجيل base64 المشفرة. خيط

سكو

اسم وصف قيمة
سعة إذا كان SKU يدعم التوسيع/التضمين، فيجب تضمين عدد صحيح للسعة. إذا لم يكن التوسيع/التوسيع ممكنا للمورد، فقد يتم حذفه. الباحث
أسرة إذا كانت الخدمة تحتوي على أجيال مختلفة من الأجهزة، لنفس SKU، فيمكن التقاط ذلك هنا. خيط
اسم اسم SKU. على سبيل المثال P3. عادة ما يكون رمز حرف+رقم سلسلة (مطلوب)
حجم حجم SKU. عندما يكون حقل الاسم هو مزيج من الطبقة وقيمة أخرى، سيكون هذا هو الرمز المستقل. خيط
المستوي هذا الحقل مطلوب ليتم تنفيذه من قبل موفر الموارد إذا كانت الخدمة تحتوي على أكثر من مستوى واحد، ولكن غير مطلوب على PUT. "أساسي"
"مجاني"
"بريميوم"
"قياسي"

تتبع المواردالعلامات

اسم وصف قيمة

معرف تعيين المستخدم

اسم وصف قيمة

أمثلة الاستخدام

قوالب Azure Quickstart

قوالب Azure Quickstart التالية توزيع نوع المورد هذا.

قالب وصف
إنشاء AVD باستخدام Microsoft Entra ID Join

نشر في Azure 		يسمح لك هذا القالب بإنشاء موارد Azure Virtual Desktop مثل تجمع المضيف ومجموعة التطبيقات ومساحة العمل ومضيف جلسة اختبار وملحقاته مع انضمام معرف Microsoft Entra

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

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

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

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

تنسيق المورد

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DesktopVirtualization/hostPools@2026-01-01-preview"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    kind = "string"
    managedBy = "string"
    plan = {
      name = "string"
      product = "string"
      promotionCode = "string"
      publisher = "string"
      version = "string"
    }
    properties = {
      agentUpdate = {
        maintenanceWindows = [
          {
            dayOfWeek = "string"
            hour = int
          }
        ]
        maintenanceWindowTimeZone = "string"
        type = "string"
        useSessionHostLocalTime = bool
      }
      allowRDPShortPathWithPrivateLink = "string"
      customRdpProperty = "string"
      deploymentScope = "string"
      description = "string"
      directUDP = "string"
      friendlyName = "string"
      hostPoolType = "string"
      loadBalancerType = "string"
      managedPrivateUDP = "string"
      managementType = "string"
      maxSessionLimit = int
      oboTenantId = "string"
      personalDesktopAssignmentType = "string"
      preferredAppGroupType = "string"
      publicNetworkAccess = "string"
      publicUDP = "string"
      registrationInfo = {
        expirationTime = "string"
        registrationTokenOperation = "string"
        token = "string"
      }
      relayUDP = "string"
      ring = int
      ssoadfsAuthority = "string"
      ssoClientId = "string"
      ssoClientSecretKeyVaultPath = "string"
      ssoSecretType = "string"
      startVMOnConnect = bool
      validationEnvironment = bool
      vmTemplate = "string"
    }
    sku = {
      capacity = int
      family = "string"
      name = "string"
      size = "string"
      tier = "string"
    }
  }
}

قيم الخصائص

Microsoft.DesktopVirtualization/hostPools

اسم وصف قيمة
الهوية هويات الخدمة المدارة المعينة لهذا المورد. ManagedServiceIdentity
نوع بيانات التعريف المستخدمة من قبل المدخل/الأدوات/إلخ لتقديم تجارب تجربة المستخدم المختلفة للموارد من نفس النوع؛ على سبيل المثال، ApiApps هي نوع من أنواع Microsoft.Web/sites. إذا كان مدعوما، يجب على موفر الموارد التحقق من صحة هذه القيمة واستمرارها. خيط

القيود:
النمط = ^[-\w\._,\(\)]+$
مكان الموقع الجغرافي حيث يعيش المورد سلسلة (مطلوب)
مدارة بواسطة معرف المورد المؤهل بالكامل للمورد الذي يدير هذا المورد. يشير إلى ما إذا كان هذا المورد مدارا بواسطة مورد Azure آخر. إذا كان هذا موجودا، فلن يؤدي نشر الوضع الكامل إلى حذف المورد إذا تمت إزالته من القالب نظرا لأنه تتم إدارته بواسطة مورد آخر. خيط
اسم اسم المورد خيط

القيود:
الحد الأدنى للطول = 3
الحد الأقصى للطول = 64
النمط = ^[A-Za-z0-9@.\-_ ]*$ (مطلوب)
خطة تفاصيل خطة الموارد. خطة
خصائص خصائص مفصلة ل HostPool HostPoolProperties (مطلوب)
سكو وحدة حفظ المخزون (وحدة حفظ المخزون) المعينة لهذا المورد. Sku
العلامات علامات الموارد قاموس أسماء العلامات والقيم.
نوع نوع المورد "Microsoft.DesktopVirtualization/hostPools@2026-01-01-preview"

خصائص تحديث العامل

اسم وصف قيمة
صيانةWindows قائمة نوافذ الصيانة. نوافذ الصيانة 2 ساعة طويلة. MaintenanceWindowProperties []
الصيانةWindowTimeZone المنطقة الزمنية للصيانة كما هو محدد في /dotnet/api/system.timezoneinfo.findsystemtimezonebyid?view=net-5.0. يجب تعيين إذا كان useLocalTime صحيحا. خيط
نوع نوع الصيانة لمكونات مضيف جلسة العمل. "افتراضي"
"مجدول"
استخدامSessionHostLocalTime ما إذا كنت تريد استخدام localTime للجهاز الظاهري. قيمة منطقية

خصائص مجمع المضيف

اسم وصف قيمة
تحديث الوكيل تكوين مضيف جلسة العمل لتحديث العامل وعامل المراقبة ومكون المكدس. خصائص تحديث العامل
allowRDPShortPathWithPrivateLink يتحكم في ما إذا كان يسمح باستخدام نقل RDPShortPath، وربما تجاوز مسارات الروابط الخاصة. "معطل"
"ممكن"
CustomRdpProperty خاصية rdp المخصصة ل HostPool. خيط
نطاق النشر نوع DeploymentScope ل HostPool. 'جغرافيائي'
"إقليمي"
وصف وصف HostPool. خيط
دايركت يو دي بي الافتراضي: يتم استخدام الإعدادات على مستوى AVD لتحديد توفر الاتصال، ممكن: سيحاول UDP هذا النوع من الاتصال عند إجراء اتصالات. وهذا يعني أن هذا الاتصال ممكن، ولكنه غير مضمون، نظرا لوجود عوامل أخرى قد تمنع نوع الاتصال هذا، معطل: لن يحاول UDP هذا النوع من الاتصال عند إجراء اتصالات "افتراضي"
"معطل"
"ممكن"
اسم مألوف اسم مألوف ل HostPool. خيط
نوعPool المضيف نوع HostPool لسطح المكتب. "BYODesktop"
"شخصي"
"مجمع" (مطلوب)
نوع موازن التحميل نوع موازن التحميل. 'أداة الاتساع'
"العمق أولا"
"متعدد الأقسام"
"مستمر" (مطلوب)
managedPrivateUDP الافتراضي: يتم استخدام الإعدادات على مستوى AVD لتحديد توفر الاتصال، ممكن: سيحاول UDP هذا النوع من الاتصال عند إجراء اتصالات. وهذا يعني أن هذا الاتصال ممكن، ولكنه غير مضمون، نظرا لوجود عوامل أخرى قد تمنع نوع الاتصال هذا، معطل: لن يحاول UDP هذا النوع من الاتصال عند إجراء اتصالات "افتراضي"
"معطل"
"ممكن"
نوع الإدارة نوع الإدارة ل hostpool أو Automated أو Standard هذا. القيمة الافتراضية هي Automated. "تلقائي"
"قياسي"
maxSessionLimit الحد الأقصى لجلسة عمل HostPool. الباحث
معرف المستأجر المستأجر الذي يطلب المورد نيابة عنه. خيط
personalDesktopAssignmentType نوع PersonalDesktopAssignment ل HostPool. "تلقائي"
"مباشر"
نوع مجموعة التطبيقات المفضلة نوع مجموعة التطبيقات المفضلة، افتراضيا لمجموعة تطبيقات سطح المكتب "سطح المكتب"
"بلا"
'RailApplications' (مطلوب)
publicNetworkAccess يسمح التمكين بالوصول إلى هذا المورد من كل من الشبكات العامة والخاصة، يسمح Disabled بالوصول إلى هذا المورد فقط عبر نقاط النهاية الخاصة "معطل"
"ممكن"
"EnabledForClientsOnly"
"EnabledForSessionHostsOnly"
PUBLICUDP الافتراضي: يتم استخدام الإعدادات على مستوى AVD لتحديد توفر الاتصال، ممكن: سيحاول UDP هذا النوع من الاتصال عند إجراء اتصالات. وهذا يعني أن هذا الاتصال ممكن، ولكنه غير مضمون، نظرا لوجود عوامل أخرى قد تمنع نوع الاتصال هذا، معطل: لن يحاول UDP هذا النوع من الاتصال عند إجراء اتصالات "افتراضي"
"معطل"
"ممكن"
معلومات التسجيل معلومات التسجيل الخاصة ب HostPool. معلومات تسجيل
relayUDP الافتراضي: يتم استخدام الإعدادات على مستوى AVD لتحديد توفر الاتصال، ممكن: سيحاول UDP هذا النوع من الاتصال عند إجراء اتصالات. وهذا يعني أن هذا الاتصال ممكن، ولكنه غير مضمون، نظرا لوجود عوامل أخرى قد تمنع نوع الاتصال هذا، معطل: لن يحاول UDP هذا النوع من الاتصال عند إجراء اتصالات "افتراضي"
"معطل"
"ممكن"
خاتم رقم حلقة HostPool. الباحث
ssoadfsAuthority عنوان URL إلى خادم ADFS للعميل لتوقيع شهادات WVD SSO. خيط
معرف ssoClientId ClientId لجهة الاعتماد المسجلة المستخدمة لإصدار شهادات WVD SSO. خيط
ssoClientSecretKeyVaultPath المسار إلى Azure KeyVault لتخزين البيانات السرية المستخدمة للاتصال ب ADFS. خيط
نوع ssoSecretType نوع تسجيل الدخول الأحادي على نوع البيانات السرية. "الشهادة"
"CertificateInKeyVault"
"مفتاح مشترك"
"SharedKeyInKeyVault"
startVMOnConnect العلامة لتشغيل/إيقاف تشغيل ميزة StartVMOnConnect. قيمة منطقية
التحقق من صحة البيئات هي بيئة التحقق من الصحة. قيمة منطقية
قالب vmTemplate قالب الجهاز الظاهري لتكوين sessionhosts داخل hostpool. خيط

صيانةWindowProperties

اسم وصف قيمة
يومالأسبوع يوم من الأسبوع. "الجمعة"
"الاثنين"
"السبت"
"الأحد"
'الخميس'
"الثلاثاء"
'الأربعاء'
ساعة ساعة بدء التحديث من اليوم. (0 - 23) الباحث

معرف الخدمة المدارة

اسم وصف قيمة
نوع نوع هوية الخدمة المدارة (حيث يسمح بكل من الأنواع SystemAssigned وUserAssigned). "بلا"
"تم تعيين النظام"
"تم تعيين النظام، UserAssigned
"UserAssigned" (مطلوب)
معرفات تعيين المستخدم مجموعة الهويات المعينة من قبل المستخدم المقترنة بالمورد. ستكون مفاتيح قاموس userAssignedIdentities معرفات موارد ARM في النموذج: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. يمكن أن تكون قيم القاموس كائنات فارغة ({}) في الطلبات. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

اسم وصف قيمة

خطة

اسم وصف قيمة
اسم اسم معرف من قبل المستخدم لأداة الطرف الثالث التي يتم شراؤها. سلسلة (مطلوب)
حاصل الضرب أداة الطرف الثالث التي يتم شراؤها. على سبيل المثال NewRelic. يتم تعيين المنتج إلى OfferID المحدد للبيانات الاصطناعية في وقت إلحاق سوق البيانات. سلسلة (مطلوب)
رمز الترقية قدم ناشر رمز الترويج كما هو متوفر في سوق البيانات للمنتج/البيانات الاصطناعية المذكورة. خيط
ناشر ناشر أداة الطرف الثالث التي يتم شراؤها. على سبيل المثال NewRelic سلسلة (مطلوب)
الإصدار إصدار المنتج/البيانات الاصطناعية المطلوبة. خيط

معلومات التسجيل

اسم وصف قيمة
وقت انتهاء الصلاحية وقت انتهاء صلاحية الرمز المميز للتسجيل. خيط
registrationTokenOperation نوع إعادة تعيين الرمز المميز. "حذف"
"بلا"
"تحديث"
رمز مميز سلسلة رمز التسجيل base64 المشفرة. خيط

سكو

اسم وصف قيمة
سعة إذا كان SKU يدعم التوسيع/التضمين، فيجب تضمين عدد صحيح للسعة. إذا لم يكن التوسيع/التوسيع ممكنا للمورد، فقد يتم حذفه. الباحث
أسرة إذا كانت الخدمة تحتوي على أجيال مختلفة من الأجهزة، لنفس SKU، فيمكن التقاط ذلك هنا. خيط
اسم اسم SKU. على سبيل المثال P3. عادة ما يكون رمز حرف+رقم سلسلة (مطلوب)
حجم حجم SKU. عندما يكون حقل الاسم هو مزيج من الطبقة وقيمة أخرى، سيكون هذا هو الرمز المستقل. خيط
المستوي هذا الحقل مطلوب ليتم تنفيذه من قبل موفر الموارد إذا كانت الخدمة تحتوي على أكثر من مستوى واحد، ولكن غير مطلوب على PUT. "أساسي"
"مجاني"
"بريميوم"
"قياسي"

تتبع المواردالعلامات

اسم وصف قيمة

معرف تعيين المستخدم

اسم وصف قيمة

أمثلة الاستخدام

الوحدات النمطية التي تم التحقق منها من Azure

يمكن استخدام الوحدات النمطية Azure Verified لنشر نوع المورد هذا.

الوحده النمطيه وصف
تجمع مضيف Azure Virtual Desktop (AVD) وحدة موارد AVM لتجمع مضيف Azure Virtual Desktop (AVD)
  • Last updated on