مهام Microsoft Power Platform Build Tools

تصف الأقسام التالية مهام الإنشاء المتوفرة. بعد ذلك، نعرض بعض الأمثلة Azure Pipelines التي تستخدم هذه المهام. للحصول على معلومات حول أدوات الإنشاء وكيفية تنزيلها، راجع Microsoft Power Platform Build Tools for Azure Pipelines.

مهمة المساعد

تصف الأقسام التالية مهام المساعد المتوفرة.

برنامج تثبيت أداة Power Platform

أضف هذه المهمة مرة واحدة قبل أي من المهام الأخرى في أدوات إنشاء Power Platform ضمن مسارات الإنشاء والإصدار. تقوم هذه المهمة بتثبيت مجموعة من الأدوات الخاصة ب Power Platform التي يطلبها العامل لتشغيل مهام الإنشاء Microsoft Power Platform. لا تتطلب هذه المهمة أي مزيد من التكوين عند إضافتها. تحتوي هذه المهمة على معلمات للإصدارات المحددة لكل من الأدوات التي تقوم بتثبيتها.

لمواكبة إصدارات الأدوات، تأكد من أن هذه المعلمات تتوافق مع إصدارات الأدوات المطلوبة لكي يعمل مسار المعالجة بشكل صحيح.

قصاصة برمجية YAML (المثبت)

# Installs default Power Platform Build Tools
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@2
  displayName: 'Power Platform Tool Installer'

# Installs default Power Platform Build Tools and adds the pac cli to the `PATH` environment variable
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@2
  displayName: 'Power Platform Tool Installer'
  inputs:
    AddToolsToPath: true

# Installs specific versions of the Power Platform Build Tools
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@2
  displayName: 'Power Platform Tool Installer'
  inputs:
    DefaultVersion: false
    XrmToolingPackageDeploymentVersion: 3.3.0.928

المعلمات (المثبت)

إعدادات	الوصف
`DefaultVersion` استخدام إصدارات الأدوات الافتراضية	قم بالتعيين إلى صواب لاستخدام الإصدار الافتراضي لجميع الأدوات، وإلا خطأ. يكون مطلوبًا (وfalse) عند تحديد أي إصدارات للأدوات.
`AddToolsToPath` إضافة أدوات إلى المسار	إضافة pac CLI إلى `PATH` متغير البيئة. يمكنك استخدام pac CLI من مهام البرنامج النصي دون الحاجة إلى إعداد المسار يدويا.
`PowerAppsAdminVersion` `XrmToolingPackageDeploymentVersion` `MicrosoftPowerAppsCheckerVersion` `CrmSdkCoreToolsVersion` إصدار الأداة	الإصدار المحدد من الأداة التي يجب استخدامها.

منصة Power: WhoAmI

تتحقق من اتصال خدمة بيئة Power Platform من خلال الاتصال وإجراء طلب WhoAmI. يمكن أن تكون هذه المهمة مفيدة لتضمينها في البنية الأساسية لبرنامج ربط العمليات التجارية مبكرًا، للتحقق من الاتصال قبل بدء المعالجة.

قصاصة برمجية YAML (WhoAmI)

# Verifies an environment service connection
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.whoami.PowerPlatformWhoAmi@2
  displayName: 'Power Platform WhoAmI'

  inputs:
#   Service Principal/client secret (supports MFA)
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'My service connection'

# Verifies an environment service connection
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.whoami.PowerPlatformWhoAmi@2
  displayName: 'Power Platform WhoAmI'

  inputs:
#   Username/password (no MFA support)
    PowerPlatformEnvironment: 'My service connection'

المعلمات (WhoAmI)

إعدادات	الوصف
`authenticationType` نوع المصادقة	(اختياري) حدد إما PowerPlatformEnvironment لاتصال اسم مستخدم/كلمة مرور أو PowerPlatformSPN لاتصال سري لمسؤول الخدمة/العميل. لمزيد من المعلومات، راجع `BuildTools.EnvironmentUrl` ضمن Power Platform Create Environment
`PowerPlatformEnvironment` عنوان URL لبيئة Power Platform	نقطة نهاية خدمة البيئة المطلوب الاتصال بها. تم تحديده ضمن اتصالات الخدمة في إعدادات المشروع. لمزيد من المعلومات، راجع `BuildTools.EnvironmentUrl` ضمن Power Platform Create Environment
`PowerPlatformSPN` مسؤول خدمة Power Platform	نقطة نهاية خدمة البيئة المطلوب الاتصال بها. تم تحديده ضمن اتصالات الخدمة في إعدادات المشروع.

فحص الجودة

في القسم التالي توجد المهام المتاحة للتحقق من جودة الحل.

مدقق Power Platform

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

قصاصة برمجية YAML (المدقق)

# Static analysis check of your solution
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.checker.PowerPlatformChecker@2
  displayName: 'Power Platform Checker '
  inputs:
    PowerPlatformSPN: 'Dataverse service connection'
    RuleSet: '0ad12346-e108-40b8-a956-9a8f95ea18c9'

# Static analysis check of your solution
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.checker.PowerPlatformChecker@2
  displayName: 'Power Platform Checker '
  inputs:
    PowerPlatformSPN: 'Dataverse service connection'
    UseDefaultPACheckerEndpoint: false
    CustomPACheckerEndpoint: 'https://japan.api.advisor.powerapps.com/'
    FileLocation: sasUriFile
    FilesToAnalyzeSasUri: 'SAS URI'
    FilesToAnalyze: '**\*.zip'
    FilesToExclude: '**\*.tzip'
    RulesToOverride: 'JSON array'
    RuleSet: '0ad12346-e108-40b8-a956-9a8f95ea18c9'

المعلمات (المدقق)

