pac package

คําสั่งสําหรับการทํางานกับโครงการแพคเกจ Dataverse

คำสั่ง

คำสั่ง	คำอธิบาย
pac package add-external-package	เพิ่มแพคเกจที่อยู่ภายนอกไปยังระบบโซลูชัน Dataverse ไปยังโครงการแพคเกจ Package Deployer
pac package add-reference	เพิ่มการอ้างอิงไปยังโครงการโซลูชัน Dataverse
pac package add-solution	เพิ่มไฟล์โซลูชัน Dataverse จัดทําสําเร็จไปยังโครงการแพคเกจ Package Deployer Package
pac package compile	(ตัวอย่าง) คอมไพล์แพคเกจ ด้วย --package-type erp จะคอมไพล์แบบจําลอง X++ โดยใช้ xppc.exe จาก SDK ที่ติดตั้งและสร้าง ZIP ที่ปรับใช้ต่อแบบจําลอง
pac package db-sync	(ตัวอย่าง) ซิงโครไนซ์ฐานข้อมูลแอปพลิเคชันการเงินและการปฏิบัติการกับ Dataverse
pac package deploy	ปรับใช้แพคเกจกับ Dataverse
pac package init	เตรียมใช้งานไดเรกทอรีด้วยโครงการแพคเกจ Dataverse ใหม่
pac package show	แสดงรายละเอียดของแพคเกจ Dataverse

pac package add-external-package

เพิ่มแพคเกจที่อยู่ภายนอกไปยังระบบโซลูชัน Dataverse ไปยังโครงการแพคเกจ Package Deployer

พารามิเตอร์ที่จําเป็นสําหรับ package add-external-package

< ค 0 />< ค 1 />

ชนิดของแพคเกจที่ถูกเพิ่ม ตัวอย่างเช่น: 'xpp' สําหรับแพคเกจ FnO

< ค 0 />< ค 1 />

เส้นทางไปยังแพคเกจภายนอก

พารามิเตอร์ที่เลือกได้สําหรับ package add-external-package

--import-order

จํานวนเต็มที่ระบุลําดับการแทรกรายการนี้ลงในไฟล์ ImportConfig.xml สุดท้ายในเวลาที่สร้าง จํานวนลบจะถูกแทรกก่อนองค์ประกอบที่มีอยู่ มีการเพิ่มจํานวนบวกหลังจากองค์ประกอบที่มีอยู่

< ค 0 />< ค 1 />

เพิ่มรายการไปยังไฟล์โครงการแม้ว่าไฟล์จะไม่มีอยู่หรือดูเหมือนไม่ถูกต้อง หมายเหตุ: การใช้สิ่งนี้ไม่มีผลต่อการตรวจสอบความถูกต้องใด ๆ ที่ดําเนินการโดย MSBuild

พารามิเตอร์นี้ไม่จําเป็นต้องมีค่า มันเป็นการสลับ

pac package add-reference

เพิ่มการอ้างอิงไปยังโครงการโซลูชัน Dataverse

ตัวอย่าง

pac package add-reference --path c:\Users\Downloads\SampleSolution

พารามิเตอร์ที่จําเป็นสําหรับ package add-reference

< ค 0 />< ค 1 />

เส้นทางไปยังโครงการโซลูชัน Dataverse ที่อ้างอิง

พารามิเตอร์ที่เลือกได้สําหรับ package add-reference

--dependency-overrides

รายการคั่นด้วยเครื่องหมายอัฒภาคของการแทนที่ ค่านี้จะแทนที่ข้อมูลการขึ้นต่อกันใด ๆ ที่เข้ารหัสไว้ในเมตาดาต้าของโซลูชัน การแทนที่แต่ละครั้งควรอยู่ในรูปแบบ: <uniquename>:<minVersion>:<maxVersion> ในกรณีที่ minVersion และ maxVersion เป็นตัวเลือกแต่ควรอยู่ในไวยากรณ์รูปแบบเวอร์ชัน .NET

หมายเหตุ: ใช้รายการคั่นด้วยเครื่องหมายอัฒภาคของการแทนที่การขึ้นต่อกันของรูปแบบ<ไม่ซ้ํากัน>:<minVersion>:<maxVersion>

--import-mode

