משימות של Microsoft Power Platform Build Tools

מאמר
03/29/2024

משימות הבניה הזמינות מתוארות בסעיפים הבאים. לאחר מכן נציג דוגמה לקווי צינור של Azure שמשתמשים במשימות אלה. למידע על כלי היצירה וכיצד להוריד אותם, ראה Microsoft Power Platform צור כלים לקווי צינור של Azure.

משימת עוזר

משימות המסייע הזמינות מתוארות בהמשך.

מתקין כלי Power Platform

יש להוסיף משימה זו פעם אחת לפני כל משימות Build Tools של Power Platform האחרות בערוצי בנייה והפצה. משימה זו מתקינה קבוצה של כלים ספציפיים ל- Power Platform, הנדרשים על-ידי הסוכן להפעלת משימות הבנייה של Microsoft Power Platform. משימה זו אינה דורשת תצורה נוספת בעת ההוספה. משימה זו מכילה פרמטרים עבור הגירסאות הספציפיות של כל אחד מהכלים המותקנים.

כדי להישאר מעודכן לגבי גירסאות הכלי במשך הזמן, ודא שפרמטרים אלה מתאימים לגירסאות הכלים הנדרשות כדי שהערוץ יפעל כהלכה.

מקטע YAML (מתקין)

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

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

פרמטרים (מתקין)

פרמטרים	תיאור
`DefaultVersion` שימוש בגירסאות ברירת מחדל של כלי	הגדר ל- true כדי להשתמש בגירסת ברירת המחדל של כל הכלים, אחרת הגדר ל- false. נדרש (ו- false) כאשר גירסאות כלי כלשהן מצוינות.
`PowerAppsAdminVersion` `XrmToolingPackageDeploymentVersion` `MicrosoftPowerAppsCheckerVersion` `CrmSdkCoreToolsVersion` גירסת כלי	הגירסה הספציפית של הכלי לשימוש.

Power Platform WhoAmI

מאמת חיבור לשירות סביבה של Power Platform על-ידי חיבור ויצירה של בקשת WhoAmI. משימה זו יכולה להיות שימושית כדי להיכלל בשלב מוקדם בערוץ, לצורך אימות קישוריות לפני שהעיבוד מתחיל.

מקטע YAML‏ (WhoAmI)

# Verifies an environment service connection
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.whoami.PowerPlatformWhoAmi@0
  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@0
  displayName: 'Power Platform WhoAmI'

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

פרמטרים (WhoAmI)

פרמטרים	תיאור
`authenticationType` סוג אימות	(אופציונלי) ציין PowerPlatformEnvironment עבור חיבור שם משתמש/סיסמה או PowerPlatformSPN עבור חיבור סודי של מנהל שירות/לקוח. מידע נוסף: ראה `BuildTools.EnvironmentUrl` תחת צור סביבת Power Platform
`PowerPlatformEnvironment` כתובת URL של סביבת Power Platform	נקודת הקצה של השירות עבור הסביבה שאליה יש להתחבר. מוגדר תחת חיבורי שירות במסך הגדרות פרוייקט. מידע נוסף: ראה `BuildTools.EnvironmentUrl` תחת צור סביבת Power Platform
`PowerPlatformSPN` מנהל שירות Power Platform	נקודת הקצה של השירות עבור הסביבה שאליה יש להתחבר. מוגדר תחת חיבורי שירות במסך הגדרות פרוייקט.

בדיקת איכות

בסעיף הבא מופיעות המשימות הזמינות לבדיקת איכות הפתרון.

Power Platform Checker

משימה זו מפעילה בדיקת ניתוח סטטי בפתרונות שלך כנגד סדרה של כללי שיטות עבודה מומלצות לצורך זיהוי דפוסים בעייתיים שייתכן שהצגת בשוגג בעת בניית הפתרון שלך.

מקטע YAML (בודק)

