งานของ Microsoft Power Platform Build Tools

งานสร้างที่ใช้งานได้ อธิบายไว้ในส่วนต่อไปนี้ หลังจากนั้น เราจะแสดงตัวอย่างไปป์ไลน์ Azure ในการใช้ประโยชน์จากงานเหล่านี้ สำหรับข้อมูลเกี่ยวกับเครื่องมือสร้างและวิธีดาวน์โหลด ดูที่ Microsoft Power Platform Build Tools สำหรับไปป์ไลน์ Azure

งานตัวช่วย

งานผู้ช่วยที่พร้อมใช้งานมีการอธิบายไว้ถัดไป

ตัวติดตั้งเครื่องมือ Power Platform

งานนี้จำเป็นต้องเพิ่มหนึ่งครั้งก่อนงานอื่นๆ ของ Power Platform Build Tools ในไปป์ไลน์การสร้างและการเผยแพร่ งานนี้ติดตั้งชุดเครื่องมือเฉพาะ 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` ใช้เวอร์ชันเครื่องมือเริ่มต้น	ตั้งค่าเป็น จริง เพื่อใช้เวอร์ชันเริ่มต้นของเครื่องมือทั้งหมด มิฉะนั้นจะเป็น เท็จ จำเป็น (และ เท็จ) เมื่อมีการระบุเวอร์ชันเครื่องมือใดๆ
`AddToolsToPath` เพิ่มเครื่องมือไปยังเส้นทาง	เพิ่ม pac cli ไปยัง `PATH` ตัวแปรสภาพแวดล้อม ช่วยให้คุณสามารถใช้ pac cli จากงานสคริปต์โดยไม่จําเป็นต้องมีการตั้งค่าเส้นทางด้วยตนเอง
`PowerAppsAdminVersion` `XrmToolingPackageDeploymentVersion` `MicrosoftPowerAppsCheckerVersion` `CrmSdkCoreToolsVersion` เวอร์ชันเครื่องมือ	เวอร์ชันเฉพาะของเครื่องมือที่จะใช้

Power Platform WhoAmI

ตรวจสอบการเชื่อมต่อบริการสภาพแวดล้อมของ Power Platform โดยการเชื่อมต่อและสร้างคำขอ WhoAmI งานนี้มีประโยชน์ในการรวมก่อนหน้าในขั้นตอน เพื่อตรวจสอบการเชื่อมต่อก่อนเริ่มการประมวล

ส่วนย่อย YAML (WhoAmI)

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

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

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

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

พารามิเตอร์ (WhoAmI)

พารามิเตอร์	รายละเอียด
`authenticationType` ชนิดของการรับรองความถูกต้อง	(ไม่บังคับ) ระบุ PowerPlatformEnvironment สำหรับการเชื่อมต่อชื่อผู้ใช้/รหัสผ่าน หรือ PowerPlatformSPN สำหรับการเชื่อมต่อหลักของบริการ/ข้อมูลลับของไคลเอ็นต์ ข้อมูลเพิ่มเติม: โปรดดู `BuildTools.EnvironmentUrl` ภายใต้ สร้างสภาพแวดล้อม Power Platform
`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 หมายเหตุ: วิธีการรับรองความถูกต้องของบริการหลักและชื่อผู้ใช้/รหัสผ่านพร้อมใช้งานสำหรับงานตรวจสอบ สำหรับข้อมูลเพิ่มเติมเกี่ยวกับวิธีการกำหนดค่าบริการหลักที่จะใช้กับงานนี้ ดูที่ กำหนดค่าการเชื่อมต่อบริการหลักสำหรับสภาพแวดล้อม Power Platform
`UseDefaultPACheckerEndpoint` ใช้ตำแหน่งข้อมูลของตัวตรวจสอบ Power Platform เริ่มต้น	โดยค่าเริ่มต้น (จริง) ตำแหน่งทางภูมิศาสตร์ของบริการตัวตรวจสอบจะใช้ภูมิศาสตร์เดียวกันกับสภาพแวดล้อมที่คุณเชื่อมต่อ
`CustomPACheckerEndpoint` จุดสิ้นสุดของตัวตรวจสอบ PAC แบบกำหนดเอง	จำเป็นเมื่อ `UseDefaultPACheckerEndpoint` เป็น เท็จ คุณสามารถระบุภูมิศาสตร์อื่นที่จะใช้ได้ เช่น `https://japan.api.advisor.powerapps.com.` สำหรับรายการภูมิศาสตร์ที่มีอยู่ โปรดดู ใช้ API ตัวตรวจสอบ Power Platform
`FileLocation` ตำแหน่งที่ตั้งของไฟล์ที่จะวิเคราะห์	จำเป็นเมื่ออ้างอิงไฟล์จาก URL ลายเซ็นการเข้าถึงที่ใช้ร่วมกัน (SAS) `sasUriFile`. หมายเหตุ: สิ่งสำคัญคือต้องอ้างอิงไฟล์โซลูชันที่ส่งออก ไม่ใช่ไฟล์ต้นฉบับที่แยกในที่เก็บของคุณ ไฟล์โซลูชันทั้งที่มีการจัดการและไม่มีการจัดการสามารถวิเคราะห์ได้
`FilesToAnalyzeSasUri` ไฟล์ SAS ที่จะวิเคราะห์	จำเป็นเมื่อ `FileLocation` ถูกตั้งค่าเป็น `sasUriFile` ป้อน URI ของ SAS คุณสามารถเพิ่ม SAS URI มากกว่าหนึ่งรายการผ่านรายการที่คั่นด้วยเครื่องหมายจุลภาค (,) หรือเครื่องหมายอัฒภาค (;)
`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 โดยที่ระดับ=สำคัญ, สูง, กลาง, ต่ำ และข้อมูล
`ErrorThreshold` ขีดจำกัดข้อผิดพลาด	กำหนดจำนวนข้อผิดพลาด (>=0) ของระดับที่ระบุซึ่งอนุญาตให้ตัวตรวจสอบส่งผ่านโซลูชันที่กำลังตรวจสอบ
`FailOnPowerAppsCheckerAnalysisError` ล้มเหลวในข้อผิดพลาด	เมื่อเป็น true จะล้มเหลวถ้าการวิเคราะห์ตัวตรวจสอบ Power Apps ถูกส่งกลับเป็น Failed หรือ FinishedWithErrors
`ArtifactDestinationName` ชื่ออาร์ทิแฟกต์ DevOps	ระบุอาร์ทิแฟกต์ Azure สำหรับไฟล์ .sarif ของตัวตรวจสอบ

งานโซลูชัน

ชุดของงานนี้สามารถดำเนินการโซลูชันโดยอัตโนมัติ งานสภาพแวดล้อมที่สรุปไว้ในภายหลังในส่วนนี้ซึ่งสร้าง คัดลอก หรือคืนค่าสภาพแวดล้อม จะเขียนทับการเชื่อมต่อบริการด้วยสภาพแวดล้อมที่สร้างขึ้นใหม่ งานเหล่านี้ทำให้สามารถดำเนินการโซลูชันกับสภาพแวดล้อมที่สร้างขึ้นตามความต้องการ

นำเข้าโซลูชันของ Power Platform

นำเข้าโซลูชันไปยังสภาพแวดล้อมเป้าหมาย

ส่วนย่อย YAML (นำเข้า)

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

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

พารามิเตอร์ (นำเข้า)

พารามิเตอร์	รายละเอียด
`authenticationType` ชนิดของการรับรองความถูกต้อง	(จำเป็นสำหรับ SPN) ระบุ PowerPlatformEnvironment สำหรับการเชื่อมต่อชื่อผู้ใช้/รหัสผ่าน หรือ PowerPlatformSPN สำหรับการเชื่อมต่อหลักของบริการ/ข้อมูลลับของไคลเอ็นต์
`PowerPlatformEnvironment` URL สภาพแวดล้อม Power Platform	จุดสิ้นสุดของบริการที่คุณต้องการนำเข้าโซลูชัน (เช่น `https://powerappsbuildtools.crm.dynamics.com`) กำหนดภายใต้ การเชื่อมต่อบริการ ใน การตั้งค่าโครงการ โดยใช้ชนิดการเชื่อมต่อ Power Platform ข้อมูลเพิ่มเติม: โปรดดู `BuildTools.EnvironmentUrl` ภายใต้ สร้างสภาพแวดล้อม Power Platform
`PowerPlatformSPN` บริการหลักของ Power Platform	จุดสิ้นสุดของบริการที่คุณต้องการนำเข้าโซลูชัน (เช่น `https://powerappsbuildtools.crm.dynamics.com`) กำหนดภายใต้ การเชื่อมต่อบริการ ใน การตั้งค่าโครงการ โดยใช้ชนิดการเชื่อมต่อ Power Platform ข้อมูลเพิ่มเติม: โปรดดู `BuildTools.EnvironmentUrl` ภายใต้ สร้างสภาพแวดล้อม Power Platform
`SolutionInputFile` ไฟล์นำเข้าโซลูชัน	(บังคับ) พาธและชื่อไฟล์ของไฟล์ solution.zip ที่จะนำเข้าสู่สภาพแวดล้อมเป้าหมาย (ตัวอย่างเช่น $(Build.ArtifactStagingDirectory)$(SolutionName).zip) หมายเหตุ: ตัวแปรเป็นวิธีที่สะดวกในการรับข้อมูลบิตที่สำคัญในส่วนต่างๆ ของไปป์ไลน์ ดูที่ ใช้ตัวแปรที่กำหนดไว้ล่วงหน้า สำหรับรายการที่ครอบคลุม
`HoldingSolution` นำเข้าเป็นโซลูชันการครอบครอง	พารามิเตอร์ขั้นสูง (จริง\|เท็จ) ที่ใช้ เมื่อต้องมีการอัปเกรดโซลูชัน พารามิเตอร์นี้จะโฮสต์โซลูชันใน Dataverse แต่ไม่อัปเกรดโซลูชันจนกว่าจะเรียกใช้งาน นำการอัปเกรดโซลูชันไปใช้
`OverwriteUnmanagedCustomizations` เขียนทับการแก้ไข/ปรับปรุงตามคำสั่งที่ไม่มีการจัดการ	ระบุว่าจะเขียนทับการแก้ไขตามคำสั่งที่ไม่มีการจัดการหรือไม่ (จริง\|เท็จ)
`SkipProductUpdateDependencies` ข้ามการขึ้นต่อกันของการอัปเดตผลิตภัณฑ์	ระบุว่าควรข้ามการบังคับใช้การขึ้นต่อกันที่เกี่ยวข้องกับการอัปเดตผลิตภัณฑ์หรือไม่ (จริง\|เท็จ)
`ConvertToManaged` แปลงเป็นที่มีการจัดการ	ล้าสมัย ระบบจะแปลงส่วนประกอบของโซลูชันที่ไม่มีการจัดการให้เป็นโซลูชันที่มีการจัดการเมื่อคุณนำเข้าโซลูชันที่มีการจัดการ
`AsyncOperation` การนำเข้าแบบอะซิงโครนัส	ถ้าเลือก (จริง) การดำเนินการนำเข้าจะถูกดำเนินการแบบอะซิงโครนัส แนะนำให้ใช้สำหรับการแก้ปัญหาที่ใหญ่กว่า เนื่องจากงานนี้จะหมดเวลาโดยอัตโนมัติหลังจาก 4 นาที การเลือกแบบอะซิงโครนัสจะสำรวจและรอจนกว่าจะถึง MaxAsyncWaitTime (จริง\|เท็จ)
`MaxAsyncWaitTime` เวลารอสูงสุด	เวลารอสูงสุดเป็นนาทีสำหรับการดำเนินการแบบอะซิงโครนัส ค่าเริ่มต้นคือ 60 นาที (1 ชั่วโมง) เช่นเดียวกับค่าเริ่มต้นของ Azure DevOps สำหรับงาน
`PublishWorkflows` เริ่มการใช้งานกระบวนการหลังจากนำเข้า	ระบุว่าควรเริ่มการใช้งานกระบวนการใดๆ (เวิร์กโฟลว์) ในโซลูชันหลังจากนำเข้าหรือไม่ (จริง\|เท็จ)
`UseDeploymentSettingsFile` ใช้ไฟล์การตั้งค่าการปรับใช้งาน	สามารถตั้งค่าการอ้างอิงการเชื่อมต่อและค่าตัวแปรสภาพแวดล้อมโดยใช้ไฟล์ การตั้งค่าการปรับใช้งาน (จริง\|เท็จ)
`DeploymentSettingsFile` ไฟล์การตั้งค่าการปรับใช้งาน	(จำเป็นเมื่อ `UseDeploymentSettingsFile`=จริง) พาธและชื่อไฟล์ของไฟล์การตั้งค่าการปรับใช้งาน