ระบุโหมดที่จําเป็นอย่างชัดเจนเมื่อนําเข้าโซลูชันนี้

ใช้หนึ่งในค่าเหล่านี้:

• sync
• async

--import-order

จํานวนเต็มที่ระบุลําดับการแทรกรายการนี้ลงในไฟล์ ImportConfig.xml สุดท้ายในเวลาที่สร้าง จํานวนลบจะถูกแทรกก่อนองค์ประกอบที่มีอยู่ มีการเพิ่มจํานวนบวกหลังจากองค์ประกอบที่มีอยู่

--missing-dependency-behavior

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

ใช้หนึ่งในค่าเหล่านี้:

• skip
• fault

--overwrite-unmanaged-customizations

ระบุอย่างชัดเจนว่าจะเขียนทับการกําหนดค่าที่ไม่มีการจัดการเมื่อมีการนําเข้าโซลูชันนี้หรือไม่

ใช้หนึ่งในค่าเหล่านี้:

• true
• false

--publish-workflows-activate-plugins

ระบุอย่างชัดเจนว่าจะเผยแพร่เวิร์กโฟลว์และเปิดใช้งานปลั๊กอินเมื่อมีการนําเข้าโซลูชันนี้หรือไม่

ใช้หนึ่งในค่าเหล่านี้:

• true
• false

pac package add-solution

เพิ่มไฟล์โซลูชัน Dataverse จัดทําสําเร็จไปยังโครงการแพคเกจ Package Deployer Package

พารามิเตอร์ที่จําเป็นสําหรับ package add-solution

< ค 0 />< ค 1 />

เส้นทางไปยังไฟล์โซลูชัน Dataverse ไฟล์ต้องเป็นไฟล์ ZIP ที่บีบอัด

พารามิเตอร์ที่เลือกได้สําหรับ package add-solution

--dependency-overrides

รายการคั่นด้วยเครื่องหมายอัฒภาคของการแทนที่ ค่านี้จะแทนที่ข้อมูลการขึ้นต่อกันใด ๆ ที่เข้ารหัสไว้ในเมตาดาต้าของโซลูชัน การแทนที่แต่ละครั้งควรอยู่ในรูปแบบ: <uniquename>:<minVersion>:<maxVersion> ในกรณีที่ minVersion และ maxVersion เป็นตัวเลือกแต่ควรอยู่ในไวยากรณ์รูปแบบเวอร์ชัน .NET

หมายเหตุ: ใช้รายการคั่นด้วยเครื่องหมายอัฒภาคของการแทนที่การขึ้นต่อกันของรูปแบบ<ไม่ซ้ํากัน>:<minVersion>:<maxVersion>

--import-mode

ระบุโหมดที่จําเป็นอย่างชัดเจนเมื่อนําเข้าโซลูชันนี้

ใช้หนึ่งในค่าเหล่านี้:

• sync
• async

--import-order

จํานวนเต็มที่ระบุลําดับการแทรกรายการนี้ลงในไฟล์ ImportConfig.xml สุดท้ายในเวลาที่สร้าง จํานวนลบจะถูกแทรกก่อนองค์ประกอบที่มีอยู่ มีการเพิ่มจํานวนบวกหลังจากองค์ประกอบที่มีอยู่

--missing-dependency-behavior

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

ใช้หนึ่งในค่าเหล่านี้:

• skip
• fault

--overwrite-unmanaged-customizations

ระบุอย่างชัดเจนว่าจะเขียนทับการกําหนดค่าที่ไม่มีการจัดการเมื่อมีการนําเข้าโซลูชันนี้หรือไม่

ใช้หนึ่งในค่าเหล่านี้:

• true
• false

--publish-workflows-activate-plugins

ระบุอย่างชัดเจนว่าจะเผยแพร่เวิร์กโฟลว์และเปิดใช้งานปลั๊กอินเมื่อมีการนําเข้าโซลูชันนี้หรือไม่

ใช้หนึ่งในค่าเหล่านี้:

• true
• false

< ค 0 />< ค 1 />

เพิ่มรายการไปยังไฟล์โครงการแม้ว่าไฟล์จะไม่มีอยู่หรือดูเหมือนไม่ถูกต้อง หมายเหตุ: การใช้สิ่งนี้ไม่มีผลต่อการตรวจสอบความถูกต้องใด ๆ ที่ดําเนินการโดย MSBuild