# Static analysis check of your solution
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.checker.PowerPlatformChecker@0
  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@0
  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` חיבור שירות	(חובה) חיבור לסביבת Microsoft Power Platform מורשה נדרש לצורך שימוש בבודק Power Platform. חיבורי שירות מוגדרים ב- חיבורי שירות תחת הגדרות פרויקט באמצעות סוג חיבור Power Platform. מידע נוסף: זמינים במאמר `BuildTools.EnvironmentUrl`צ Power Platform יצירת סביבה הערה: שיטות האימות מנהל השירות ושם משתמש/סיסמה זמינות למשימת הבודק. למידע נוסף על אופן התצורה של מנהלי שירות שישמשו במשימה זו, ראה הגדר חיבורי שירות עיקריים עבור סביבות Power Platform.
`UseDefaultPACheckerEndpoint` השתמש בנקודת הקצה של ברירת המחדל של בודק Power Platform	כברירת מחדל (true), המיקום הגיאוגרפי של שירות הבודק משתמש באותו אזור גיאוגרפי של הסביבה שאליה אתה מתחבר.
`CustomPACheckerEndpoint` נקודת קצה של בודק PAC מותאם אישית	נדרש כאשר `UseDefaultPACheckerEndpoint` הוא false. ייתכן שבחרת לציין אזור גיאוגרפי אחר לשימוש, לדוגמה `https://japan.api.advisor.powerapps.com.` לרשימה של גיאוגרפיות זמינות, יש לעיין במאמר +שימוש בממשק ה- API של בודק Power Platform.
`FileLocation` מיקום הקבצים לניתוח	נדרש בעת הפניה לקובץ מכתובת URL של חתימת גישה משותפת (SAS) `sasUriFile`. הערה: חשוב להתייחס לקובץ פתרון מיוצא ולא לקבצי המקור שנפרקו במאגר שלך. ניתן לנתח את קבצי הפתרונות המנוהלים וגם הלא מנוהלים.
`FilesToAnalyzeSasUri` קבצי SAS לניתוח	נדרש כאשר `FileLocation` מוגדר ל- `sasUriFile`. הזן את כתובת ה- URI של SAS. אתה יכול להוסיף יותר מ- URI SAS אחד באמצעות רשימה מופרדת באמצעות פסיק (,) או נקודה-פסיק (;).
`FilesToAnalyze` קבצים מקומיים לניתוח	נדרש כאשר קבצי SAS אינם מנותחים. ציין את הנתיב ואת שם הקובץ של קבצי ה- ‎zip שיש לנתח. ניתן להשתמש בתוויות כלליים. לדוגמה, הזן *\.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 Portal . AppSource: קבוצת הכללים המורחבת המשמשת לאישור בקשה לפני שניתן לפרסם אותה ב- AppSource.
`ErrorLevel` רמת שגיאה	בשילוב עם השגיאה, פרמטר הסף מגדיר את חומרת השגיאות והאזהרות המורשות. ערכי סף נתמכים הם <level>IssueCount כאשר level=קריטי, גבוה, בינוני, נמוך ומידע.
`ErrorThreshold` סף שגיאה	מגדיר את מספר השגיאות (>=0) ברמה שצוינה המורשות עבור הבודק כדי לעבור את הפתרונות שנבדקים.
`FailOnPowerAppsCheckerAnalysisError` כשל בשגיאה	כאשר true, כשל אם ניתוח בודק Power Apps מוחזר כ'נכשל' או 'הסתיים עם שגיאות'.
`ArtifactDestinationName` שם תוצר DevOps	ציין את שם תוצרי Azure עבור קובץ ‎.sarif של הבודק.

משימות פתרון

קבוצת משימות זו יכול להפוך את פעולות הפתרון לאוטומטיות. משימות הסביבה המתוארות בהמשך סעיף זה שיוצרות, מעתיקות או משחזרות סביבה מחליפות את חיבורי השירות בסביבות החדשות שנוצרו. משימות אלה מאפשרות את הביצוע של משימות הפיתרון מול סביבות שנוצרות על פי דרישה.

