pac package

用于处理 Dataverse 包项目的命令。

指令

Command	Description
pac package add-external-package	将 Dataverse 解决方案系统外部的包添加到包部署程序包项目。
pac package add-reference	添加对 Dataverse 解决方案项目的引用
pac package add-solution	将预生成的 Dataverse 解决方案文件添加到包部署程序包项目。
pac package compile	（预览版）编译包。 使用 --package-type erp，使用已安装 SDK 中的 xppc.exe 编译 X++ 模型，并为每个模型生成可部署的 ZIP。
pac package db-sync	（预览版）将 Finance 和 Operations 应用程序数据库与 Dataverse 同步。
pac package deploy	将包部署到 Dataverse
pac package init	使用新的 Dataverse 包项目初始化目录
pac package show	显示 Dataverse 包的详细信息

pac package add-external-package

将 Dataverse 解决方案系统外部的包添加到包部署程序包项目。

所需的参数 package add-external-package

--package-type -t

要添加的包的类型。 例如：FnO 包的“xpp”。

--path -p

外部包的路径

可选参数 package add-external-package

--import-order

一个整数，指示在生成时将此项插入到最终 ImportConfig.xml 文件中的顺序。 在现有元素之前插入负数。 在现有元素之后添加正数。

--skip-validation -sv

将项添加到项目文件，即使该文件不存在或似乎无效。 注意：使用此方法不会影响 MSBuild 执行的任何验证。

此参数不需要任何值。 这是一个开关。

pac package add-reference

添加对 Dataverse 解决方案项目的引用

Example

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

所需的参数 package add-reference

--path -p

引用的 Dataverse 解决方案项目的路径

可选参数 package add-reference

--dependency-overrides

以分号分隔的替代列表。 此值替代在解决方案的元数据中编码的任何依赖项信息。 每个替代应采用以下格式： <uniquename>:<minVersion>:<maxVersion> minVersion 和 maxVersion 是可选的，但应采用 .NET 版本格式语法。

注意：使用格式 <uniquename>：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 add-solution

--path -p

Dataverse 解决方案文件的路径。 该文件必须是压缩的 ZIP 文件。

可选参数 package add-solution

--dependency-overrides

以分号分隔的替代列表。 此值替代在解决方案的元数据中编码的任何依赖项信息。 每个替代应采用以下格式： <uniquename>:<minVersion>:<maxVersion> minVersion 和 maxVersion 是可选的，但应采用 .NET 版本格式语法。

注意：使用格式 <uniquename>：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

--skip-validation -sv

将项添加到项目文件，即使该文件不存在或似乎无效。 注意：使用此方法不会影响 MSBuild 执行的任何验证。

此参数不需要任何值。 这是一个开关。

pac package compile

（预览版）编译包。 使用 --package-type erp，使用已安装 SDK 中的 xppc.exe 编译 X++ 模型，并为每个模型生成可部署的 ZIP。

所需的参数 package compile

--package-type -pt

部署的目标平台。 允许的值：dataverse、erp（预览版）。 默认值：dataverse。

可选参数 package compile

--app-version -av

要编译的 SDK 由四部分构成的 F&O 应用程序版本（例如 10.0.2588.0）。 省略后，将使用为活动环境注册的 SDK。

--incremental

仅编译已更改的项目（将 -incremental 传递给 xppc）。

此参数不需要任何值。 这是一个开关。

--language -lang

要编译标签的区域设置（例如 en-US 或 en-US，fr，de）的逗号分隔列表。 省略后，LabelC 会生成源中找到的每个区域设置 — 与Visual Studio的默认生成模型行为匹配。 仅影响标签阶段;xppc + 最佳做法 + 包在组合输出上运行一次。

--license-file -lf

要注入每个生成的模型 ZIP 的 ISV 许可证文件的路径。 写入 <ZIP 中的 Model>/bin/<filename> 。

--model -m

要编译的模型名称。 接受单个名称或逗号分隔的列表。 省略后，将编译 .erp/xpp.json 中列出的所有模型。

--output

将写入可部署的 ZIP 的目录。 默认值： <repoRoot>/bin。

--outputDirectory -o

输出目录

--skip-bp

跳过最佳做法检查步骤。 默认情况下，编译管道运行标签 -> X++ -> 最佳做法。

此参数不需要任何值。 这是一个开关。

--solution-root -sr

X++ 解决方案的根文件夹（包含 .erp/xpp.json）。 默认使用当前目录。

pac package db-sync

（预览版）将 Finance 和 Operations 应用程序数据库与 Dataverse 同步。

可选参数 package db-sync

--argument-file -af

（预览版）与 IncrementalSyncParameters（或 ModuleSyncParameters）协定匹配的 JSON 文件的路径。 --db-sync Incremental 所必需的。