พารามิเตอร์นี้ไม่จําเป็นต้องมีค่า มันเป็นการสลับ

pac package compile

(ตัวอย่าง) คอมไพล์แพคเกจ ด้วย --package-type erp จะคอมไพล์แบบจําลอง X++ โดยใช้ xppc.exe จาก SDK ที่ติดตั้งและสร้าง ZIP ที่ปรับใช้ต่อแบบจําลอง

พารามิเตอร์ที่จําเป็นสําหรับ package compile

< ค 0 />< ค 1 />

แพลตฟอร์มเป้าหมายสําหรับการปรับใช้ ค่าที่อนุญาต: dataverse, erp (ตัวอย่าง) ค่าเริ่มต้น: dataverse

พารามิเตอร์ที่เลือกได้สําหรับ package compile

< ค 0 />< ค 1 />

เวอร์ชันแอปพลิเคชัน F&O สี่ส่วนของ SDK เพื่อคอมไพล์กับ (เช่น 10.0.2588.0) เมื่อเว้นไว้ SDK ที่ลงทะเบียนไว้สําหรับสภาพแวดล้อมที่ใช้งานอยู่จะถูกใช้

--incremental

รวบรวมเฉพาะวัตถุที่เปลี่ยนแปลงเท่านั้น (ส่งผ่าน -incremental ไปยัง xppc)

พารามิเตอร์นี้ไม่จําเป็นต้องมีค่า มันเป็นการสลับ

< ค 0 />< ค 1 />

รายการตําแหน่งที่ตั้งที่ใช้จุลภาคเป็นตัวคั่นในการคอมไพล์ป้ายชื่อ (เช่น en-US หรือ en-US,fr,de) เมื่อเว้นไว้ LabelC จะสร้างทุกตําแหน่งที่ตั้งที่พบในแหล่งข้อมูล — จับคู่ลักษณะการทํางานของแบบจําลองการสร้างตามค่าเริ่มต้นของ Visual Studio มีผลเฉพาะขั้นตอนของป้ายชื่อเท่านั้น xppc + แนวทางปฏิบัติที่ดีที่สุด + การเรียกใช้แพคเกจหนึ่งครั้งกับผลลัพธ์ที่รวมกัน

< ค 0 />< ค 1 />

เส้นทางไปยังไฟล์ใบอนุญาต ISV เพื่อใส่ลงใน ZIP แบบจําลองที่ผลิตแต่ละตัว เขียนไปยัง <รูปแบบ>/bin/<filename> ภายใน ZIP

< ค 0 />< ค 1 />

ชื่อแบบจําลองที่จะคอมไพล์ ยอมรับชื่อเดียวหรือรายการที่คั่นด้วยจุลภาค เมื่อเว้นไว้ แบบจําลองทั้งหมดที่แสดงใน .erp/xpp.json จะถูกคอมไพล์

--output

ไดเรกทอรีที่จะเขียน ZIP ที่ปรับใช้ได้ ค่าเริ่มต้น: <repoRoot>/bin

< ค 0 />< ค 1 />

ไดเรกทอรีผลลัพธ์

--skip-bp

ข้ามขั้นตอนการตรวจสอบแนวทางปฏิบัติที่ดีที่สุด ตามค่าเริ่มต้น ไปป์ไลน์คอมไพล์จะเรียกใช้ป้ายชื่อ -> X++ -> แนวทางปฏิบัติที่ดีที่สุด

พารามิเตอร์นี้ไม่จําเป็นต้องมีค่า มันเป็นการสลับ

< ค 0 />< ค 1 />

โฟลเดอร์รูทของโซลูชัน X++ (ประกอบด้วย .erp/xpp.json) ค่าเริ่มต้นเป็นไดเร็กทอรีปัจจุบัน

pac package db-sync

(ตัวอย่าง) ซิงโครไนซ์ฐานข้อมูลแอปพลิเคชันการเงินและการปฏิบัติการกับ Dataverse

พารามิเตอร์ที่เลือกได้สําหรับ package db-sync

< ค 0 />< ค 1 />