פתרון ייבוא Power Platform

מייבא פתרון לסביבת יעד.

מקטע YAML (ייבוא)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.import-solution.PowerPlatformImportSolution@0
  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
    ConvertToManaged: true

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.import-solution.PowerPlatformImportSolution@0
  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` ייבוא כפתרון שמור	פרמטר מקדים (true\|false) משמש כאשר יש צורך לשדרג פתרון. פרמטר זה מארח את הפתרון ב- Dataverse אך אינו משדרג את הפתרון עד להפעלת משימת 'החל שדרוג פתרון'.
`OverwriteUnmanagedCustomizations` החלפת התאמות אישיות לא מנוהלות	ציין אם להחליף התאמות אישיות לא מנוהלות (true\|false).
`SkipProductUpdateDependencies` דילוג על יחסי תלות של עדכון מוצר	ציין אם יש לדלג על האכיפה של יחסי תלות הקשורים לעדכוני מוצר (true\|false).
`ConvertToManaged` המרה למנוהל	ציין אם לייבא כפתרון מנוהל (true\|false).
`AsyncOperation` ייבוא אסינכרוני	אם נבחר (true), פעולת הייבוא תתבצע באופן אסינכרוני. זה מומלץ לפתרונות גדולים יותר מכיוון שמשימה זו תפסיק אוטומטית לאחר 4 דקות. בחירה ב'אסינכרוני' תגרום לסקר ותמתין עד להגעה ל- MaxAsyncWaitTime‏ (true\|false).
`MaxAsyncWaitTime` זמן המתנה מקסימלי	זמן המתנה מקסימלי בדקות לפעולה האסינכרונית; ברירת המחדל היא 60 דקות (שעה), זהה לברירת המחדל של Azure DevOps עבור משימות.
`PublishWorkflows` הפעל תהליכים לאחר הייבוא	ציין אם יש להפעיל תהליכים (זרימות עבודה) בפתרון לאחר הייבוא (true\|false).
`UseDeploymentSettingsFile` שימוש בקובץ הגדרות פריסה	ניתן להגדיר הפניות לחיבור וערכי משתנה סביבה באמצעות קובץ הגדרות פריסה (true\|false).
`DeploymentSettingsFile` קובץ הגדרות פריסה	(נדרש כאשר `UseDeploymentSettingsFile`=true) הנתיב ושם הקובץ של קובץ הגדרות הפריסה.

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@0
  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@0
  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` שדרוג אסינכרוני	אם נבחר (true), פעולת השדרוג תתבצע כמשימת אצווה אסינכרונית. בחירה ב'אסינכרוני' תגרום לסקר ותמתין עד להגעה ל- MaxAsyncWaitTime.
`MaxAsyncWaitTime` זמן המתנה מקסימלי	זמן המתנה מקסימלי בדקות לפעולה האסינכרונית; ברירת המחדל היא 60 דקות (שעה), זהה לברירת המחדל של Azure DevOps עבור משימות.

הערה

משתנים מעניקים לך דרך נוחה לקבלת פיסות נתונים חשובות לחלקים שונים של הערוץ שלך. ראה שימוש במשתנים מוגדרים מראש לקבלת רשימה מקיפה. אפשר לאכלס מראש מידע על משתני סביבה והפניית חיבור עבור סביבת היעד בעת ייבוא פתרון באמצעות קובץ הגדרות פריסה.

מידע נוסף: אכלוס מראש של הפניות לחיבור ומשתני סביבה לפריסות אוטומטיות

פתרון ייצוא Power Platform

מייצא פתרון מסביבת מקור.