เพิ่มส่วนประกอบของโซลูชันของ Power Platform

เพิ่มส่วนประกอบของโซลูชันลงในโซลูชันที่ไม่มีการจัดการ

ส่วนย่อย YAML (เพิ่ม)

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

พารามิเตอร์ (เพิ่ม)

พารามิเตอร์	รายละเอียด
`ComponentId` รหัสของส่วนประกอบของโซลูชัน	ชื่อหรือรหัส Schema ของส่วนประกอบที่จะเพิ่มไปยังโซลูชันเป้าหมาย
`ComponentType` URL สภาพแวดล้อม Power Platform	ค่าที่แสดงถึงส่วนประกอบของโซลูชันที่คุณกำลังเพิ่ม ดู ใช้ชนิดส่วนประกอบที่กำหนดไว้ล่วงหน้า สำหรับรายการที่ครอบคลุมของค่าส่วนประกอบ
`SolutionUniqueName` ชื่อของโซลูชัน	ชื่อเฉพาะของโซลูชัน
`AddRequiredComponents` ส่วนประกอบใดๆ ที่จำเป็นจากโซลูชันอื่นๆ ขึ้นอยู่กับส่วนประกอบของโซลูชัน	(ไม่บังคับ) ระบุว่าคุณควรเพิ่มส่วนประกอบของโซลูชันอื่นๆ ที่จำเป็นสำหรับส่วนประกอบของโซลูชันที่คุณกำลังเพิ่มไปยังโซลูชันที่ไม่มีการจัดการหรือไม่
`Environment` รหัสหรือ URL สภาพแวดล้อม	(ไม่บังคับ) URL สภาพแวดล้อมหรือรหัสของสภาพแวดล้อมเป้าหมาย