(ตัวอย่าง) เส้นทางไปยังไฟล์ JSON ที่ตรงกับสัญญา IncrementalSyncParameters (หรือ ModuleSyncParameters) จําเป็นต้องมีสําหรับ --db-sync แบบเพิ่มหน่วย

< ค 0 />< ค 1 />

โหมดการซิงโครไนซ์ฐานข้อมูล ค่าที่อนุญาต: Full, Module, Incremental ค่าเริ่มต้น: เต็ม

< ค 0 />< ค 1 />

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

< ค 0 />< ค 1 />

(ตัวอย่าง) รายการที่ใช้จุลภาคเป็นตัวคั่นของชื่อโมดูลที่จะซิงโครไนซ์ จําเป็นต้องมีเมื่อ --db-sync คือ โมดูล

pac package deploy

ปรับใช้แพคเกจกับ Dataverse

Note

คําสั่งนี้จะพร้อมใช้งานสําหรับเวอร์ชัน .NET Full Framework ของ PAC CLI เท่านั้น

ตัวอย่าง

pac package deploy --logFile c:\samplelogdata --package c:\samplepackage

พารามิเตอร์ที่เลือกได้สําหรับ package deploy

< ค 0 />< ค 1 />

(ตัวอย่าง) เส้นทางไปยังไฟล์ JSON ที่ตรงกับสัญญา IncrementalSyncParameters (หรือ ModuleSyncParameters) จําเป็นต้องมีสําหรับ --db-sync แบบเพิ่มหน่วย

< ค 0 />< ค 1 />

(ตัวอย่าง) วิธีการใช้แพคเกจ ค่าที่อนุญาต: Full, Incremental, Delete ค่าเริ่มต้น: เต็ม ใช้กับ --package-type erp

< ค 0 />< ค 1 />

(ตัวอย่าง) โหมดการซิงโครไนซ์ฐานข้อมูลที่จะเรียกใช้หลังจากปรับใช้ ค่าที่อนุญาต: None, Full, Module, Incremental ค่าเริ่มต้น: ไม่มี ใช้กับ --package-type erp

< ค 0 />< ค 1 />

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

< ค 0 />< ค 1 />

บันทึกผลลัพธ์ไปยังคอนโซล

พารามิเตอร์นี้ไม่จําเป็นต้องมีค่า มันเป็นการสลับ

< ค 0 />< ค 1 />

เส้นทางของไฟล์บันทึก

< ค 0 />< ค 1 />

(ตัวอย่าง) รายการที่ใช้จุลภาคเป็นตัวคั่นของชื่อโมดูลที่จะซิงโครไนซ์ จําเป็นต้องมีเมื่อ --db-sync คือ โมดูล

< ค 0 />< ค 1 />

(ตัวอย่าง) โหมดโซลูชันเท่านั้น: โฟลเดอร์รากที่ประกอบด้วย .erp/xpp.json ค่าเริ่มต้นเป็นไดเร็กทอรีปัจจุบัน เมื่อ --package ถูกละเว้นภายใต้ --package-type erp แบบจําลองทั้งหมดที่แสดงใน .erp/xpp.json จะถูกปรับใช้ตามลําดับการขึ้นต่อกัน

< ค 0 />< ค 1 />

เส้นทางไปยังแพคเกจ dll หรือซิปไฟล์ด้วยแพคเกจ

< ค 0 />< ค 1 />

แพลตฟอร์มเป้าหมายสําหรับการปรับใช้ ค่าที่อนุญาต: dataverse, erp (ตัวอย่าง) ค่าเริ่มต้น: dataverse

< ค 0 />< ค 1 />

(ตัวอย่าง) การจัดประเภทแพคเกจ ค่าที่อนุญาต: Dev, Release ค่าเริ่มต้น: Dev แพคเกจที่วางจําหน่ายจะบังคับให้มีการซิงก์ฐานข้อมูลเต็มรูปแบบบนเซิร์ฟเวอร์ ใช้กับ --package-type erp

< ค 0 />< ค 1 />

การตั้งค่าแพคเกจรันไทม์ที่ส่งผ่านไปยังแพคเกจที่ถูกปรับใช้ รูปแบบของสตริงต้องเป็นkey=value|key=value

