Microsoft Power Platform כלי בניה משימות

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

משימת עוזר

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

מתקין כלי 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@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` שימוש בגירסאות ברירת מחדל של כלי	הגדר ל- true כדי להשתמש בגירסת ברירת המחדל של כל הכלים, אחרת הגדר ל- false. נדרש (ו- false) כאשר מצוינות גרסאות של כלים.
`AddToolsToPath` הוספת כלים לנתיב	הוספת ה- pac cli למשתנה `PATH` הסביבה. מאפשרת לך להשתמש ב- pac cli ממשימות Script ללא צורך להגדיר את הנתיב באופן ידני.
`PowerAppsAdminVersion` `XrmToolingPackageDeploymentVersion` `MicrosoftPowerAppsCheckerVersion` `CrmSdkCoreToolsVersion` גירסת כלי	הגירסה הספציפית של הכלי לשימוש.

פלטפורמת Power מי אני

מאמת חיבור לשירות סביבה של 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
`PowerPlatformEnvironment` כתובת URL של סביבת Power Platform	נקודת הקצה של השירות עבור הסביבה שאליה יש להתחבר. מוגדר תחת חיבורי שירות במסך הגדרות פרוייקט. מידע נוסף: ראה `BuildTools.EnvironmentUrl` תחת צור סביבת Power Platform
`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` חיבור שירות	(נדרש) נדרש חיבור לסביבה Microsoft Power Platform רשיון כדי להשתמש בודק Power Platform. חיבורי שירות מוגדרים ב- חיבורי שירות תחת הגדרות פרויקט באמצעות סוג חיבור Power Platform. מידע נוסף: ראו `BuildTools.EnvironmentUrl` תחת Power Platform יצירת סביבה הערה: שיטות האימות Service Principal ושם משתמש/סיסמה זמינות למשימת הבודק. למידע נוסף על אופן התצורה של מנהלי שירות שישמשו במשימה זו, ראה הגדר חיבורי שירות עיקריים עבור סביבות 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. Marketplace: ערכת הכללים המורחבת המשמשת לאשר יישום לפני שניתן יהיה לפרסם אותו ב- Marketplace.
`ErrorLevel` רמת שגיאה	בשילוב עם השגיאה, פרמטר הסף מגדיר את חומרת השגיאות והאזהרות המורשות. ערכי הסף הנתמכים הם <level>IssueCount, כאשר "level" יכול להיות קריטי, גבוה, בינוני, נמוך או מידע.
`ErrorThreshold` סף שגיאה	מגדיר את מספר השגיאות (>=0) ברמה שצוינה המורשות עבור הבודק כדי לעבור את הפתרונות שנבדקים.
`FailOnPowerAppsCheckerAnalysisError` כשל בשגיאה	כאשר true, נכשל אם ניתוח ה-Power Apps Checker מוחזר כ"נכשל" או "FinishedWithErrors".
`ArtifactDestinationName` שם תוצר DevOps	ציין את שם Azure Artifacts עבור קובץ בודק ה-.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` ייבוא כפתרון זמני	פרמטר מקדים (true\|false) משמש כאשר יש צורך לשדרג פתרון. פרמטר זה מארח את הפתרון ב- Dataverse אך אינו משדרג את הפתרון עד להפעלת משימת 'החל שדרוג פתרון'.
`OverwriteUnmanagedCustomizations` החלפת התאמות אישיות לא מנוהלות	ציין אם להחליף התאמות אישיות לא מנוהלות (true\|false).
`SkipProductUpdateDependencies` דילוג על יחסי תלות של עדכון מוצר	ציין אם יש לדלג על האכיפה של יחסי תלות הקשורים לעדכוני מוצר (true\|false).
`ConvertToManaged` המרה למנוהל	מְיוּשָׁן. המערכת תמיר רכיבי פתרון לא מנוהלים לרכיבים מנוהלים בעת ייבוא פתרון מנוהל.
`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@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` שדרוג אסינכרוני	אם נבחר (true), פעולת השדרוג תתבצע כמשימת אצווה אסינכרונית. בחירה ב'אסינכרוני' תגרום לסקר ותמתין עד להגעה ל- 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` ייצוא אסינכרוני	אם נבחר (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@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.* משתנים כדי לספק למשימות Script מותאמות אישית גישה לשימוש בחיבור השירות כמקור אמת יחיד.

המשתנים הבאים מוגדרים:

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

הערה

בעת שימוש בסוג האימות של שם משתמש/סיסמה, יידרשו מזהה האפליקציה ו-Redirect 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‏ (Create-env)

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

פרמטרים (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@2
  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@2
  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@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

פרמטרים (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` שם ידידותי	השם הידידותי של סביבת היעד.
`SkipAuditData` SkipAuditData (דלג על נתוני הביקורת)	אם לדלג על נתוני ביקורת במהלך פעולת העתקה. (אמת/שקר).
`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 (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 (הורד-פאפורטל)

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

Power Platform העלאת PAPortal

העלה את תוכן אתר האינטרנט של 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).

פרמטרים (שליחת-קטלוג)

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

בנייה והפצה של צינורות

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

לקבלת מידע נוסף על יצירת קווי צינור אלה ולביצוע עריכה מעשית של צינור באמצעות כלי ה- Build של Microsoft Power Platform, השלם את מעבדות הכלים ל- build, שבאפשרותך להוריד מ- GitHub.

מידע נוסף אודות Azure Pipelines: שימוש Azure Pipelines