ใช้การอัปเกรดโซลูชันของ Power Platform

อัปเกรดโซลูชันที่นำเข้าเป็นโซลูชันการครอบครอง

ส่วนย่อย YAML (อัปเกรด)

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

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

พารามิเตอร์ (อัปเกรด)

พารามิเตอร์	รายละเอียด
`authenticationType` ชนิดของการรับรองความถูกต้อง	(จำเป็นสำหรับ SPN) ระบุ PowerPlatformEnvironment สำหรับการเชื่อมต่อชื่อผู้ใช้/รหัสผ่าน หรือ PowerPlatformSPN สำหรับการเชื่อมต่อหลักของบริการ/ข้อมูลลับของไคลเอ็นต์
`PowerPlatformEnvironment` URL สภาพแวดล้อม Power Platform	จุดสิ้นสุดของบริการที่คุณต้องการอัปเกรดโซลูชัน (เช่น `https://powerappsbuildtools.crm.dynamics.com`) กำหนดภายใต้ การเชื่อมต่อบริการ ใน การตั้งค่าโครงการ โดยใช้ชนิดการเชื่อมต่อ Power Platform ข้อมูลเพิ่มเติม: โปรดดู `BuildTools.EnvironmentUrl` ภายใต้ สร้างสภาพแวดล้อม Power Platform
`PowerPlatformSPN` บริการหลักของ Power Platform	จุดสิ้นสุดของบริการที่คุณต้องการอัปเกรดโซลูชัน (เช่น `https://powerappsbuildtools.crm.dynamics.com`) กำหนดภายใต้ การเชื่อมต่อบริการ ใน การตั้งค่าโครงการ โดยใช้ชนิดการเชื่อมต่อ Power Platform ข้อมูลเพิ่มเติม: โปรดดู `BuildTools.EnvironmentUrl` ภายใต้ สร้างสภาพแวดล้อม Power Platform
`SolutionName` ชื่อโซลูชัน	(จำเป็น) ชื่อของโซลูชันที่จะใช้การอัปเกรด ใช้ ชื่อ โซลูชันเสมอ ไม่ใช่ ชื่อที่แสดง
`AsyncOperation` การอัปเกรดแบบอะซิงโครนัส	ถ้าเลือก (จริง) การดำเนินการอัปเกรดจะถูกดำเนินการเป็นชุดงานแบบอะซิงโครนัส การเลือกแบบอะซิงโครนัสจะสำรวจและรอจนกว่าจะถึง MaxAsyncWaitTime
`MaxAsyncWaitTime` เวลารอสูงสุด	เวลารอสูงสุดเป็นนาทีสำหรับการดำเนินการแบบอะซิงโครนัส ค่าเริ่มต้นคือ 60 นาที (1 ชั่วโมง) เช่นเดียวกับค่าเริ่มต้นของ Azure DevOps สำหรับงาน

หมายเหตุ

ตัวแปรมอบวิธีที่สะดวกในการรับข้อมูลบิตที่สำคัญในส่วนต่าง ๆ ของไปป์ไลน์ ดูที่ ใช้ตัวแปรที่กำหนดไว้ล่วงหน้า สำหรับรายการที่ครอบคลุม คุณสามารถเติมข้อมูลอ้างอิงการเชื่อมต่อและข้อมูลตัวแปรสภาพแวดล้อมล่วงหน้าสำหรับสภาพแวดล้อมเป้าหมายได้ในขณะที่นำเข้าโซลูชันโดยใช้ไฟล์การตั้งค่าการปรับใช้งาน

ข้อมูลเพิ่มเติม: เติมข้อมูลการอ้างอิงการเชื่อมต่อและตัวแปรสภาพแวดล้อมล่วงหน้าสำหรับการปรับใช้งานอัตโนมัติ

ส่งออกโซลูชันของ Power Platform

ส่งออกโซลูชันจากสภาพแวดล้อมต้นทาง

ส่วนย่อย YAML (ส่งออก)

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

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

พารามิเตอร์ (ส่งออก)