מקטע YAML (ייצוא)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.export-solution.PowerPlatformExportSolution@0
  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@0
  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` ייצוא אסינכרוני	אם נבחר (true), פעולת הייצוא תתבצע כמשימת אצווה אסינכרונית. בחירה ב'אסינכרוני' תגרום לסקר ותמתין עד להגעה ל- MaxAsyncWaitTime.
`MaxAsyncWaitTime` זמן המתנה מקסימלי	זמן המתנה מקסימלי בדקות לפעולה האסינכרונית; ברירת המחדל היא 60 דקות (שעה), זהה לברירת המחדל של Azure DevOps עבור משימות.
`Managed` ייצוא כמנוהל	אם נבחר (true), יצא את הפתרון כפתרון מנוהל; אחרת יצא כפתרון לא מנוהל.
`ExportAutoNumberingSettings` ייצוא הגדרות מספור אוטומטי	ייצוא הגדרות מספור אוטומטי (true\|false).
`ExportCalendarSettings` הגדרות ייצוא לוח שנה	הגדרות ייצוא לוח שנה (true\|false).
`ExportCustomizationSettings` ייצוא הגדרות התאמה אישית	ייצוא הגדרות התאמה אישית (true\|false).
`ExportEmailTrackingSettings` ייצוא הגדרות מעקב אחר דואר אלקטרוני	ייצוא הגדרות מעקב אחר דואר אלקטרוני (true\|false).
`ExportGeneralSettings` ייצוא הגדרות כלליות	ייצוא הגדרות כלליות (true\|false).
`ExportIsvConfig` ייצוא תצורת ISV	ייצוא תצורת ISV‏ (true\|false).
`ExportMarketingSettings` ייצוא הגדרות שיווק	ייצוא הגדרות שיווק (true\|false).
`ExportOutlookSynchronizationSettings` ייצוא הגדרות סינכרון של Outlook	ייצוא הגדרות סינכרון של Outlook‏ (true\|false).
`ExportRelationshipRoles` ייצוא תפקידי קשר	ייצוא תפקידי קשר (true\|false).
`ExportSales` ייצוא מכירות	ייצוא מכירות (true\|false).

פירוק אריזה של פתרון ב- Power Platform

מחלצת קובץ פתרון דחוס אל תוך קבצי XML מרובים וקבצים אחרים, כדי שמערכת בקרת מקור תוכל לנהל ולקרוא קבצים אלה בקלות רבה יותר.

מקטע YAML (פרק חבילה)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.unpack-solution.PowerPlatformUnpackSolution@0
  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@0
  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@0
  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@0
  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@0
  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.

לחלופין, פלט קובץ Script של משימה מובנה של powershell‏ $(Get-Date -Format yyyy.MM.dd.HHmm) המוגדר למשתנה ריק בשם SolutionVersion כ- Write-Host ("##vso[task.setvariable variable=SolutionVersion;]$version"), הגדר גירסת פתרון ל- $(SolutionVersion).

הגדר משתני חיבור ב- Power Platform

מגדיר משתני BuildTools.* כדי לספק גישה למשימות סקריפט מותאמות אישית לשימוש בחיבור השירות כמקור אמת יחיד.

מקטע 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 של האפליקציה שצוינה. נחוץ בעת ציון מזהה אפליקציה. (ראה הערה נוספת למטה).

הערה

בעת שימוש בסוג האימות של שם משתמש/סיסמה, יידרשו מזהה האפליקציה ו-Redirect Uri. במסמך אימות oauth זה יש הסבר מדוע עליך ליצור רישום אפליקציה כדי לבצע אימות עם Dataverse. כאשר אתה מתחבר באמצעות אימות שם משתמש/סיסמה, החיבור מתנהג כאפליקציה שמתחברת מטעם משתמש ל- Dataverse.

חבילת פריסה של Power Platform

פורס חבילה לסביבה. פריסת חבילה בניגוד לקובץ פתרון יחיד מעניקה אפשרות לפרוס פתרונות מרובים, נתונים וקוד בסביבה.

מקטע YAML (פרוס)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.deploy-package.PowerPlatformDeployPackage@0
  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‏ (Create-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.create-environment.PowerPlatformCreateEnvironment@0
  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@0
  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

פרמטרים (Create-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.
`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‏ (Delete-env)

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

