包转换管理器疑难解答

项目
04/04/2023

适用于: Configuration Manager(current branch)

使用本文中的信息来帮助排查使用包转换管理器时出现的问题。

SMS 提供程序

包转换管理器使用 SMS 提供程序。有关详细信息，请参阅规划 SMS 提供程序。

如果 SMS 提供程序无法正常工作，则Configuration Manager控制台（包括包转换管理器）不起作用。

包就绪情况

在将包转换为应用程序之前，请使用包转换管理器 Analyze 函数分析 包。分析后，在Configuration Manager控制台的“包”节点中添加“就绪情况”列。包列表显示已分析包的以下就绪状态之一：

自动：可以使用 Convert 函数直接转换包。

注意

自动转换不会将 WQL 查询转换为应用程序要求。使用 修复和转换 过程转换这些查询。
手动：包需要一些添加或更改，然后才能使用 Fix and Convert 函数进行转换 。
不适用：包不适合转换。更正包的任何问题，或继续将其部署为包。
错误：包包含错误。在分析和转换错误之前，请手动更正这些错误。

Configuration Manager控制台中“包”节点的详细信息窗格显示任何就绪性问题。选择一个包，然后在详细信息窗格中选择“ 摘要 ”选项卡。

日志文件

启用日志记录

为包转换管理器启用日志记录时，它会记录其所有操作、异常和错误。

若要在 Configuration Manager中为此组件启用日志记录，请修改 Microsoft.ConfigurationManagement.exe.Config。默认情况下，此配置文件位于以下路径中：
C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\Microsoft.ConfigurationManagement.exe.config

重要

从版本 1910 开始，此路径已更改为使用 Microsoft Endpoint Manager 文件夹。请确保不要使用可能存在于另一个文件夹中的旧版文件。

在 system.diagnostics 元素的最后一个 sources 元素之后插入以下开关和跟踪 XML 元素：

</sources>

    <switches>
      <add name="PcmLogging" value="3"/>
    </switches>
    <trace autoflush="true" indentsize="4">
      <listeners>
        <add name="PcmTraceListener" type="Microsoft.ConfigurationManagement.UserCentric.Logging.RolloverLogTraceListener, Microsoft.ConfigurationManagement.UserCentric.Logging" initializeData="%UserProfile%\AppData\Local\Temp\PcmTrace.log"/>
      </listeners>
    </trace>

</system.diagnostics>

此示例使用 PCMTrace.log 文件。此日志位于运行 Configuration Manager 控制台的计算机上，路径如下：
%UserProfile%\AppData\Local\Temp

若要配置详细信息级别，请更改 PcmLogging 跟踪开关设置。将此值设置为四个详细级别，从最详细 () 1 到最详细 (4) 。

SMSProv.log

在某些情况下， SMSProv.log 文件中包含与包转换过程故障排除相关的信息。此文件从Configuration Manager SMS 提供程序捕获信息。

默认情况下，此日志文件位于Configuration Manager站点服务器上的以下路径：
C:\Program Files\Microsoft Configuration Manager\Logs

如果看到以下错误消息之一， 则 SMSProv.log 文件可能包含相关的故障排除信息：

The SMS Provider reported an error
Generic Failure

这些错误消息通常指示站点服务器上发生了错误，并且错误信息未发送到Configuration Manager控制台。

有关详细信息，请参阅包转换管理器错误消息的技术参考。

分析后更改包属性

分析包并将其就绪状态为 “自动 ”或“ 手动”后，如果更改任何相关属性，转换过程可能会失败。

例如，分析包，其就绪状态为 “自动”。然后，将另一个程序添加到包。包转换可能会失败。

如果需要在分析后对包进行更改，请在转换前重新运行分析。

另请参阅

包转换管理器错误消息的技术参考

通过