พารามิเตอร์	รายละเอียด
`authenticationType` ชนิดของการรับรองความถูกต้อง	(จำเป็นสำหรับ SPN) ระบุ PowerPlatformEnvironment สำหรับการเชื่อมต่อชื่อผู้ใช้/รหัสผ่าน หรือ PowerPlatformSPN สำหรับการเชื่อมต่อหลักของบริการ/ข้อมูลลับของไคลเอ็นต์
`PowerPlatformEnvironment` URL สภาพแวดล้อม Power Platform	จุดสิ้นสุดของบริการที่คุณต้องการอัปเกรดโซลูชัน (เช่น `https://powerappsbuildtools.crm.dynamics.com`) กำหนดภายใต้ การเชื่อมต่อบริการ ใน การตั้งค่าโครงการ โดยใช้ชนิดการเชื่อมต่อ Power Platform ข้อมูลเพิ่มเติม: โปรดดู `BuildTools.EnvironmentUrl` ภายใต้ สร้างสภาพแวดล้อม Power Platform
`PowerPlatformSPN` บริการหลักของ Power Platform	จุดสิ้นสุดของบริการที่คุณต้องการอัปเกรดโซลูชัน (เช่น `https://powerappsbuildtools.crm.dynamics.com`) กำหนดภายใต้ การเชื่อมต่อบริการ ใน การตั้งค่าโครงการ โดยใช้ชนิดการเชื่อมต่อ Power Platform ข้อมูลเพิ่มเติม: โปรดดู `BuildTools.EnvironmentUrl` ภายใต้ สร้างสภาพแวดล้อม Power Platform
`SolutionName` ชื่อโซลูชัน	(จำเป็น) ชื่อของโซลูชันที่จะส่งออก ใช้ ชื่อ โซลูชันเสมอ ไม่ใช่ ชื่อที่แสดง
`SolutionOutputFile` ไฟล์ส่งออกโซลูชัน	(บังคับ) พาธและชื่อไฟล์ของไฟล์ solution.zip ที่จะส่งออกไปยังสภาพแวดล้อมแหล่งข้อมูล (ตัวอย่างเช่น $(Build.ArtifactStagingDirectory)$(SolutionName).zip ) หมายเหตุ: ตัวแปรเป็นวิธีที่สะดวกในการรับข้อมูลบิตที่สำคัญในส่วนต่างๆ ของไปป์ไลน์ ดูที่ ใช้ตัวแปรที่กำหนดไว้ล่วงหน้า สำหรับรายการที่ครอบคลุม
`AsyncOperation` การส่งออกแบบอะซิงโครนัส	ถ้าเลือก (จริง) การดำเนินการส่งออกจะถูกดำเนินการเป็นชุดงานแบบอะซิงโครนัส การเลือกแบบอะซิงโครนัสจะสำรวจและรอจนกว่าจะถึง MaxAsyncWaitTime
`MaxAsyncWaitTime` เวลารอสูงสุด	เวลารอสูงสุดเป็นนาทีสำหรับการดำเนินการแบบอะซิงโครนัส ค่าเริ่มต้นคือ 60 นาที (1 ชั่วโมง) เช่นเดียวกับค่าเริ่มต้นของ Azure DevOps สำหรับงาน
`Managed` ส่งออกเป็นแบบที่มีการจัดการ	ถ้าเลือก (จริง) ส่งออกโซลูชันเป็นโซลูชันที่มีการจัดการ มิฉะนั้น จะส่งออกเป็นโซลูชันที่ไม่มีการจัดการ
`ExportAutoNumberingSettings` ส่งออกการตั้งค่าการกำหนดหมายเลขอัตโนมัติ	ส่งออกการตั้งค่าการกำหนดหมายเลขอัตโนมัติ (จริง\|เท็จ)
`ExportCalendarSettings` ส่งออกการตั้งค่าปฏิทิน	ส่งออกการตั้งค่าปฏิทิน (จริง\|เท็จ)
`ExportCustomizationSettings` ส่งออกการตั้งค่าการแก้ไข/ปรับปรุงตามคำสั่ง	ส่งออกการตั้งค่าการแก้ไข (จริง\|เท็จ)
`ExportEmailTrackingSettings` ส่งออกการตั้งค่าการติดตามอีเมล	ส่งออกการตั้งค่าการติดตามอีเมล (จริง\|เท็จ)
`ExportGeneralSettings` ส่งออกการตั้งค่าทั่วไป	ส่งออกการตั้งค่าทั่วไป (จริง\|เท็จ)
`ExportIsvConfig` ส่งออกการตั้งค่าคอนฟิก ISV	ส่งออกการตั้งค่าคอนฟิก ISV (จริง\|เท็จ)
`ExportMarketingSettings` ส่งออกการตั้งค่าการตลาด	ส่งออกการตั้งค่าการตลาด (จริง\|เท็จ)
`ExportOutlookSynchronizationSettings` ส่งออกการตั้งค่าการซิงค์ Outlook	ส่งออกการตั้งค่าการทำข้อมูลให้ตรงกันสำหรับ Outlook (จริง\|เท็จ)
`ExportRelationshipRoles` ส่งออก Relationship Role	ส่งออกบทบาทความสัมพันธ์ (จริง\|เท็จ)
`ExportSales` ส่งออกการขาย	ส่งออกการขาย (จริง\|เท็จ)

แยกโซลูชันของ Power Platform

นำไฟล์โซลูชันที่ถูกบีบอัดและย่อยไฟล์ไปเป็นไฟล์ XML และไฟล์อื่นๆ หลายไฟล์ เพื่อจะได้อ่านและจัดการไฟล์เหล่านี้ได้โดยง่ายผ่านระบบควบคุมต้นทาง

ส่วนย่อย YAML (แยก)

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

พารามิเตอร์ (แยก)

พารามิเตอร์	รายละเอียด
`SolutionInputFile` ไฟล์นำเข้าโซลูชัน	(บังคับ) พาธและชื่อไฟล์ของไฟล์ solution.zip ที่จะแยก
`SolutionTargetFolder` โฟลเดอร์เป้าหมายเพื่อแยกโซลูชัน	(บังคับ) พาธและโฟลเดอร์เป้าหมายที่คุณต้องการแยกโซลูชันออก
`SolutionType` ชนิดของโซลูชัน	(บังคับ) ชนิดของโซลูชันที่คุณต้องการแยก ตัวเลือกรวมถึง: ไม่มีการจัดการ (แนะนำ) มีการจัดการ และ ทั้งคู่

บรรจุโซลูชันของ Power Platform

แพคโซลูชันที่แสดงในระบบควบคุมต้นทางลงในไฟล์ solution.zip ที่สามารถนำเข้าสู่สภาพแวดล้อมอื่น

ส่วนย่อย YAML (บรรจุ)

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

พารามิเตอร์ (บรรจุ)

พารามิเตอร์	รายละเอียด
`SolutionOutputFile` ไฟล์ส่งออกโซลูชัน	(บังคับ) พาธและชื่อไฟล์ของไฟล์ solution.zip ที่จะแพคโซลูชันเข้าไป
`SolutionSourceFolder` โฟลเดอร์ต้นทางของโซลูชันที่จะแพ็ค	(บังคับ) พาธและโฟลเดอร์ต้นทางของโซลูชันที่จะแพค
`SolutionType` ชนิดของโซลูชัน	(บังคับ) ชนิดของโซลูชันที่คุณต้องการแพค ตัวเลือกได้แก่: จัดการ (ที่แนะนำ) ไม่มีการจัดการ และ ทั้งคู่

ลบโซลูชันของ Power Platform

ลบโซลูชันในสภาพแวดล้อมเป้าหมาย

ส่วนย่อย YAML (ลบ)

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

พารามิเตอร์ (ลบ)

พารามิเตอร์	รายละเอียด
`authenticationType` ชนิดของการรับรองความถูกต้อง	(จำเป็นสำหรับ SPN) ระบุ PowerPlatformEnvironment สำหรับการเชื่อมต่อชื่อผู้ใช้/รหัสผ่าน หรือ PowerPlatformSPN สำหรับการเชื่อมต่อหลักของบริการ/ข้อมูลลับของไคลเอ็นต์
`PowerPlatformEnvironment` URL สภาพแวดล้อม Power Platform	จุดสิ้นสุดของบริการที่คุณต้องการลบโซลูชัน (เช่น `https://powerappsbuildtools.crm.dynamics.com`) กำหนดภายใต้ การเชื่อมต่อบริการ ใน การตั้งค่าโครงการ โดยใช้ชนิดการเชื่อมต่อ Power Platform ข้อมูลเพิ่มเติม: โปรดดู `BuildTools.EnvironmentUrl` ภายใต้ สร้างสภาพแวดล้อม Power Platform
`PowerPlatformSPN` บริการหลักของ Power Platform	จุดสิ้นสุดของบริการที่คุณต้องการลบโซลูชัน (เช่น `https://powerappsbuildtools.crm.dynamics.com`) กำหนดภายใต้ การเชื่อมต่อบริการ ใน การตั้งค่าโครงการ โดยใช้ชนิดการเชื่อมต่อ Power Platform ข้อมูลเพิ่มเติม: โปรดดู `BuildTools.EnvironmentUrl` ภายใต้ สร้างสภาพแวดล้อม Power Platform
`SolutionName` ชื่อโซลูชัน	(ต้องระบุ) ชื่อของโซลูชันที่จะลบ ใช้ ชื่อ โซลูชันเสมอ ไม่ใช่ ชื่อที่แสดง