إعدادات	الوصف
`PowerPlatformSPN` اتصال الخدمة	(مطلوب) لاستخدام مدقق Power Platform، تحتاج إلى اتصال ببيئة Microsoft Power Platform مرخصة. تعريف اتصالات الخدمة في اتصالات الخدمة ضمن إعدادات Project باستخدام نوع اتصال Power Platform. لمزيد من المعلومات، راجع `BuildTools.EnvironmentUrl` ضمن Power Platform Create Environment. ملاحظة: تدعم مهمة المدقق أساليب مصادقة كيان الخدمة واسم المستخدم/كلمة المرور. لمزيد من المعلومات حول تكوين أساسيات الخدمة لهذه المهمة، راجع تكوين الاتصالات الأساسية للخدمة لبيئات Power Platform.
`UseDefaultPACheckerEndpoint` استخدام نقطة نهاية مدقق Power Platform الافتراضية	بشكل افتراضي (صواب)، يستخدم الموقع الجغرافي لخدمة المدقق المنطقة الجغرافية نفسها للبيئة التي تتصل بها.
`CustomPACheckerEndpoint` نقطة نهاية مدقق PAC مخصص	مطلوب عندما يكون `UseDefaultPACheckerEndpoint` معين إلى خطأ. حدد جغرافيا أخرى لاستخدامها، على سبيل المثال للحصول على `https://japan.api.advisor.powerapps.com.` قائمة بالجغرافيات المتوفرة، راجع استخدام واجهة برمجة تطبيقات مدقق Power Platform.
`FileLocation` موقع الملفات للتحليل	مطلوب عند الرجوع إلى ملف من عنوان URL `sasUriFile`لتوقيع الوصول المشترك (SAS). ملاحظة: الرجوع إلى ملف حل تم تصديره وليس ملفات المصدر غير المحزمة في المستودع الخاص بك. يمكنك تحليل ملفات الحل المدارة وغير المدارة.
`FilesToAnalyzeSasUri` ملفات SAS لتحليلها	مطلوب عند تعيين `FileLocation` إلى `sasUriFile`. أدخل عنوان URI لتوقيع SAS. يمكنك إضافة أكثر من URI واحد لـ SAS ضمن قائمة مفصولة بفاصلة (,) أو فاصلة منقوطة (;)
`FilesToAnalyze` ملفات محلية لتحليلها	مطلوب عندما لا يتم تحليل ملفات SAS. حدد المسار واسم الملف لملفات zip التي سيتم تحليلها. يمكنك استخدام أحرف البدل. على سبيل المثال، يمكنك إدخال *\.لجميع ملفات zip في جميع المجلدات الفرعية.
`FilesToExclude` ملفات محلية لاستبعادها	حدد أسماء الملفات التي سيتم استبعادها من التحليل. إذا قمت بتحديد أكثر من ملف واحد، فاستخدم فاصلة (،) أو فاصلة منقوطة (;) قائمة مفصولة. يمكن أن تتضمن هذه القائمة اسم ملف كامل أو اسما بأحرف بدل بادئة أو لاحقة، مثل *jquery أو form.js.
`RulesToOverride` قواعد التجاوز	تحتوي مصفوفة JSON على قواعد التجاوز ومستوياته. القيم المقبولة ل `OverrideLevel` هي: حرجة، عالية، متوسطة، منخفضة، إعلامية. مثال: `[{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}]`
`RuleSet` مجموعة القواعد	(مطلوب) حدد مجموعة القواعد التي سيتم تطبيقها. تتوفر مجموعتا القواعد التاليتان: مدقق الحل: مجموعة القواعد هذه هي نفسها التي يتم تشغيلها من مدخل Power Apps maker. Marketplace: مجموعة القواعد الموسعة المستخدمة لتصديق تطبيق قبل أن يمكن نشره في Marketplace.
`ErrorLevel` مستوى الخطأ	جنبا إلى جنب مع معلمة حد الخطأ، تحدد هذه القيمة خطورة الأخطاء والتحذيرات المسموح بها. قيم الحد المدعومة هي <level>IssueCount حيث المستوى= هامة وشديدة الأهمية ومتوسطة الأهمية منخفضة ومعلوماتية.
`ErrorThreshold` حد الخطأ	تحدد عدد الأخطاء (>=0) لمستوى محدد يسمح للمدقق بتمرير الحلول التي يتم التحقق منها.
`FailOnPowerAppsCheckerAnalysisError` فشل في الخطأ	عندما تكون القيمة true، تفشل العملية إذا كانت نتيجة تحليل مدقق Power Apps هي Failed أو FinishedWithErrors.
`ArtifactDestinationName` اسم البيانات المصطنعة DevOps	حدد اسم البيانات الاصطناعية من Azure لملف المدقق .sarif.

مهام الحل

تعمل هذه المجموعة من المهام على أتمتة إجراءات الحل. تقوم مهام البيئة الموضحة لاحقًا في هذا القسم والتي تقوم بإنشاء بيئة أو نسخها أو استعادتها بالكتابة فوق اتصالات الخدمة مع البيئات التي تم إنشاؤها حديثًا. باستخدام هذه المهام، يمكنك تنفيذ مهام الحل مقابل البيئات التي تقوم بإنشائها عند الطلب.

استيراد حل في Power Platform

استيراد حل إلى بيئة هدف.

قصاصة برمجية YAML (استيراد)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.import-solution.PowerPlatformImportSolution@2
  displayName: 'Power Platform Import Solution '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    SolutionInputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
    HoldingSolution: true
    OverwriteUnmanagedCustomizations: true
    SkipProductUpdateDependencies: true

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.import-solution.PowerPlatformImportSolution@2
  displayName: 'Power Platform Import Solution '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    SolutionInputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
    AsyncOperation: true
    MaxAsyncWaitTime: 60
    PublishWorkflows: false

المعلمات (استيراد)

إعدادات	الوصف
`authenticationType` نوع المصادقة	(مطلوب لـ SPN) حدد إما PowerPlatformEnvironment لاتصال اسم مستخدم/كلمة مرور أو PowerPlatformSPN لاتصال سري لمسؤول الخدمة/العميل.
`PowerPlatformEnvironment` عنوان URL لبيئة Power Platform	نقطة نهاية الخدمة التي تريد استيراد الحل إليها (على سبيل المثال، `https://powerappsbuildtools.crm.dynamics.com`). حدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. لمزيد من المعلومات، راجع `BuildTools.EnvironmentUrl` ضمن بيئة إنشاء Power Platform
`PowerPlatformSPN` مسؤول خدمة Power Platform	نقطة نهاية الخدمة التي تريد استيراد الحل إليها (على سبيل المثال، `https://powerappsbuildtools.crm.dynamics.com`). حدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. لمزيد من المعلومات، راجع `BuildTools.EnvironmentUrl` ضمن بيئة إنشاء Power Platform
`SolutionInputFile` ملف إدخال الحل	(مطلوب) المسار واسم ملف solution.zip لاستيراده إلى البيئة الهدف (على سبيل المثال، $(Build.ArtifactStagingDirectory)$(SolutionName).zip). ملاحظة: تمنحك المتغيرات طريقة ملائمة لإدخال عناصر بيانات رئيسية في أجزاء مختلفة من مسارك. راجع استخدام متغيرات معرّفة مسبقًا للحصول على قائمة شاملة.
`HoldingSolution` استيراد كحل انتظار	معلمة متقدمة (صواب\|خطأ) تُستخدم عند الحاجة إلى ترقية أحد الحلول. وتستضيف هذه المعلمة الحل في Dataverse ولكنها لا تقوم بترقية الحل حتى يتم تشغيل مهمة "تطبيق ترقية الحل".
`OverwriteUnmanagedCustomizations` الكتابة فوق التخصيصات غير المُدارة	حدد ما إذا كنت تريد الكتابة فوق التخصيصات غير المدارة (صواب\|خطأ).
`SkipProductUpdateDependencies` تخطي تبعيات تحديث المنتج	حدد ما إذا كان يجب تخطي فرض التبعيات المرتبطة بتحديثات المنتجات (صواب\|خطأ).
`ConvertToManaged` تحويل إلى مُدار	قديم. سيقوم النظام بتحويل مكونات الحل غير المدارة إلى مدارة عند استيراد حل مدار.
`AsyncOperation` استيراد غير متزامن	إذا تم تحديد (صواب)، فإنه سيتم تنفيذ عملية الاستيراد بشكل غير متزامن. ينصح بهذا الخيار للحلول الكبيرة الحجم لأن مهلة هذه المهمة ستنقضي بشكل تلقائي بعد 4 دقائق. سيعمل تحديد عملية غير متزامنة على القيام بالاستطلاع والانتظار حتى يتم الوصول إلى MaxAsyncWaitTime (صواب\|خطأ).
`MaxAsyncWaitTime` الحد الأقصى لوقت الانتظار	الحد الأقصى لوقت الانتظار بالدقائق للعملية غير المتزامنة؛ الافتراضي هو 60 دقيقة (ساعة واحدة)، وهو نفس Azure DevOps الافتراضي للمهام.
`PublishWorkflows` تنشيط العمليات بعد الاستيراد	حدد ما إذا كان يجب تنشيط أية عمليات (مهام سير عمل) في الحل بعد الاستيراد (صواب\|خطأ).
`UseDeploymentSettingsFile` استخدام ملف إعدادات التوزيع	يمكن تعيين مراجع الاتصال وقيم متغيرات البيئة باستخدام ملف إعدادات النشر (صواب\|خطأ).
`DeploymentSettingsFile` ملف إعدادات النشر	(مطلوب عندما يكون `UseDeploymentSettingsFile`=صواب) المسار واسم الملف الخاص بملف إعدادات التوزيع.

إضافة مكون الحل في Power Platform

إضافة مكون حل إلى حل غير مُدار.

جزء تعليمة برمجية متكررة YAML (إضافة)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.add-solution-component.PowerPlatformAddSolutionComponent@2
  displayName: 'Power Platform Add Solution Component '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    SolutionName: 'SampleSolution '
    Component: contact
    ComponentType: 1
    AddRequiredComponents: false