--db-sync -ds

数据库同步模式。 允许的值：Full、Module、Incremental。 默认值：已满。

--environment -env

指定目标 Dataverse。 该值可以是 Guid 或绝对 https URL。 如果未指定，将使用为当前身份验证配置文件选择的活动组织。

--modules -m

（预览版）要同步的模块名称的逗号分隔列表。 当 --db-sync 为模块时是必需的。

pac package deploy

将包部署到 Dataverse

注释

此命令仅适用于 PAC CLI 的 .NET Full Framework 版本。

Example

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

可选参数 package deploy

--argument-file -af

（预览版）与 IncrementalSyncParameters（或 ModuleSyncParameters）协定匹配的 JSON 文件的路径。 --db-sync Incremental 所必需的。

--build-type -bt

（预览版）如何应用包。 允许的值：Full、Incremental、Delete。 默认值：已满。 与 --package-type erp 一起使用。

--db-sync -ds

（预览版）部署后要运行的数据库同步模式。 允许的值：None、Full、Module、Incremental。 默认值：无。 与 --package-type erp 一起使用。

--environment -env

指定目标 Dataverse。 该值可以是 Guid 或绝对 https URL。 如果未指定，将使用为当前身份验证配置文件选择的活动组织。

--logConsole -c

将日志输出到控制台

此参数不需要任何值。 这是一个开关。

--logFile -lf

日志文件路径

--modules -m

（预览版）要同步的模块名称的逗号分隔列表。 当 --db-sync 为模块时是必需的。

--outputDirectory -o

（预览版）仅限解决方案模式：包含 .erp/xpp.json的根文件夹。 默认使用当前目录。 在 --package-type erp 下省略 --package 时，.erp/xpp.json 中列出的所有模型都按依赖项顺序部署。

--package -p

包含包的包 dll 或 zip 文件的路径。

--package-type -pt

部署的目标平台。 允许的值：dataverse、erp（预览版）。 默认值：dataverse。

--release-type -rt

（预览版）包分类。 允许的值：Dev、Release。 默认值：开发。 发布包强制在服务器上执行完整数据库同步。 与 --package-type erp 一起使用。

--settings -s

传递给要部署的包的运行时包设置。 字符串的格式必须为 key=value|key=value。

注意：字符串的格式必须为 key=value|key=value。

--solution -sz

Dataverse 解决方案文件的路径。 该文件必须是压缩的 ZIP 或 CAB 文件。

--solution-root -sr

（预览版）仅限解决方案模式：包含 .erp/xpp.json的根文件夹。 默认使用当前目录。 在 --package-type erp 下省略 --package 时，.erp/xpp.json 中列出的所有模型都按依赖项顺序部署。

--verbose -vdbg

向日志输出发出详细日志。

此参数不需要任何值。 这是一个开关。

注解

可以同时使用这两个参数 logFile 和 logConsole 参数，也可以使用一个参数或另一个参数。

pac package init

使用新的 Dataverse 包项目初始化目录

Example

pac package init --outputdirectory c:\samplepackage

可选参数 package init

--layer -l

（预览版）X++ 层。 允许的值：USR、CUS、VAR、SL1、SL2、SL3、BUS、HFX、GLS、DIS、ISV。 默认值：ISV。

--model -m

（预览版）要搭建基架的 X++ 模型的名称（s）。 接受单个名称或逗号分隔的列表（例如 ModelA，ModelB）。 当 --package-type 为 erp 时是必需的。

--outputDirectory -o

输出目录

--package-name

设置包的默认名称。 适用于 ImportExtension.GetNameOfImport 的生成。

--package-type -pt

要搭建基架的包项目的类型。 允许的值：dataverse、erp（预览版）。 默认值：dataverse。

--publisher -pub

（预览版）Publisher写入模型描述符的名称。 默认值：Microsoft。

--source-root -sr

（预览版）源根路径（相对于输出目录），模型将位于其中。 默认值：./src。

pac package show

显示 Dataverse 包的详细信息

注释

此命令仅适用于 PAC CLI 的 .NET Full Framework 版本。

Example

pac package show c:\samplepackage.dll

所需的参数 package show

--package -p

包含包的包 dll 或 zip 文件的路径。

可选参数 package show

--environment -env

指定目标 Dataverse。 该值可以是 Guid 或绝对 https URL。 如果未指定，将使用为当前身份验证配置文件选择的活动组织。

--logFile -lf

日志文件路径

--verbose -vdbg

向日志输出发出详细日志。

此参数不需要任何值。 这是一个开关。

另请参阅

Microsoft Power Platform CLI 命令组
Microsoft Power Platform CLI 概述