เผยแพร่การปรับแต่งของ Power Platform

เผยแพร่การกำหนดเองทั้งหมดในสภาพแวดล้อม

ส่วนย่อย YAML (เผยแพร่)

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

พารามิเตอร์ (เผยแพร่)

พารามิเตอร์	รายละเอียด
`authenticationType` ชนิดของการรับรองความถูกต้อง	(จำเป็นสำหรับ SPN) ระบุ PowerPlatformEnvironment สำหรับการเชื่อมต่อชื่อผู้ใช้/รหัสผ่าน หรือ PowerPlatformSPN สำหรับการเชื่อมต่อหลักของบริการ/ข้อมูลลับของไคลเอ็นต์
`PowerPlatformEnvironment` URL สภาพแวดล้อม Power Platform	จุดสิ้นสุดของบริการที่คุณต้องการเผยแพร่การแก้ไข/ปรับปรุงตามคำสั่ง (เช่น `https://powerappsbuildtools.crm.dynamics.com`) กำหนดภายใต้ การเชื่อมต่อบริการ ใน การตั้งค่าโครงการ โดยใช้ชนิดการเชื่อมต่อ Power Platform ข้อมูลเพิ่มเติม: โปรดดู `BuildTools.EnvironmentUrl` ภายใต้ สร้างสภาพแวดล้อม Power Platform
`PowerPlatformSPN` บริการหลักของ Power Platform	จุดสิ้นสุดของบริการที่คุณต้องการเผยแพร่การแก้ไข/ปรับปรุงตามคำสั่ง (เช่น `https://powerappsbuildtools.crm.dynamics.com`) กำหนดภายใต้ การเชื่อมต่อบริการ ใน การตั้งค่าโครงการ โดยใช้ชนิดการเชื่อมต่อ Power Platform ข้อมูลเพิ่มเติม: โปรดดู `BuildTools.EnvironmentUrl` ภายใต้ สร้างสภาพแวดล้อม Power Platform

ตั้งค่าเวอร์ชันของโซลูชันของ Power Platform

อัปเดตเวอร์ชันของโซลูชัน

ส่วนย่อย YAML (เวอร์ชัน)

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

พารามิเตอร์ (เวอร์ชัน)

พารามิเตอร์	รายละเอียด
`authenticationType` ชนิดของการรับรองความถูกต้อง	(จำเป็นสำหรับ SPN) ระบุ PowerPlatformEnvironment สำหรับการเชื่อมต่อชื่อผู้ใช้/รหัสผ่าน หรือ PowerPlatformSPN สำหรับการเชื่อมต่อหลักของบริการ/ข้อมูลลับของไคลเอ็นต์
`PowerPlatformEnvironment` URL สภาพแวดล้อม Power Platform	จุดสิ้นสุดของบริการที่คุณต้องการตั้งค่าเวอร์ชันโซลูชัน (เช่น `https://powerappsbuildtools.crm.dynamics.com`) กำหนดภายใต้ การเชื่อมต่อบริการ ใน การตั้งค่าโครงการ โดยใช้ชนิดการเชื่อมต่อ Power Platform ข้อมูลเพิ่มเติม: โปรดดู `BuildTools.EnvironmentUrl` ภายใต้ สร้างสภาพแวดล้อม Power Platform
`PowerPlatformSPN` บริการหลักของ Power Platform	จุดสิ้นสุดของบริการที่คุณต้องการตั้งค่าเวอร์ชันโซลูชัน (เช่น `https://powerappsbuildtools.crm.dynamics.com`) กำหนดภายใต้ การเชื่อมต่อบริการ ใน การตั้งค่าโครงการ โดยใช้ชนิดการเชื่อมต่อ Power Platform ข้อมูลเพิ่มเติม: โปรดดู `BuildTools.EnvironmentUrl` ภายใต้ สร้างสภาพแวดล้อม Power Platform
`SolutionName` ชื่อโซลูชัน	(ต้องระบุ) ชื่อของโซลูชันที่จะตั้งค่าเวอร์ชันให้ ใช้ ชื่อ โซลูชันเสมอ ไม่ใช่ ชื่อที่แสดง
`SolutionVersionNumber` หมายเลขเวอร์ชันของโซลูชัน	(จำเป็น) หมายเลขเวอร์ชันที่คุณต้องการตั้งค่า

โปรดทราบว่าในขณะที่สามารถเข้ารหัสหมายเลขรุ่นในไปป์ไลน์ได้ ขอแนะนำให้ใช้ไปป์ไลน์ Azure DevOps เช่น BuildId ซึ่งจะมีตัวเลือกในการกำหนดรูปแบบที่แน่นอนของหมายเลขเวอร์ชันภายใต้แท็บ "ตัวเลือก" ตัวอย่างเช่น: $(Year:yyyy)-$(Month:MM)-$(Day:dd)-$(rev:rr)-3

จากนั้นคำจำกัดความนี้สามารถใช้ในงาน ตั้งค่าเวอร์ชันของโซลูชัน โดยตั้งค่าคุณสมบัติ Version Number ด้วย: $(Build.BuildId) แทนที่จะเข้ารหัสยาก 20200824.0.0.2

อีกวิธีหนึ่งคือ ผลลัพธ์สคริปต์งานอินไลน์ของ powershell $(Get-Date -Format yyyy.MM.dd.HHmm) ที่ตั้งค่าเป็นตัวแปรว่างที่ชื่อ SolutionVersion เป็น Write-Host ("##vso[task.setvariable variable=SolutionVersion;]$version") ตั้งค่าเวอร์ชันโซลูชันเป็น $(SolutionVersion)

ตั้งค่าตัวแปรการเชื่อมต่อของ Power Platform

PowerPlatformSetConnectionVariables.BuildTools.*ตั้งค่าตัวแปรเพื่อให้งานสคริปต์แบบกําหนดเองสามารถเข้าถึงการใช้การเชื่อมต่อบริการเป็นแหล่งความจริงเพียงแหล่งเดียว

มีการตั้งค่าตัวแปรต่อไปนี้:

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

ส่วนย่อย YAML (SetConnectionVariables)

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

พารามิเตอร์ (SetConnectionVariables)