معلمات (إضافة)

إعدادات	الوصف
`ComponentId` معرف مكون الحل	اسم المخطط أو معرف المكون لإضافته إلى الحل الهدف.
`ComponentType` عنوان URL لبيئة Power Platform	القيمة التي تمثل مكون الحل الذي تعمل على إضافته. راجع استخدام أنواع مكونات محددة معرفة مسبقًا للحصول على قائمة شاملة بقيم المكونات.
`SolutionUniqueName` اسم الحل	الاسم الفريد للحل.
`AddRequiredComponents` تعتمد أية مكونات مطلوبة من حل آخر على مكون الحل	(اختياري) الإشارة إلى ما إذا كان يجب أن تُضاف أيضًا مكونات الحل الأخرى المطلوبة من قِبل مكون الحل الذي تعمل على إضافته إلى الحل غير المُدار.
`Environment` معرف أو عنوان URL خاص بالبيئة	(اختياري) عنوان URL للبيئة أو معرف البيئة الهدف.

تطبيق ترقية الحل لـ Power Platform

يقوم بترقية حل تم استيراده كحل انتظار.

قصاصة برمجية YAML (ترقية)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.apply-solution-upgrade.PowerPlatformApplySolutionUpgrade@2
  displayName: 'Power Platform Apply Solution Upgrade '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    SolutionName: 'Contoso_sample'
    AsyncOperation: false

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.apply-solution-upgrade.PowerPlatformApplySolutionUpgrade@2
  displayName: 'Power Platform Apply Solution Upgrade '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    SolutionName: 'Contoso_sample'
    MaxAsyncWaitTime: 45

المعلمات (ترقية)

إعدادات	الوصف
`authenticationType` نوع المصادقة	(مطلوب لـ SPN) حدد إما PowerPlatformEnvironment لاتصال اسم مستخدم/كلمة مرور أو PowerPlatformSPN لاتصال سري لمسؤول الخدمة/العميل.
`PowerPlatformEnvironment` عنوان URL لبيئة Power Platform	نقطة نهاية الخدمة التي تريد ترقية الحل فيها (على سبيل المثال، `https://powerappsbuildtools.crm.dynamics.com`). حدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. لمزيد من المعلومات، راجع `BuildTools.EnvironmentUrl` ضمن بيئة إنشاء Power Platform
`PowerPlatformSPN` مسؤول خدمة Power Platform	نقطة نهاية الخدمة التي تريد ترقية الحل فيها (على سبيل المثال، `https://powerappsbuildtools.crm.dynamics.com`). حدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. لمزيد من المعلومات، راجع `BuildTools.EnvironmentUrl` ضمن بيئة إنشاء Power Platform
`SolutionName` اسم الحل	(مطلوب) اسم الحل لتطبيق الترقية. استخدم دائمًا اسم الحل، وليس اسمه المعروض.
`AsyncOperation` ترقية غير متزامنة	إذا تم تحديد (صواب)، فإنه سيتم تنفيذ عملية الترقية كمهمة دفعة غير متزامنة. سيعمل تحديد عملية غير متزامنة على القيام بالاستطلاع والانتظار حتى يتم الوصول إلى MaxAsyncWaitTime.
`MaxAsyncWaitTime` الحد الأقصى لوقت الانتظار	الحد الأقصى لوقت الانتظار بالدقائق للعملية غير المتزامنة؛ الافتراضي هو 60 دقيقة (ساعة واحدة)، وهو نفس Azure DevOps الافتراضي للمهام.

ملحوظة

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

مزيد من المعلومات: ملء مراجع الاتصال ومتغيرات البيئة مسبقًا لعمليات النشر التي يتم تنفيذها تلقائيًا

تصدير حل في Power Platform

تصدير حل من البيئة المصدر.

قصاصة برمجية YAML (تصدير)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.export-solution.PowerPlatformExportSolution@2
  displayName: 'Power Platform Export Solution '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    SolutionName: 'Contoso_sample'
    SolutionOutputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
    Managed: true
    MaxAsyncWaitTime: 120

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.export-solution.PowerPlatformExportSolution@2
  displayName: 'Power Platform Export Solution '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    SolutionName: 'Contoso_sample'
    SolutionOutputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
    Managed: true
    MaxAsyncWaitTime: 120
    ExportAutoNumberingSettings: true
    ExportCalendarSettings: true
    ExportCustomizationSettings: true
    ExportEmailTrackingSettings: true
    ExportGeneralSettings: true
    ExportIsvConfig: true
    ExportMarketingSettings: true
    ExportOutlookSynchronizationSettings: true
    ExportRelationshipRoles: true
    ExportSales: true

المعلمات (تصدير)

إعدادات	الوصف
`authenticationType` نوع المصادقة	(مطلوب لـ SPN) حدد إما PowerPlatformEnvironment لاتصال اسم مستخدم/كلمة مرور أو PowerPlatformSPN لاتصال سري لمسؤول الخدمة/العميل.
`PowerPlatformEnvironment` عنوان URL لبيئة Power Platform	نقطة نهاية الخدمة التي تريد ترقية الحل فيها (على سبيل المثال، `https://powerappsbuildtools.crm.dynamics.com`). حدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. لمزيد من المعلومات، راجع `BuildTools.EnvironmentUrl` ضمن بيئة إنشاء Power Platform
`PowerPlatformSPN` مسؤول خدمة Power Platform	نقطة نهاية الخدمة التي تريد ترقية الحل فيها (على سبيل المثال، `https://powerappsbuildtools.crm.dynamics.com`). حدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. لمزيد من المعلومات، راجع `BuildTools.EnvironmentUrl` ضمن بيئة إنشاء Power Platform
`SolutionName` اسم الحل	(مطلوب) اسم الحل الذي سيتم تصديره. استخدم دائمًا اسم الحل، وليس اسمه المعروض.
`SolutionOutputFile` ملف إخراج الحل	(مطلوب) المسار واسم ملف solution.zip لتصدير البيئة المصدر إليه (على سبيل المثال، $(Build.ArtifactStagingDirectory)$(SolutionName).zip ). ملاحظة: تمنحك المتغيرات طريقة ملائمة لإدخال عناصر بيانات رئيسية في أجزاء مختلفة من مسارك. راجع استخدام متغيرات معرّفة مسبقًا للحصول على قائمة شاملة.
`AsyncOperation` تصدير غير متزامن	إذا تم تحديد (صواب)، فإنه سيتم تنفيذ عملية التصدير كمهمة دفعة غير متزامنة. سيعمل تحديد عملية غير متزامنة على القيام بالاستطلاع والانتظار حتى يتم الوصول إلى MaxAsyncWaitTime.
`MaxAsyncWaitTime` الحد الأقصى لوقت الانتظار	الحد الأقصى لوقت الانتظار بالدقائق للعملية غير المتزامنة؛ الافتراضي هو 60 دقيقة (ساعة واحدة)، وهو نفس Azure DevOps الافتراضي للمهام.
`Managed` تصدير كمُدار	إذا تم تحديد (صواب)، قم بتصدير الحل كحل مُدار؛ وإلا قم فإنك ستقوم بتصديره كحل غير مُدار.
`ExportAutoNumberingSettings` تصدير إعدادات الترقيم التلقائي	قم بتصدير إعدادات الترقيم التلقائي (صواب\|خطأ).
`ExportCalendarSettings` تصدير إعدادات التقويم	قم بتصدير إعدادات التقويم (صواب\|خطأ).
`ExportCustomizationSettings` تصدير إعدادات التخصيص	قم بتصدير إعدادات التخصيص (صواب\|خطأ).
`ExportEmailTrackingSettings` تصدير إعدادات تعقب البريد الإلكتروني	قم بتصدير إعدادات تعقب البريد الإلكتروني (صواب\|خطأ).
`ExportGeneralSettings` تصدير الإعدادات العامة	قم تصدير الإعدادات العامة (صواب\|خطأ).
`ExportIsvConfig` تصدير تكوين ISV	قم بتصدير تكوين ISV (صواب\|خطأ).
`ExportMarketingSettings` تصدير إعدادات التسويق	قم بتصدير إعدادات التسويق (صواب\|خطأ).
`ExportOutlookSynchronizationSettings` تصدير إعدادات المزامنة Outlook	تصدير إعدادات المزامنة Outlook (true\|false).
`ExportRelationshipRoles` تصدير تفاصيل العلاقات	قم بتصدير تفاصيل العلاقات (صواب\|خطأ).
`ExportSales` مبيعات التصديرات	القيام بمبيعات التصديرات (صواب\|خطأ).