פרמטרים (Delete-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 ‏(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	מציין אם משתמש הקלט הוא משתמש אפליקציה (true\|false).

סביבת איפוס של 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‏ (Backup-env)

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

פרמטרים (Backup-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.
`BackupLabel` תווית גיבוי	(נדרש) התווית שיש להקצות לגיבוי.

העתק סביבה של Power Platform

מעתיק סביבה לסביבת יעד. ישנם שני סוגי עותקים זמינים: מלא ומינימלי. עותק מלא כולל גם את הנתונים וגם את המטה-נתונים של הפתרון (התאמות אישיות), ועותק מינימלי כולל רק את המטה-נתונים של הפתרון, ולא את הנתונים עצמם.

מקטע YAML‏ (Copy-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.copy-environment.PowerPlatformCopyEnvironment@0
  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@0
  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'
    DisableAdminMode: false

פרמטרים (Copy-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.
`TargetEnvironmentUrl` כתובת ה- URL של סביבת יעד	(נדרש) כתובת ה- URL של סביבת היעד שאליה ברצונך להעתיק.
`CopyType` סוג העתקה	סוג ההעתקה לביצוע: FullCopy or MinimalCopy
`OverrideFriendlyName` עקיפת שם ידידותי	שנה את השם הידידותי של סביבת היעד לשם אחר (true\|false).
`FriendlyName` שם ידידותי	השם הידידותי של סביבת היעד.
`DisableAdminMode` בטל מצב מנהל מערכת	אם לבטל מצב ניהול (true\|false).

שחזר סביבה של 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 (true\|false)‎‏.
`RestoreTimeStamp` תאריך ושעה של הגיבוי	תאריך ושעה של הגיבוי בתבנית 'dd/mm/yyyy hh:mm' או המחרוזת 'latest'.
`TargetEnvironmentUrl` כתובת ה- URL של סביבת יעד	(נדרש) כתובת ה- URL של סביבת היעד שאליה ברצונך לשחזר.
`FriendlyName` השם של הסביבה המשוחזרת	(אופציונלי) שם של הסביבה המשוחזרת.
`DisableAdminMode` בטל מצב מנהל מערכת	אם לבטל מצב ניהול (true\|false).

ייצוא נתוני 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. ניתן ליצור אותו באמצעות כלי העברה של תצורה.
`DataFile` שם קובץ נתונים	שם קובץ עבור נתונים לייצוא (קובץ zip).
`Overwrite` החלף תוכן	תוכן אתר Power Pages להחלפה (true\|false).

ייבוא נתוני 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` שם קובץ נתונים	שם קובץ עבור קובץ zip) קובץ ניתונים לייבוא, או התיקיה עם 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` מזהה אתר Portal	מזהה אתר אינטרנט של Power Pages להורדה.
`Overwrite` החלף תוכן	תוכן אתר Power Pages להחלפה (true\|false).
`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 ‏(Preview)

משימות אלה מבצעות פעולות מול הקטלוג ב- Power Platform וכוללות את הדברים הבאים.

הערה

נכון לעכשיו, משימות הקטלוג עבור Power Platform הן במהדורת Preview.

התקן פריט קטלוג

התקן פריט 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` בדיקת מצב הסקר	(אופציונלי) תשאול לבדיקת מצב הבקשה שלך (true\|false).

פרמטרים (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` סוג קובץ	סוג קובץ: קובץ zip של חבילה או פתרון.
`SolutionZipFile` שם קובץ ה- zip של הפתרון	ציין את הנתיב ואת שם הקובץ של קובץ הפתרון.
`PollStatus` בדיקת מצב הסקר	(אופציונלי) תשאול לבדיקת מצב הבקשה שלך (true\|false).

פרמטרים (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, השלם את מעבדות כלי היצירה, שאותן ניתן להוריד מ- GitHub.

מידע נוסף על קווי צינור ב- Azure: השתמש בקווי צינור ב- Azure

בניית ערוץ: ייצוא פתרון מסביבת פיתוח (DEV)

האיור הבא מציג את משימות כלי הבנייה שתוכל להוסיף לערוץ שמייצא פתרון מסביבת פיתוח.

ייצוא פתרון מסביבת פיתוח (DEV).

בניית ערוץ: בניית פתרון מנוהל

האיור הבא מציג את משימות כלי הבנייה שתוכל להוסיף לערוץ שבונה פתרון מנוהל.

בניית פתרון מנוהל.

ערוץ הפצה: פריסה בסביבת ייצור (PROD)

האיור הבא מציג את משימות כלי הבנייה שתוכל להוסיף לערוץ שנפרס בסביבת ייצור.

פריסה בסביבת ייצור (PROD).

ראה גם

Microsoft Power Platform Build Tools עבור Azure DevOps

שתף באמצעות

משימות של Microsoft Power Platform Build Tools

משימת עוזר

מתקין כלי Power Platform

מקטע YAML (מתקין)

פרמטרים (מתקין)

Power Platform WhoAmI

מקטע YAML‏ (WhoAmI)

פרמטרים (WhoAmI)

בדיקת איכות

Power Platform Checker

מקטע YAML (בודק)

פרמטרים (בודק)

משימות פתרון

פתרון ייבוא Power Platform

מקטע YAML (ייבוא)

פרמטרים (ייבוא)

Power Platform הוספת רכיב פתרון

מקטע YAML (הוסף)

פרמטרים (הוספה)

Power Platform החל שדרוג פתרון

מקטע YAML (שדרוג)

פרמטרים (שדרוג)

פתרון ייצוא Power Platform

מקטע YAML (ייצוא)

פרמטרים (ייצוא)

פירוק אריזה של פתרון ב- Power Platform

מקטע YAML (פרק חבילה)

פרמטרים (פרק חבילה)

אריזת פתרון ב- Power Platform

מקטע YAML (ארוז)

פרמטרים (ארוז)

פתרון מחיקת Power Platform

מקטע YAML (מחק)

פרמטרים (מחק)

פרסום התאמות אישיות ב- Power Platform

מקטע YAML (פרסם)

פרמטרים (פרסם)

קביעת גירסת פתרון של Power Platform

מקטע YAML (גירסה)

פרמטרים (גירסה)

הגדר משתני חיבור ב- Power Platform

מקטע YAML (SetConnectionVariables)

פרמטרים (SetConnectionVariables)

חבילת פריסה של Power Platform

מקטע YAML (פרוס)

פרמטרים (פרוס)

משימות ניהול סביבה

יצירת סביבה של Power Platform

מקטע YAML‏ (Create-env)

פרמטרים (Create-env)

מחק סביבה של Power Platform

מקטע YAML‏ (Delete-env)

פרמטרים (Delete-env)

Power Platform הקצה משתמש

מקטע YAML ‏(AssignUser-env)

פרמטרים (AssignUser-env)

סביבת איפוס של Power Platform

מקטע YAML‏ (Reset-env)

פרמטרים (Reset-env)

גיבוי סביבה של Power Platform

מקטע YAML‏ (Backup-env)

פרמטרים (Backup-env)

העתק סביבה של Power Platform

מקטע YAML‏ (Copy-env)

פרמטרים (Copy-env)

שחזר סביבה של Power Platform

מקטע YAML‏ (Restore-env)

פרמטרים (Restore-env)

ייצוא נתוני Dataverse

מקטע YAML ‏(exportdata-env)

פרמטרים (exportdata-env)

ייבוא נתוני Dataverse

מקטע YAML ‏(importdata-env)

פרמטרים (importdata-env)

משימות ניהול של Power Pages

הורד PAPortal של Power Platform

קטע YAML ‏(download-paportal)

פרמטרים (download-paportal)

PAPortal להעלה של Power Platform