พารามิเตอร์	รายละเอียด
`authenticationType` ชนิดของการรับรองความถูกต้อง	(จำเป็นสำหรับ SPN) ระบุ PowerPlatformEnvironment สำหรับการเชื่อมต่อชื่อผู้ใช้/รหัสผ่าน หรือ PowerPlatformSPN สำหรับการเชื่อมต่อหลักของบริการ/ข้อมูลลับของไคลเอ็นต์
`PowerPlatformSPN` บริการหลักของ Power Platform	จุดสิ้นสุดของบริการที่คุณต้องการตั้งค่าตัวแปรการเชื่อมต่อ กำหนดภายใต้ การเชื่อมต่อบริการ ใน การตั้งค่าโครงการ โดยใช้ชนิดการเชื่อมต่อ Power Platform ข้อมูลเพิ่มเติม: โปรดดู `BuildTools.EnvironmentUrl` ภายใต้ สร้างสภาพแวดล้อม Power Platform
`timeoutInMinutes` การหมดเวลา	ระบุเวลาสูงสุดเป็นนาทีที่งานได้รับอนุญาตให้ดำเนินการก่อนที่จะถูกยกเลิกโดยเซิร์ฟเวอร์ ค่าศูนย์บ่งชี้ถึงการหมดเวลาที่ไม่สิ้นสุด
`retryCountOnTaskFailure` จำนวนการลองใหม่หากงานล้มเหลว	ระบุจำนวนการลองใหม่สำหรับงานนี้ที่จะเกิดขึ้นในกรณีที่งานล้มเหลว ไม่รองรับงานที่ไม่ใช้ตัวแทน
`ApplicationId` รหัสแอปพลิเคชันสำหรับการเข้าสู่ระบบ	(จำเป็นสำหรับชื่อผู้ใช้/รหัสผ่าน) รหัสแอปพลิเคชันที่จะใช้ในการเข้าสู่ระบบ (ดูหมายเหตุเพิ่มเติมด้านล่าง)
`RedirectUri` เปลี่ยนเส้นทาง URI ของแอปเฉพาะ	(จำเป็นสำหรับชื่อผู้ใช้/รหัสผ่าน) เปลี่ยนเส้นทาง URI ของแอปที่ระบุ จำเป็นเมื่อระบุรหัสแอป (ดูหมายเหตุเพิ่มเติมด้านล่าง)

หมายเหตุ

เมื่อใช้ประเภทการตรวจสอบสิทธิ์ชื่อผู้ใช้/รหัสผ่าน จะต้องใช้รหัสแอปพลิเคชันและ Uri การเปลี่ยนเส้นทาง เอกสาร รับรองความถูกต้อง OAuth นี้มีคำอธิบายว่าเหตุใดคุณจึงต้องสร้างการลงทะเบียนแอปเพื่อรับรองความถูกต้อง Dataverse เมื่อคุณเชื่อมต่อโดยใช้การรับรองความถูกต้องด้วยชื่อผู้ใช้/รหัสผ่าน การเชื่อมต่อจะทำหน้าที่เป็นแอปพลิเคชันที่เชื่อมต่อกับ Dataverse ในนามของผู้ใช้

ปรับใช้แพ็กเกจของ Power Platform

ปรับใช้แพ็กเกจกับสภาพแวดล้อม การปรับใช้ แพ็กเกจ เทียบกับกับไฟล์โซลูชันไฟล์เดียวแล้ว ให้คุณมีตัวเลือกในการปรับใช้โซลูชัน ข้อมูล และรหัสหลายอย่างในสภาพแวดล้อม

ส่วนย่อย YAML (ปรับใช้)

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

พารามิเตอร์ (ปรับใช้)

พารามิเตอร์	รายละเอียด
`authenticationType` ชนิดของการรับรองความถูกต้อง	(จำเป็นสำหรับ SPN) ระบุ PowerPlatformEnvironment สำหรับการเชื่อมต่อชื่อผู้ใช้/รหัสผ่าน หรือ PowerPlatformSPN สำหรับการเชื่อมต่อหลักของบริการ/ข้อมูลลับของไคลเอ็นต์
`PowerPlatformEnvironment` URL สภาพแวดล้อม Power Platform	จุดสิ้นสุดของบริการที่คุณต้องการปรับใช้แพคเกจ (เช่น `https://powerappsbuildtools.crm.dynamics.com`) กำหนดภายใต้ การเชื่อมต่อบริการ ใน การตั้งค่าโครงการ โดยใช้ชนิดการเชื่อมต่อ Power Platform ข้อมูลเพิ่มเติม: โปรดดู `BuildTools.EnvironmentUrl` ภายใต้ สร้างสภาพแวดล้อม Power Platform
`PowerPlatformSPN` บริการหลักของ Power Platform	จุดสิ้นสุดของบริการที่คุณต้องการปรับใช้แพคเกจ (เช่น `https://powerappsbuildtools.crm.dynamics.com`) กำหนดภายใต้ การเชื่อมต่อบริการ ใน การตั้งค่าโครงการ โดยใช้ชนิดการเชื่อมต่อ Power Platform ข้อมูลเพิ่มเติม: โปรดดู `BuildTools.EnvironmentUrl` ภายใต้ สร้างสภาพแวดล้อม Power Platform
`PackageFile` ไฟล์แพ็กเกจ	(ต้องระบุ) พาธและชื่อไฟล์ของแอสเซมบลีไฟล์แพคเกจ (.dll)
`MaxAsyncWaitTime` เวลารอสูงสุด	เวลารอสูงสุดเป็นนาทีสำหรับการดำเนินการแบบอะซิงโครนัส ค่าเริ่มต้นคือ 60 นาที (1 ชั่วโมง) เช่นเดียวกับค่าเริ่มต้นของ 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` ชนิดของสภาพแวดล้อม	(จำเป็น) ประเภทของอินสแตนซ์ที่จะใช้งาน ตัวเลือกคือ Sandbox, การผลิต, การทดลองใช้ และ SubscriptionBasedTrial
`AppsTemplate` แอป	สำหรับชนิดสภาพแวดล้อมที่ไม่ใช่รุ่นทดลองใช้ แอปที่รองรับ ได้แก่ D365_CustomerService, D365_FieldService, D365_ProjectServiceAutomation และ D365_Sales
`CurrencyName` สกุลเงิน	(จำเป็น) สกุลเงินฐานสำหรับสภาพแวดล้อมที่สร้างขึ้น ไม่สามารถอัปเดตสกุลเงินได้ หลังจากที่สร้างสภาพแวดล้อมแล้ว
`LanguageName` Language	(จำเป็น) ภาษาพื้นฐานในสภาพแวดล้อม
`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 หรือ MinimalCopy
`OverrideFriendlyName` แทนที่ชื่อที่เรียกง่าย	เปลี่ยนชื่อที่เรียกง่ายของสภาพแวดล้อมเป้าหมายเป็นชื่ออื่น (จริง\|เท็จ)
`FriendlyName` ชื่อที่เรียกง่าย	ชื่อที่เรียกง่ายของสภาพแวดล้อมเป้าหมาย
`SkipAuditData` SkipAuditData	ข้ามข้อมูลการตรวจสอบการตรวจสอบระหว่างการคัดลอกหรือไม่ (จริง\|เท็จ)
`MaxAsyncWaitTime` เวลารอสูงสุด	เวลารอสูงสุดเป็นนาทีสำหรับการดำเนินการแบบอะซิงโครนัส ค่าเริ่มต้นคือ 60 นาที (1 ชั่วโมง) เช่นเดียวกับค่าเริ่มต้นของ Azure DevOps สำหรับงาน