فك حزمة حل في Power Platform

تأخذ مهمة فك حزمة الحل ملفًا مضغوطًا وتفككه إلى ملفات XML متعددة وملفات أخرى بحيث تصبح قراءة هذه الملفات وإدارتها أكثر سهوله بواسطة نظام التحكم في المصدر.

قصاصة برمجية YAML (فك الحزمة)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.unpack-solution.PowerPlatformUnpackSolution@2
  displayName: 'Power Platform Unpack Solution '
  inputs:
    SolutionInputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
    SolutionTargetFolder: 'C:\Public'
    SolutionType: Both

المعلمات (فك الحزمة)

إعدادات	الوصف
`SolutionInputFile` ملف إدخال الحل	(مطلوب) المسار واسم الملف لملف solution.zip الذي سيتم فك حزمته.
`SolutionTargetFolder` المجلد الهدف لفك حزمة الحل	(مطلوب) المسار والمجلد الهدف الذي تريد فك حزمة الحل فيه.
`SolutionType` نوع الحل	(مطلوب) ‬‏‫نوع الحل الذي تريد فك حزمته. تتضمن الخيارات: غير مُدار (مستحسن)، ومُدار وكلاهما.

حزم حل في Power Platform

تقوم هذه المهمة بحزم حل ممثل في التحكم في المصدر في ملف solution.zip يمكن استيراده إلى بيئة أخرى.

قصاصة برمجية YAML (الحزمة)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.pack-solution.PowerPlatformPackSolution@2
  displayName: 'Power Platform Pack Solution '
  inputs:
    SolutionSourceFolder: 'C:\Public'
    SolutionOutputFile: 'Contoso_sample_1_0_0_1_managed.zip'
    SolutionType: Managed

المعلمات (الحزمة)

إعدادات	الوصف
`SolutionOutputFile` ملف إخراج الحل	(مطلوب) المسار واسم ملف solution.zip لحزم الحل فيه.
`SolutionSourceFolder` المجلد المصدر للحل الذي سيتم حزمه	(مطلوب) المسار والمجلد المصدر للحل الذي سيتم حزمه.
`SolutionType` نوع الحل	(مطلوب) ‬‏‫نوع الحل الذي تريد حزمه. تتضمن الخيارات: مُدار (موصى به)، وغير مُدار، وكلاهما.

حف حل في Power Platform

يؤدي إلى حذف الحل في بيئة الهدف.

قصاصة برمجية YAML (حذف)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.delete-solution.PowerPlatformDeleteSolution@2
  displayName: 'Power Platform Delete Solution '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    SolutionName: 'Contoso_sample'

المعلمات (حذف)

إعدادات	الوصف
`authenticationType` نوع المصادقة	(مطلوب لـ SPN) حدد إما PowerPlatformEnvironment لاتصال اسم مستخدم/كلمة مرور أو PowerPlatformSPN لاتصال سري لمسؤول الخدمة/العميل.
`PowerPlatformEnvironment` عنوان URL لبيئة Power Platform	نقطة نهاية الخدمة التي تريد حذف الحل فيها (على سبيل المثال، `https://powerappsbuildtools.crm.dynamics.com`). حدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. لمزيد من المعلومات، راجع `BuildTools.EnvironmentUrl` ضمن بيئة إنشاء Power Platform
`PowerPlatformSPN` مسؤول خدمة Power Platform	نقطة نهاية الخدمة التي تريد حذف الحل فيها (على سبيل المثال، `https://powerappsbuildtools.crm.dynamics.com`). حدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. لمزيد من المعلومات، راجع `BuildTools.EnvironmentUrl` ضمن بيئة إنشاء Power Platform
`SolutionName` اسم الحل	(مطلوب) اسم الحل المراد حذفه. استخدم دائمًا اسم الحل، وليس اسمه المعروض.

نشر تخصيصات في Power Platform

نشر كافة التخصيصات في بيئة.

قصاصة برمجية YAML (توزيع)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.publish-customizations.PowerPlatformPublishCustomizations@2
  displayName: 'Power Platform Publish Customizations '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '

المعلمات (نشر)

إعدادات	الوصف
`authenticationType` نوع المصادقة	(مطلوب لـ SPN) حدد إما PowerPlatformEnvironment لاتصال اسم مستخدم/كلمة مرور أو PowerPlatformSPN لاتصال سري لمسؤول الخدمة/العميل.
`PowerPlatformEnvironment` عنوان URL لبيئة Power Platform	نقطة نهاية الخدمة التي تريد نشر التخصيصات فيها (على سبيل المثال، `https://powerappsbuildtools.crm.dynamics.com`). حدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. لمزيد من المعلومات، راجع `BuildTools.EnvironmentUrl` ضمن بيئة إنشاء Power Platform
`PowerPlatformSPN` مسؤول خدمة Power Platform	نقطة نهاية الخدمة التي تريد نشر التخصيصات فيها (على سبيل المثال، `https://powerappsbuildtools.crm.dynamics.com`). حدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. لمزيد من المعلومات، راجع `BuildTools.EnvironmentUrl` ضمن بيئة إنشاء Power Platform

تعيين إصدار حل في Power Platform

تحديث إصدار الحل.

قصاصة برمجية YAML (الإصدار)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.set-solution-version.PowerPlatformSetSolutionVersion@2
  displayName: 'Power Platform Set Solution Version '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    SolutionName: 'Contoso_sample'
    SolutionVersionNumber: 1.0.0.0

المعلمات (الإصدار)

إعدادات	الوصف
`authenticationType` نوع المصادقة	(مطلوب لـ SPN) حدد إما PowerPlatformEnvironment لاتصال اسم مستخدم/كلمة مرور أو PowerPlatformSPN لاتصال سري لمسؤول الخدمة/العميل.
`PowerPlatformEnvironment` عنوان URL لبيئة Power Platform	نقطة نهاية الخدمة التي تريد تعيين إصدار الحل فيها (على سبيل المثال، `https://powerappsbuildtools.crm.dynamics.com`). حدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. لمزيد من المعلومات، راجع `BuildTools.EnvironmentUrl` ضمن بيئة إنشاء Power Platform
`PowerPlatformSPN` مسؤول خدمة Power Platform	نقطة نهاية الخدمة التي تريد تعيين إصدار الحل فيها (على سبيل المثال، `https://powerappsbuildtools.crm.dynamics.com`). حدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. لمزيد من المعلومات، راجع `BuildTools.EnvironmentUrl` ضمن بيئة إنشاء Power Platform
`SolutionName` اسم الحل	(مطلوب) اسم الحل لتعيين الإصدار له. استخدم دائمًا اسم الحل، وليس اسمه المعروض.
`SolutionVersionNumber` رقم إصدار الحل	(مطلوب) رقم الإصدار الذي تريد تعيينه.

بينما يمكن ترميز رقم الإصدار في المسار، يوصى باستخدام متغير مسار Azure DevOps مثل BuildId. يوفر هذا الخيار خيارات لتحديد الشكل الصحيح لعدد الإصدارات ضمن علامة التبويب "خيارات"، على سبيل المثال: $(Year:yyyy)-$(Month:MM)-$(Day:dd)-$(rev:rr)-3