หมายเหตุ: รูปแบบของสตริงต้องเป็นkey=value|key=value

< ค 0 />< ค 1 />

เส้นทางไปยังไฟล์โซลูชัน Dataverse ไฟล์ต้องเป็นไฟล์ ZIP หรือ CAB ที่บีบอัด

< ค 0 />< ค 1 />

(ตัวอย่าง) โหมดโซลูชันเท่านั้น: โฟลเดอร์รากที่ประกอบด้วย .erp/xpp.json ค่าเริ่มต้นเป็นไดเร็กทอรีปัจจุบัน เมื่อ --package ถูกละเว้นภายใต้ --package-type erp แบบจําลองทั้งหมดที่แสดงใน .erp/xpp.json จะถูกปรับใช้ตามลําดับการขึ้นต่อกัน

< ค 0 />< ค 1 />

ปล่อยไฟล์บันทึกแบบละเอียดไปยังเอาต์พุตบันทึก

พารามิเตอร์นี้ไม่จําเป็นต้องมีค่า มันเป็นการสลับ

หมายเหตุ

คุณสามารถใช้ได้ทั้ง logFile และ logConsole พารามิเตอร์ร่วมกัน หรือใช้พารามิเตอร์หนึ่งตัวหรือพารามิเตอร์อื่น

pac package init

เตรียมใช้งานไดเรกทอรีด้วยโครงการแพคเกจ Dataverse ใหม่

ตัวอย่าง

pac package init --outputdirectory c:\samplepackage

พารามิเตอร์ที่เลือกได้สําหรับ package init

< ค 0 />< ค 1 />

(ตัวอย่าง) เลเยอร์ X++ ค่าที่อนุญาต: USR, CUS, VAR, SL1, SL2, SL3, BUS, HFX, GLS, DIS, ISV ค่าเริ่มต้น: ISV

< ค 0 />< ค 1 />

(ตัวอย่าง) ชื่อของแบบจําลอง X++ ที่จะยกระดับ ยอมรับชื่อเดียวหรือรายการที่คั่นด้วยเครื่องหมายจุลภาค (เช่น ModelA,ModelB) จําเป็นเมื่อ --package-type คือ erp

< ค 0 />< ค 1 />

ไดเรกทอรีผลลัพธ์

--package-name

ตั้งชื่อเริ่มต้นของแพคเกจ ใช้กับรุ่น ImportExtension.GetNameOfImport

< ค 0 />< ค 1 />

ชนิดของโครงการแพคเกจที่จะยกระดับ ค่าที่อนุญาต: dataverse, erp (ตัวอย่าง) ค่าเริ่มต้น: dataverse

< ค 0 />< ค 1 />

(ตัวอย่าง) ชื่อ Publisher ที่เขียนลงในตัวอธิบายแบบจําลอง ค่าเริ่มต้น: Microsoft

< ค 0 />< ค 1 />

(ตัวอย่าง) เส้นทางรากของแหล่งข้อมูล (สัมพันธ์กับไดเรกทอรีผลลัพธ์) ที่แบบจําลองจะอยู่ ค่าเริ่มต้น: ./src

pac package show

แสดงรายละเอียดของแพคเกจ Dataverse

Note

คําสั่งนี้จะพร้อมใช้งานสําหรับเวอร์ชัน .NET Full Framework ของ PAC CLI เท่านั้น

ตัวอย่าง

pac package show c:\samplepackage.dll

พารามิเตอร์ที่จําเป็นสําหรับ package show

< ค 0 />< ค 1 />

เส้นทางไปยังแพคเกจ dll หรือซิปไฟล์ด้วยแพคเกจ

พารามิเตอร์ที่เลือกได้สําหรับ package show

< ค 0 />< ค 1 />

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

< ค 0 />< ค 1 />

เส้นทางของไฟล์บันทึก

< ค 0 />< ค 1 />

ปล่อยไฟล์บันทึกแบบละเอียดไปยังเอาต์พุตบันทึก

พารามิเตอร์นี้ไม่จําเป็นต้องมีค่า มันเป็นการสลับ

ดูเพิ่มเติม

กลุ่มคําสั่ง Microsoft Power Platform CLI
ภาพรวม Microsoft Power Platform CLI