คืนค่าสภาพแวดล้อมของ Power Platform

คืนค่าสภาพแวดล้อมเป็นการสำรองข้อมูลที่กำหนด

ส่วนย่อย YAML (Restore-env)

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

พารามิเตอร์ (Restore-env)

พารามิเตอร์	รายละเอียด
`authenticationType` ชนิดของการรับรองความถูกต้อง	(จำเป็นสำหรับ SPN) ระบุ PowerPlatformEnvironment สำหรับการเชื่อมต่อชื่อผู้ใช้/รหัสผ่าน หรือ PowerPlatformSPN สำหรับการเชื่อมต่อหลักของบริการ/ข้อมูลลับของไคลเอ็นต์
`PowerPlatformEnvironment` URL สภาพแวดล้อม Power Platform	จุดสิ้นสุดของการบริการสำหรับสภาพแวดล้อมต้นทางที่คุณต้องการคืนค่า (เช่น `https://powerappsbuildtools.crm.dynamics.com`) กำหนดภายใต้ การเชื่อมต่อบริการ ใน การตั้งค่าโครงการ โดยใช้ชนิดการเชื่อมต่อ Power Platform
`PowerPlatformSPN` บริการหลักของ Power Platform	จุดสิ้นสุดของการบริการสำหรับสภาพแวดล้อมต้นทางที่คุณต้องการคืนค่า (เช่น `https://powerappsbuildtools.crm.dynamics.com`) กำหนดภายใต้ การเชื่อมต่อบริการ ใน การตั้งค่าโครงการ โดยใช้ชนิดการเชื่อมต่อ Power Platform
`RestoreLatestBackup` การสำรองข้อมูลล่าสุดที่จะคืนค่า	ว่าจะคืนค่าข้อมูลสำรองล่าสุดหรือให้ RestoreTimeStamp (จริง\|เท็จ)
`RestoreTimeStamp` วันที่และเวลาของการสำรองข้อมูล	วันที่และเวลาของสำเนาสำรองในรูปแบบ 'ดด/วว/ปปปป ชช: นน' หรือสตริง 'ล่าสุด'
`TargetEnvironmentUrl` URL สภาพแวดล้อมเป้าหมาย	(จำเป็น) URL สำหรับสภาพแวดล้อมเป้าหมายที่คุณต้องการคืนค่า
`FriendlyName` ชื่อของสภาพแวดล้อมที่คืนค่า	ชื่อ (ที่เป็นตัวเลือก) ของสภาพแวดล้อมที่คืนค่า
`DisableAdminMode` ปิดใช้งานโหมดการจัดการ	กำหนดว่าจะปิดใช้งานโหมดการจัดการหรือไม่ (จริง\|เท็จ)

ส่งออกข้อมูล Dataverse

ส่งออกข้อมูลจากสภาพแวดล้อมที่มีเค้าร่างที่กำหนด

ส่วนย่อย YAML (exportdata-env)

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

พารามิเตอร์ (exportdata-env)