يمكن استخدام هذا التعريف بعد ذلك في مهمة تعيين إصدار الحل عن طريق تعيين خاصية رقم الإصدار بواسطة: $(Build.BuildId) بدلًا من التعليمات البرمجية المضمنة 20200824.0.0.2.

أو بدلًا من ذلك، قم بتعيين إخراج البرنامج النصي لمهمة مضمنة في powershell$(Get-Date -Format yyyy.MM.dd.HHmm) إلى متغير فارغ باسم SolutionVersion كـ Write-Host ("##vso[task.setvariable variable=SolutionVersion;]$version")، قم بتعيين الإصدار كـ $(SolutionVersion).

تعيين متغيرات الاتصال في Power Platform

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

يتم تعيين المتغيرات التالية:

PowerPlatformSetConnectionVariables.BuildTools.TenantId
PowerPlatformSetConnectionVariables.BuildTools.ApplicationId
PowerPlatformSetConnectionVariables.BuildTools.ClientSecret
PowerPlatformSetConnectionVariables.BuildTools.DataverseConnectionString

جزء تعليمة YAML البرمجية المتكررة (SetConnectionVariables)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.set-connection-variables.PowerPlatformSetConnectionVariables@2
  displayName: 'Power Platform Set Connection Variables '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
  timeoutInMinutes: 2
  retryCountOnTaskFailure: 5

المعلمات (SetConnectionVariables)

إعدادات	الوصف
`authenticationType` نوع المصادقة	(مطلوب لـ SPN) حدد إما PowerPlatformEnvironment لاتصال اسم مستخدم/كلمة مرور أو PowerPlatformSPN لاتصال سري لمسؤول الخدمة/العميل.
`PowerPlatformSPN` مسؤول خدمة Power Platform	نقطة نهاية الخدمة التي تريد تعيين متغيرات الاتصال لها. حدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. لمزيد من المعلومات، راجع `BuildTools.EnvironmentUrl` ضمن بيئة إنشاء Power Platform
`timeoutInMinutes` المهلة	تحديد الحد الأقصى للوقت، بالدقائق، الذي يُسمح للمهمة بتنفيذه قبل أن يتم إلغاؤه بواسطة الخادم. تشير القيمة صفر إلى مهلة لا نهائية.
`retryCountOnTaskFailure` عدد مرات إعادة المحاولة في حالة فشل المهمة	تحديد عدد مرات إعادة المحاولة لهذه المهمة التي ستحدث في حالة فشل المهمة. غير مدعوم للمهام الأقل مندوبين.
`ApplicationId` معرف التطبيق لتسجيل الدخول	(مطلوب لاسم المستخدم/كلمة المرور) معرف التطبيق المراد استخدامه لتسجيل الدخول (انظر الملاحظة الإضافية أدناه).
`RedirectUri` عنوان URI لإعادة التوجيه للتطبيق المحدد	(مطلوب لاسم المستخدم/كلمة المرور) عنوان URI لإعادة التوجيه للتطبيق المحدد. مطلوب عند تحديد معرف التطبيق. (انظر الملاحظة الإضافية أدناه).

ملحوظة

عند استخدام نوع مصادقة اسم المستخدم/كلمة المرور، سيكون معرف التطبيق وUri لإعادة التوجيه مطلوبًا. يحتوي مستند مصادقة oauth هذا على شرح لسبب حاجتك إلى إنشاء تسجيل تطبيق للمصادقة باستخدام Dataverse. عند الاتصال باستخدام مصادقة اسم المستخدم/كلمة المرور، يتصرف الاتصال كتطبيق يتصل بالنيابة عن المستخدم بخدمة Dataverse.

نشر حزمة في Power Platform

نشر حزمة في بيئة. تمنحك عملية نشر الحزمة في مقابل ملف حل فردي خيار نشر حلول متعددة وبيانات وتعليمات برمجية في بيئة.

قصاصة برمجية YAML (توزيع)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.deploy-package.PowerPlatformDeployPackage@2
  displayName: 'Power Platform Deploy Package '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    PackageFile: 'C:\Users\Public\package.dll'
    MaxAsyncWaitTime: 120

المعلمات (توزيع)

إعدادات	الوصف
`authenticationType` نوع المصادقة	(مطلوب لـ SPN) حدد إما PowerPlatformEnvironment لاتصال اسم مستخدم/كلمة مرور أو PowerPlatformSPN لاتصال سري لمسؤول الخدمة/العميل.
`PowerPlatformEnvironment` عنوان URL لبيئة Power Platform	نقطة نهاية الخدمة التي تريد توزيع الحزمة فيها (على سبيل المثال، `https://powerappsbuildtools.crm.dynamics.com`). حدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. لمزيد من المعلومات، راجع `BuildTools.EnvironmentUrl` ضمن بيئة إنشاء Power Platform
`PowerPlatformSPN` مسؤول خدمة Power Platform	نقطة نهاية الخدمة التي تريد توزيع الحزمة فيها (على سبيل المثال، `https://powerappsbuildtools.crm.dynamics.com`). حدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. لمزيد من المعلومات، راجع `BuildTools.EnvironmentUrl` ضمن بيئة إنشاء Power Platform
`PackageFile` ملف الحزمة	(مطلوب) المسار واسم الملف الخاصين بمجموعة ملف الحزمة (.dll).
`MaxAsyncWaitTime` الحد الأقصى لوقت الانتظار	الحد الأقصى لوقت الانتظار بالدقائق للعملية غير المتزامنة؛ الافتراضي هو 60 دقيقة (ساعة واحدة)، وهو نفس Azure DevOps الافتراضي للمهام.

مهام إدارة البيئة

أتمتة مهام إدارة دورة حياة البيئة (ELM) الشائعة.

إنشاء بيئة في Power Platform

إنشاء بيئة جديدة. إنشاء بيئة جديدة أيضًا تقوم بإنشاء BuildTools.EnvironmentUrl تلقائيًا.

مهم

عند التعيين، سيتم استخدام BuildTools.EnvironmentUrl كـ اتصال خدمة افتراضي للمهام اللاحقة في البنية الأساسية لبرنامج ربط العمليات التجارية. تستخدم كل مهمة موضحة في هذا المقال نقطة النهاية من اتصال الخدمة فقط عندما لا يتم تعيين BuildTools.EnvironmentUrl.

يمكن تزويد بيئة جديده فقط إذا كانت سعة الترخيص تسمح بإنشاء بيئات إضافية. لمزيد من المعلومات حول كيفية عرض السعة، راجع تفاصيل صفحة السعة.

قصاصة برمجية YAML (إنشاء بيئة)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.create-environment.PowerPlatformCreateEnvironment@2
  displayName: 'Power Platform Create Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    DisplayName: 'First Coffee test'
    DomainName: firstcoffee

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.create-environment.PowerPlatformCreateEnvironment@2
  displayName: 'Power Platform Create Environment '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    DisplayName: 'First Coffee prod'
    EnvironmentSku: Production
    AppsTemplate: 'D365_CustomerService,D365_FieldService'
    LocationName: canada
    LanguageName: 1036
    CurrencyName: ALL
    DomainName: firstcoffee

المعلمات (إنشاء بيئة)

