pac 包

用于处理 Dataverse 包项目的命令

指令

pac 包 add-external-package

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

包 add-external-package 的必需参数

--package-type -t

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

--path -p

外部包的路径

包 add-external-package 的可选参数

--import-order

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

--skip-validation -sv

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

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

pac 包加载项参考

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

Example

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

包加载项引用的必需参数

--path -p

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

包添加引用的可选参数

--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 包添加解决方案

将预生成的 Dataverse 解决方案文件添加到包部署程序包项目。

包添加解决方案所需的参数

--path -p

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

包添加解决方案的可选参数

--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 包部署

将包部署到 Dataverse

Example

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

包部署的可选参数

--environment -env

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

--logConsole -c

将日志输出到控制台

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

--logFile -lf

日志文件路径

--package -p

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

--settings -s

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

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

--solution -sz

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

--verbose -vdbg

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

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

注解

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

pac package init

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

Example

pac package init --outputdirectory c:\samplepackage

包 init 的可选参数

--outputDirectory -o

输出目录

--package-name

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

pac 包显示

显示 Dataverse 包的详细信息

Example

pac package show c:\samplepackage.dll

包显示所需的参数

--package -p

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

包显示的可选参数

--environment -env

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

--logFile -lf

日志文件路径

--verbose -vdbg

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

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

另请参阅

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