พารามิเตอร์	รายละเอียด
`authenticationType` ชนิดของการรับรองความถูกต้อง	(จำเป็นสำหรับ SPN) ระบุ PowerPlatformEnvironment สำหรับการเชื่อมต่อชื่อผู้ใช้/รหัสผ่าน หรือ PowerPlatformSPN สำหรับการเชื่อมต่อหลักของบริการ/ข้อมูลลับของไคลเอ็นต์
`PowerPlatformSPN` บริการหลักของ Power Platform	ปลายทางการบริการสำหรับสภาพแวดล้อมที่คุณต้องการส่งออกข้อมูล (เช่น `https://powerappsbuildtools.crm.dynamics.com`) กำหนดภายใต้ การเชื่อมต่อบริการ ใน การตั้งค่าโครงการ โดยใช้ชนิดการเชื่อมต่อ Power Platform
`SchemaFile` ชื่อไฟล์ XML เค้าร่าง	ชื่อไฟล์ XML เค้าร่าง สามารถสร้างได้โดยใช้ Configuration Migration Tool
`DataFile` ชื่อไฟล์ข้อมูล	ชื่อไฟล์สำหรับข้อมูลที่จะส่งออก (ไฟล์ zip)
`Overwrite` การเขียนทับเนื้อหา	เนื้อหาเว็บไซต์ Power Pages ที่จะเขียนทับ (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 Management

งานสำหรับการทำงานกับเว็บไซต์ 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` รหัสเว็บไซต์พอร์ทัล	ID เว็บไซต์ 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 (พรีวิว)

งานเหล่านี้จะดำเนินการกับแค็ตตาล็อกใน Power Platform และรวมถึงสิ่งต่อไปนี้

หมายเหตุ

ขณะนี้ งานในแค็ตตาล็อกสำหรับ Power Platform เป็นรุ่น พรีวิว

ติดตั้งรายการแค็ตตาล็อก

ติดตั้งรายการ catalog ในสภาพแวดล้อมเป้าหมาย

พารามิเตอร์	รายละเอียด
`authenticationType` ชนิดของการรับรองความถูกต้อง	(จำเป็นสำหรับ SPN) ระบุ PowerPlatformEnvironment สำหรับการเชื่อมต่อชื่อผู้ใช้/รหัสผ่าน หรือ PowerPlatformSPN สำหรับการเชื่อมต่อหลักของบริการ/ข้อมูลลับของไคลเอ็นต์
`PowerPlatformSPN` บริการหลักของ Power Platform	ปลายทางการบริการสำหรับสภาพแวดล้อมที่คุณต้องการอัปโหลดข้อมูล (เช่น `https://powerappsbuildtools.crm.dynamics.com`) กำหนดภายใต้ การเชื่อมต่อบริการ ใน การตั้งค่าโครงการ โดยใช้ชนิดการเชื่อมต่อ Power Platform
`Environment` URL สภาพแวดล้อมเป้าหมาย	(จำเป็น) URL สภาพแวดล้อมที่กำหนดเป้าหมายงานนี้
`CatalogItemId` รหัสรายการแค็ตตาล็อกที่จะติดตั้ง	(จำเป็น) รายการแค็ตตาล็อกที่จะติดตั้งบนสภาพแวดล้อมเป้าหมาย
`TargetEnvironmentUrl` URL สภาพแวดล้อมเป้าหมาย	(จำเป็น) URL ของสภาพแวดล้อมเป้าหมายสำหรับการติดตั้งรายการแค็ตตาล็อก (เช่น "https://YourOrg.crm.dynamics.com")
`PollStatus` ตรวจสอบสถานะโพล	(ไม่บังคับ) โพลเพื่อตรวจสอบสถานะคำขอของคุณ (จริง\|เท็จ)

พารามิเตอร์ (catalog-install)

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

ส่งการอนุมัติแค็ตตาล็อก

ส่งคำขออนุมัติ catalog

พารามิเตอร์	รายละเอียด
`authenticationType` ชนิดของการรับรองความถูกต้อง	(จำเป็นสำหรับ SPN) ระบุ PowerPlatformEnvironment สำหรับการเชื่อมต่อชื่อผู้ใช้/รหัสผ่าน หรือ PowerPlatformSPN สำหรับการเชื่อมต่อหลักของบริการ/ข้อมูลลับของไคลเอ็นต์
`PowerPlatformSPN` บริการหลักของ Power Platform	ปลายทางการบริการสำหรับสภาพแวดล้อมที่คุณต้องการอัปโหลดข้อมูล (เช่น "https://powerappsbuildtools.crm.dynamics.com") กำหนดภายใต้ การเชื่อมต่อบริการ ใน การตั้งค่าโครงการ โดยใช้ชนิดการเชื่อมต่อ Power Platform
`Environment` URL สภาพแวดล้อมเป้าหมาย	(จำเป็น) URL สภาพแวดล้อมที่กำหนดเป้าหมายงานนี้
`CatalogSubmissionFile` ไฟล์การส่งแค็ตตาล็อก	(จำเป็น) ระบุพาธและชื่อไฟล์ของไฟล์การส่งแค็ตตาล็อก
`UsePackageSolutionZipFile` ชนิดไฟล์	ชนิดไฟล์: ไฟล์ zip แพคเกจหรือโซลูชัน
`SolutionZipFile` ชื่อไฟล์ zip ของโซลูชัน	ระบุพาธและชื่อไฟล์ของไฟล์ zip ของโซลูชัน
`PollStatus` ตรวจสอบสถานะโพล	(ไม่บังคับ) โพลเพื่อตรวจสอบสถานะคำขอของคุณ (จริง\|เท็จ)

พารามิเตอร์ (catalog-submit)

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

สถานะคำขอแค็ตตาล็อก

รับสถานะของคำขอติดตั้ง/ส่งแค็ตตาล็อก

พารามิเตอร์	รายละเอียด
`authenticationType` ชนิดของการรับรองความถูกต้อง	(จำเป็นสำหรับ SPN) ระบุ PowerPlatformEnvironment สำหรับการเชื่อมต่อชื่อผู้ใช้/รหัสผ่าน หรือ PowerPlatformSPN สำหรับการเชื่อมต่อหลักของบริการ/ข้อมูลลับของไคลเอ็นต์
`PowerPlatformSPN` บริการหลักของ Power Platform	ปลายทางการบริการสำหรับสภาพแวดล้อมที่คุณต้องการอัปโหลดข้อมูล (เช่น "https://powerappsbuildtools.crm.dynamics.com") กำหนดภายใต้ การเชื่อมต่อบริการ ใน การตั้งค่าโครงการ โดยใช้ชนิดการเชื่อมต่อ Power Platform
`Environment` URL สภาพแวดล้อมเป้าหมาย	(จำเป็น) URL สภาพแวดล้อมที่กำหนดเป้าหมายงานนี้
`TrackingId` รหัสการติดตามคำขอ	(จำเป็น) รหัสการติดตามคำขอ
`RequestType` ชนิดคำขอ	(จำเป็น) ชนิดคำขอ (ค่า: ติดตั้ง \| ส่ง)

พารามิเตอร์ (catalog-status)

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

ไปป์ไลน์การสร้างและการปล่อย

ตอนนี้เราได้ระบุสิ่งที่สามารถทำได้โดยใช้เครื่องมือสร้าง ลองมาดูกันว่าคุณอาจใช้เครื่องมือเหล่านี้กับไปป์ไลน์การสร้างและการปล่อยของคุณได้อย่างไร ภาพรวมแนวคิดแสดงอยู่ด้านล่าง ตอนนี้เรามาดูรายละเอียดของการใช้งานไปป์ไลน์ โดยใช้งานเครื่องมือการสร้างในส่วนย่อยที่ตามมา

หากต้องการเรียนรู้เพิ่มเติมเกี่ยวกับการสร้างไปป์ไลน์เหล่านี้ และทำการเขียนไปป์ไลน์จริงโดยใช้ Microsoft Power Platform Build Tools ดำเนินการ ห้องปฏิบัติการ Build Tools ให้เสร็จสมบูรณ์ ซึ่งคุณสามารถดาวน์โหลดได้จาก GitHub

ข้อมูลเพิ่มเติมเกี่ยวกับไปป์ไลน์ Azure: ใช้ไปป์ไลน์ Azure

สร้างไปป์ไลน์: ส่งออกโซลูชันจากสภาพแวดล้อมการพัฒนา (DEV)

รูปต่อไปนี้แสดงงานเครื่องมือสร้าง ที่คุณอาจเพิ่มไปยังไปป์ไลน์ที่ส่งออกโซลูชันจากสภาพแวดล้อมการพัฒนา

ส่งออกโซลูชันจากสภาพแวดล้อมการพัฒนา (DEV)

สร้างไปป์ไลน์: สร้างโซลูชันที่มีการจัดการ

รูปต่อไปนี้แสดงงานเครื่องมือสร้าง ที่คุณอาจเพิ่มไปยังไปป์ไลน์ที่สร้างโซลูชันที่มีการจัดการ

สร้างโซลูชันที่มีการจัดการ

ไปป์ไลน์การปล่อย: ปรับใช้กับสภาพแวดล้อมการใช้งานจริง (PROD)

รูปต่อไปนี้แสดงงานเครื่องมือสร้าง ที่คุณอาจเพิ่มไปยังไปป์ไลน์ที่ปรับใช้กับสภาพแวดล้อมการใช้งานจริง

ปรับใช้กับสภาพแวดล้อมการใช้งานจริง (PROD)

ดูเพิ่มเติม

Microsoft Power Platform Build Tools สำหรับ Azure DevOps

คำติชม

หน้านี้มีประโยชน์หรือไม่

Last updated on 2025-06-26

แชร์ผ่าน

งานของ Microsoft Power Platform Build Tools

งานตัวช่วย

ตัวติดตั้งเครื่องมือ Power Platform

ส่วนย่อย YAML (ตัวติดตั้ง)

พารามิเตอร์ (ตัวติดตั้ง)

Power Platform WhoAmI

ส่วนย่อย YAML (WhoAmI)

พารามิเตอร์ (WhoAmI)

การตรวจสอบคุณภาพ

ตัวตรวจสอบของ 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 (เวอร์ชัน)

พารามิเตอร์ (เวอร์ชัน)

ตั้งค่าตัวแปรการเชื่อมต่อของ 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 Management

ดาวน์โหลด PAPortal ของ Power Platform

ส่วนย่อย YAML (download-paportal)

พารามิเตอร์ (download-paportal)

อัปโหลด PAPortal ของ Power Platform