إعدادات	الوصف
`authenticationType` نوع المصادقة	(مطلوب لـ SPN) حدد إما PowerPlatformEnvironment لاتصال اسم مستخدم/كلمة مرور أو PowerPlatformSPN لاتصال سري لمسؤول الخدمة/العميل.
`PowerPlatformEnvironment` عنوان URL لبيئة Power Platform	نقطة نهاية الخدمة التي تريد إنشاء البيئة فيها (على سبيل المثال، `https://powerappsbuildtools.crm.dynamics.com`). حدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform.
`PowerPlatformSPN` مسؤول خدمة Power Platform	نقطة نهاية الخدمة التي تريد إنشاء البيئة فيها (على سبيل المثال، `https://powerappsbuildtools.crm.dynamics.com`). حدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform.
`DisplayName` ‏‫اسم العرض‬	(مطلوب) الاسم المعروض للبيئة التي تم إنشاؤها.
`LocationName` منطقة التوزيع	(مطلوب) المنطقة التي يجب أن يتم إنشاء البيئة فيها.
`EnvironmentSku` نوع البيئة	(مطلوب) نوع المثيل المراد نشره. الخيارات هي ‏‫وضع الحماية‬ و الإنتاج و الإصدار التجريبي و SubscriptionBasedTrial.
`AppsTemplate` التطبيقات	بالنسبة لنوع البيئة غير التجريبية، التطبيقات المدعومة هي D365_CustomerService وD365_FieldService وD365_ProjectServiceAutomation وD365_Sales.
`CurrencyName` ‏‏العملة	(مطلوب) العملة الأساسية للبيئة التي تم إنشاؤها. لا يمكن تحديث العملة بعد إنشاء البيئة.
`LanguageName` اللغة	(مطلوب) اللغة الأساسية في البيئة.
`DomainName` اسم المجال	(مطلوب) هذه هي السلسلة الخاصة بالبيئة التي تشكل جزءًا من عنوان URL. على سبيل المثال، بالنسبة إلى بيئة تتضمن عنوان URL التالي: `https://powerappsbuildtasks.crm.dynamics.com/`، قد يكون اسم المجال "powerappsbuildtasks". ملاحظة: إذا قمت بإدخال اسم مجال قيد الاستخدام، ستقوم المهمة بإلحاق قيمة رقمية باسم المجال، بدءًا من 0. بالنسبة إلى المثال أعلاه، قد يصبح URL `https://powerappsbuildtasks0.crm.dynamics.com/`.

حذف بيئة في Power Platform

حذف بيئة.

قصاصة برمجية YAML (حذف بيئة)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.delete-environment.PowerPlatformDeleteEnvironment@2
  displayName: 'Power Platform Delete Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'

المعلمات (حذف بيئة)

إعدادات	الوصف
`authenticationType` نوع المصادقة	(مطلوب لـ SPN) حدد إما PowerPlatformEnvironment لاتصال اسم مستخدم/كلمة مرور أو PowerPlatformSPN لاتصال سري لمسؤول الخدمة/العميل.
`PowerPlatformEnvironment` عنوان URL لبيئة Power Platform	نقطة نهاية الخدمة التي تريد حذف البيئة فيها (على سبيل المثال، `https://powerappsbuildtools.crm.dynamics.com`). حدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform.
`PowerPlatformSPN` مسؤول خدمة Power Platform	نقطة نهاية الخدمة التي تريد حذف البيئة فيها (على سبيل المثال، `https://powerappsbuildtools.crm.dynamics.com`). حدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform.

تعيين مستخدم في Power Platform

قم بتعيين مستخدم إلى بيئة هدف مع دور أمان محدد.

قصاصة برمجية YAML (AssignUser-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.assign-user.PowerPlatformAssignUser@2
  displayName: 'Power Platform Assign User '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    User: EnvironmentUsername
    Role: 'Environment Maker'
    ApplicationUser: true

المعلمات (AssignUser-env)

إعدادات	الوصف
`authenticationType` نوع المصادقة	(مطلوب لـ SPN) حدد إما PowerPlatformEnvironment لاتصال اسم مستخدم/كلمة مرور أو PowerPlatformSPN لاتصال سري لمسؤول الخدمة/العميل.
`PowerPlatformSPN` مسؤول خدمة Power Platform	نقطة نهاية الخدمة للبيئة التي تريد تعيين المستخدم لها (على سبيل المثال، `https://powerappsbuildtools.crm.dynamics.com`). حدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform.
`User` اسم مستخدم في Power Platform	معرف الكائن في Microsoft Entra أو الاسم الرئيسي للمستخدم لتعيينه في البيئة المستهدفة.
`Role` اسم أو معرف دور الأمان	اسم أو معرف دور الأمان لتعيينه إلى المستخدم.
`ApplicationUser` اسم مستخدم تطبيق في Power Platform	تحديد ما إذا كان مستخدم الإدخال مستخدم تطبيق (صواب\|خطأ).

إعادة تعيين بيئة Power Platform

إعادة تعيين بيئة.

قصاصة برمجية YAML ‏(Reset-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.reset-environment.PowerPlatformResetEnvironment@2
  displayName: 'Power Platform Reset Environment '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    CurrencyName: ALL
    Purpose: 'Reset to PointInTime'
    AppsTemplate: 'D365_CustomerService,D365_FieldService'

المعلمات (Reset-env)

إعدادات	الوصف
`authenticationType` نوع المصادقة	(مطلوب لـ SPN) حدد إما PowerPlatformEnvironment لاتصال اسم مستخدم/كلمة مرور أو PowerPlatformSPN لاتصال سري لمسؤول الخدمة/العميل.
`PowerPlatformEnvironment` عنوان URL لبيئة Power Platform	نقطة نهاية الخدمة التي تريد إعادة تعيين البيئة فيها (على سبيل المثال، `https://powerappsbuildtools.crm.dynamics.com`). حدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform.
`PowerPlatformSPN` مسؤول خدمة Power Platform	نقطة نهاية الخدمة التي تريد إعادة تعيين البيئة فيها (على سبيل المثال، `https://powerappsbuildtools.crm.dynamics.com`). حدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform.

نسخ احتياطي لبيئة في Power Platform

إجراء نسخة احتياطية للبيئة

قصاصة برمجية YAML (نسخ احتياطي للبيئة)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.backup-environment.PowerPlatformBackupEnvironment@2
  displayName: 'Power Platform Backup Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    BackupLabel: 'Full backup - $(Build.BuildNumber)'

المعلمات (نسخ احتياطي للبيئة)

إعدادات	الوصف
`authenticationType` نوع المصادقة	(مطلوب لـ SPN) حدد إما PowerPlatformEnvironment لاتصال اسم مستخدم/كلمة مرور أو PowerPlatformSPN لاتصال سري لمسؤول الخدمة/العميل.
`PowerPlatformEnvironment` عنوان URL لبيئة Power Platform	نقطة نهاية الخدمة التي تريد نسخ البيئة الاحتياطي فيها (على سبيل المثال، `https://powerappsbuildtools.crm.dynamics.com`). حدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform.
`PowerPlatformSPN` مسؤول خدمة Power Platform	نقطة نهاية الخدمة التي تريد نسخ البيئة الاحتياطي فيها (على سبيل المثال، `https://powerappsbuildtools.crm.dynamics.com`). حدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform.
`BackupLabel` تسمية النسخة الاحتياطية	(مطلوب) التسمية التي يجب تعيينها للنسخة الاحتياطية.

نسخ بيئة في Power Platform

نسخ بيئة إلى بيئة هدف. هناك خياران للنُسخ: نسخة كاملة ونسخة الحد الأدنى. تتضمن النسخة الكاملة بيانات وبيانات تعريف الحل (تخصيصات)، بينما تتضمن نسخة الحد الأدنى بيانات تعريف الحل فقط وليس البيانات الفعلية.

قصاصة برمجية YAML (نسخ البيئة)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.copy-environment.PowerPlatformCopyEnvironment@2
  displayName: 'Power Platform Copy Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    TargetEnvironmentUrl: 'https://contoso-test.crm.dynamics.com'

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.copy-environment.PowerPlatformCopyEnvironment@2
  displayName: 'Power Platform Copy Environment '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    TargetEnvironmentUrl: 'https://contoso-test.crm.dynamics.com'
    CopyType: MinimalCopy
    OverrideFriendlyName: true
    FriendlyName: 'Contoso Test'
    SkipAuditData: true
    MaxAsyncWaitTime: 60

المعلمات (نسخ البيئة)

إعدادات	الوصف
`authenticationType` نوع المصادقة	(مطلوب لـ SPN) حدد إما PowerPlatformEnvironment لاتصال اسم مستخدم/كلمة مرور أو PowerPlatformSPN لاتصال سري لمسؤول الخدمة/العميل.
`PowerPlatformEnvironment` عنوان URL لبيئة Power Platform	نقطة نهاية الخدمة للبيئة المصدر التي ترغب في النسخ منها (على سبيل المثال، `https://powerappsbuildtools.crm.dynamics.com`). حدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform.
`PowerPlatformSPN` مسؤول خدمة Power Platform	نقطة نهاية الخدمة للبيئة المصدر التي ترغب في النسخ منها (على سبيل المثال، `https://powerappsbuildtools.crm.dynamics.com`). حدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform.
`TargetEnvironmentUrl` عنوان URL للبيئة الهدف	(مطلوب) عنوان URL للبيئة الهدف التي تريد النسخ اليها.
`CopyType` نوع النسخ	نوع النسخ المراد تنفيذه: FullCopy أو MinimalCopy
`OverrideFriendlyName` تجاوز اسم مألوف	قم بتغيير الاسم المألوف للبيئة الهدف إلى اسم آخر (صواب\|خطأ).
`FriendlyName` الاسم المألوف	الاسم المألوف للبيئة الهدف.
`SkipAuditData` SkipAuditData	ما إذا كنت تريد تخطي بيانات التدقيق أثناء عملية النسخ. (true\|false).
`MaxAsyncWaitTime` الحد الأقصى لوقت الانتظار	الحد الأقصى لوقت الانتظار بالدقائق للعملية غير المتزامنة؛ الافتراضي هو 60 دقيقة (ساعة واحدة)، وهو نفس Azure DevOps الافتراضي للمهام.

استرداد بيئة Power Platform

استعادة بيئة إلى نسخة احتياطية محددة.

قصاصة برمجية YAML (Restore-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.restore-environment.PowerPlatformRestoreEnvironment@2
  displayName: 'Power Platform Restore Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    TargetEnvironmentUrl: 'https://contoso-test.crm.dynamics.com'
    RestoreLatestBackup: false
    RestoreTimeStamp: '12/01/2022 09:00'
    FriendlyName: 'Contoso Test'

المعلمات (Restore-env)

إعدادات	الوصف
`authenticationType` نوع المصادقة	(مطلوب لـ SPN) حدد إما PowerPlatformEnvironment لاتصال اسم مستخدم/كلمة مرور أو PowerPlatformSPN لاتصال سري لمسؤول الخدمة/العميل.
`PowerPlatformEnvironment` عنوان URL لبيئة Power Platform	نقطة نهاية الخدمة للبيئة المصدر التي ترغب في الاستعادة منها (على سبيل المثال، `https://powerappsbuildtools.crm.dynamics.com`). حدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform.
`PowerPlatformSPN` مسؤول خدمة Power Platform	نقطة نهاية الخدمة للبيئة المصدر التي ترغب في الاستعادة منها (على سبيل المثال، `https://powerappsbuildtools.crm.dynamics.com`). حدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform.
`RestoreLatestBackup` آخر نسخة احتياطية لاستعادتها	ما إذا كان يجب استعادة أحدث نسخة احتياطية أو توفير RestoreTimeStamp (صواب\|خطأ).
`RestoreTimeStamp` تاريخ/وقت النسخ الاحتياطي	تاريخ ووقت النسخة الاحتياطية بالتنسيق "mm/dd/yyyy hh:mm" "أو" السلسلة "الأحدث".
`TargetEnvironmentUrl` عنوان URL للبيئة الهدف	(مطلوب) عنوان URL للبيئة الهدف التي تريد استعادتها.
`FriendlyName` اسم البيئة المستعادة.	(اختياري) اسم البيئة المستعادة.
`DisableAdminMode` تعطيل وضع الإدارة	إذا ما كنت تريد تعطيل وضع الإدارة (صواب\|خطأ).

تصدير بيانات Dataverse

تصدير بيانات من بيئة باستخدام المخطط الموفر.

قصاصة برمجية YAML (exportdata-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.export-data.PowerPlatformExportData@2
  displayName: 'Power Platform Export Data '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    SchemaFile: 'C:\tempschema.xml'
    DataFile: exportdata.zip
    Overwrite: true

المعلمات (exportdata-env)

إعدادات	الوصف
`authenticationType` نوع المصادقة	(مطلوب لـ SPN) حدد إما PowerPlatformEnvironment لاتصال اسم مستخدم/كلمة مرور أو PowerPlatformSPN لاتصال سري لمسؤول الخدمة/العميل.
`PowerPlatformSPN` مسؤول خدمة Power Platform	نقطة نهاية الخدمة للبيئة التي تريد تصدير البيانات منها (على سبيل المثال، `https://powerappsbuildtools.crm.dynamics.com`). حدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform.
`SchemaFile` اسم ملف XML المخطط	اسم ملف XML المخطط. يمكن إنشاؤه باستخدام Configuration Migration tool.
`DataFile` اسم ملف البيانات	اسم الملف الخاص بملف البيانات لتصديرها (ملف zip).
`Overwrite` الكتابة فوق المحتوى	محتوى موقع ويب Power Pages للكتابة فوقه (صواب\|خطأ).

استيراد بيانات Dataverse

استيراد بيانات إلى بيئة.

قصاصة برمجية YAML (importdata-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.import-data.PowerPlatformImportData@2
  displayName: 'Power Platform Import Data '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    DataFile: 'C:\Data\Import.zip'

المعلمات (importdata-env)

إعدادات	الوصف
`authenticationType` نوع المصادقة	(مطلوب لـ SPN) حدد إما PowerPlatformEnvironment لاتصال اسم مستخدم/كلمة مرور أو PowerPlatformSPN لاتصال سري لمسؤول الخدمة/العميل.
`PowerPlatformSPN` مسؤول خدمة Power Platform	نقطة نهاية الخدمة للبيئة التي تريد استيراد البيانات منها (على سبيل المثال، `https://powerappsbuildtools.crm.dynamics.com`). حدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform.
`DataFile` اسم ملف البيانات	اسم الملف الخاص بالملف المضغوط) الذي سيتم استيراده، أو المجلد الذي يحتوي على data-schema.xml وdata.xml الذي سيتم استيراده.

مهام إدارة Power Pages

مهام العمل مع موقع ويب Power Pages.

PAPortal لتنزيل Power Platform

قم بتنزيل محتوى موقع ويب Power Pages من بيئة Dataverse الحالية.

قصاصة برمجية YAML (download-paportal)‬

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.download-paportal.PowerPlatformDownloadPaportal@2
  displayName: 'Power Platform Download PAPortal '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    DownloadPath: 'C:\portals'
    WebsiteId: 'f88b70cc-580b-4f1a-87c3-41debefeb902'
    Overwrite: true

المعلمات (download-paportal)

إعدادات	الوصف
`authenticationType` نوع المصادقة	(مطلوب لـ SPN) حدد إما PowerPlatformEnvironment لاتصال اسم مستخدم/كلمة مرور أو PowerPlatformSPN لاتصال سري لمسؤول الخدمة/العميل.
`PowerPlatformSPN` مسؤول خدمة Power Platform	نقطة نهاية الخدمة للبيئة التي تريد تنزيل المحتوى منها (على سبيل المثال، `https://powerappsbuildtools.crm.dynamics.com`). حدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform.
`WebsiteId` معرف موقع ويب المدخل	معرف موقع ويب Power Pages المطلوب تنزيله.
`Overwrite` الكتابة فوق المحتوى	محتوى موقع ويب Power Pages للكتابة فوقه (صواب\|خطأ).
`ModelVersion` نموذج بيانات الموقع	الإشارة إلى ما إذا كانت بيانات الموقع التي سيتم تحميلها ستستخدم نموذج البيانات القياسي (`1`) أو المحسّن (`2`). القيمة الافتراضية هي "1".

PAPortal لتحميل Power Platform

تحميل محتوى موقع ويب Power Pages إلى بيئة Dataverse الحالية.

قصاصة برمجية YAML (upload-paportal)‬

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.upload-paportal.PowerPlatformUploadPaportal@2
  displayName: 'Power Platform Upload PAPortal '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    UploadPath: 'C:\portals\starter-portal'

المعلمات (upload-paportal)

إعدادات	الوصف
`authenticationType` نوع المصادقة	(مطلوب لـ SPN) حدد إما PowerPlatformEnvironment لاتصال اسم مستخدم/كلمة مرور أو PowerPlatformSPN لاتصال سري لمسؤول الخدمة/العميل.
`PowerPlatformSPN` مسؤول خدمة Power Platform	نقطة نهاية الخدمة للبيئة التي تريد تحميل المحتوى إليها (على سبيل المثال، `https://powerappsbuildtools.crm.dynamics.com`). حدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform.
`UploadPath` مسار محتوى التحميل	المسار من حيث سيتم تحميل محتوى موقع ويب Power Pages.
`ModelVersion` نموذج بيانات الموقع	الإشارة إلى ما إذا كانت بيانات الموقع التي سيتم تحميلها ستستخدم نموذج البيانات القياسي (`1`) أو المحسّن (`2`). القيمة الافتراضية هي "1".

كتالوج لمهام Power Platform (إصدار أولي)

تنفذ هذه المهام إجراءات مقابل الكتالوج في Power Platform وتتضمن ما يلي.

ملحوظة

في الوقت الحالي، مهام الكتالوج في Power Platform هي في وضع الإصدار الأولي.

تثبيت عنصر كتالوج

قم بتثبيت عنصر Catalog في البيئة الهدف.

إعدادات	الوصف
`authenticationType` نوع المصادقة	(مطلوب لـ SPN) حدد إما PowerPlatformEnvironment لاتصال اسم مستخدم/كلمة مرور أو PowerPlatformSPN لاتصال سري لمسؤول الخدمة/العميل.
`PowerPlatformSPN` مسؤول خدمة Power Platform	نقطة نهاية الخدمة للبيئة التي تريد تحميل المحتوى إليها (على سبيل المثال، `https://powerappsbuildtools.crm.dynamics.com`). حدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform.
`Environment` عنوان URL للبيئة الهدف	(مطلوب) عنوان URL الذي تستهدفه هذه المهمة.
`CatalogItemId` معرف عنصر الكتالوج الذي سيتم تثبيته	(مطلوب) عنصر الكتالوج الذي سيتم تثبيته في البيئة الهدف.
`TargetEnvironmentUrl` عنوان URL للبيئة الهدف	(مطلوب) عنوان URL للبيئة المستهدفة لتثبيت عنصر الكتالوج في (على سبيل المثال، "https://YourOrg.crm.dynamics.com").
`PollStatus` التحقق من حالة الاستقصاء	(اختياري) استقصاء للتحقق من حالة طلبك (صواب\|خطأ).

المعلمات (catalog-install)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools-DEV.install-catalog.PowerPlatformInstallCatalog@2
  displayName: 'Power Platform Install Catalog '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    Environment: '$(BuildTools.EnvironmentUrl)'
    CatalogItemId: '00000000-0000-0000-0000-000000000001'
    TargetEnvironmentUrl: 'https://test.crm.dynamics.com/'
    PollStatus: true

إرسال الموافقة على الكتالوج

إرسال طلب موافقة Catalog.

إعدادات	الوصف
`authenticationType` نوع المصادقة	(مطلوب لـ SPN) حدد إما PowerPlatformEnvironment لاتصال اسم مستخدم/كلمة مرور أو PowerPlatformSPN لاتصال سري لمسؤول الخدمة/العميل.
`PowerPlatformSPN` مسؤول خدمة Power Platform	نقطة نهاية الخدمة للبيئة التي تريد تحميل المحتوى إليها (على سبيل المثال، "https://powerappsbuildtools.crm.dynamics.com"). حدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform.
`Environment` عنوان URL للبيئة الهدف	(مطلوب) عنوان URL الذي تستهدفه هذه المهمة.
`CatalogSubmissionFile` ملف إرسال الكتالوج	(مطلوب) حدد المسار واسم الملف لملف إرسال الكتالوج.
`UsePackageSolutionZipFile` نوع الملف	نوع الملف: حزمة أو ملف مضغوط للحل.
`SolutionZipFile` اسم الملف المضغوط للحل.	حدد المسار واسم الملف للملف المضغوط للحل.
`PollStatus` التحقق من حالة الاستقصاء	(اختياري) استقصاء للتحقق من حالة طلبك (صواب\|خطأ).

المعلمات (catalog-submit)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools-DEV.submit-catalog.PowerPlatformSubmitCatalog@2
  displayName: 'Power Platform Submit Catalog '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    Environment: '$(BuildTools.EnvironmentUrl)'
    CatalogSubmissionFile: submission.json
    UsePackageSolutionZipFile: true
    FileType: SolutionZipFile
    SolutionZipFile: solution.zip
    PollStatus: true

حالة طلب الكتالوج

احصل على حالة طلب تثبيت/إرسال الكتالوج.

إعدادات	الوصف
`authenticationType` نوع المصادقة	(مطلوب لـ SPN) حدد إما PowerPlatformEnvironment لاتصال اسم مستخدم/كلمة مرور أو PowerPlatformSPN لاتصال سري لمسؤول الخدمة/العميل.
`PowerPlatformSPN` مسؤول خدمة Power Platform	نقطة نهاية الخدمة للبيئة التي تريد تحميل المحتوى إليها (على سبيل المثال، "https://powerappsbuildtools.crm.dynamics.com"). حدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform.
`Environment` عنوان URL للبيئة الهدف	(مطلوب) عنوان URL الذي تستهدفه هذه المهمة.
`TrackingId` معرف تعقب الطلب	(مطلوب) معرف تعقب الطلب.
`RequestType` نوع الطلب	(مطلوب) نوع الطلب. (القيم: تثبيت \| إرسال).

المعلمات (catalog-status)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools-DEV.catalog-status.PowerPlatforCatalogStatus@2
  displayName: 'Power Platform Catalog Status '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    Environment: '$(BuildTools.EnvironmentUrl)'
    TrackingId: '00000000-0000-0000-0000-000000000002'
    RequestType: Submit

مسارات البناء والإصدار

والآن وقد تعرفنا على ما يمكن القيام به باستخدام أدوات البناء، سنرى كيف يمكنك تطبيق هذه الأدوات على مسارات البناء والإصدار. فيما يلي نظرة عامة تصورية. لنستعرض الآن بعض التفاصيل الخاصة بتنفيذ المسار باستخدام مهام أدوات البناء في الأقسام الفرعية التالية.

لمعرفة المزيد حول إنشاء هذه المسارات والقيام فعليًا بإعدادها باستخدام أدوات Microsoft Power Platform Build Tools، أكمل مختبرات بناء tools، والتي يمكنك تنزيلها من GitHub.

مزيد من المعلومات حول Azure Pipelines: استخدام Azure Pipelines

مسار البناء: تصدير حل من بيئة تطوير (DEV)

يُظهر الشكل التالي مهام أدوات البناء التي قد تضيفها إلى مسار يقوم بتصدير حل من بيئة تطوير.

تصدير حل من بيئة تطوير (DEV).

مسار البناء: بناء حل مُدار

يُظهر الشكل التالي مهام أدوات البناء التي قد تضيفها إلى مسار يقوم ببناء حل مُدار.

بناء حل مُدار.

مسار الإصدار: النشر إلى بيئة إنتاج (PROD)

يُظهر الشكل التالي مهام أدوات البناء التي قد تضيفها إلى مسار يقوم بنشر بيئة إنتاج.

النشر إلى بيئة إنتاج (PROD).

انظر أيضاً

Microsoft Power Platform Build Tools for Azure DevOps

الملاحظات

هل كانت هذه الصفحة مفيدة؟

Last updated on 2026-08-19