修复 SCCM 客户端代理的 4 种最佳方法 |修复 ConfigMgr 代理问题

在这篇文章中，我们将完成修复 SCCM 客户端代理的步骤，以修复所有代理问题。修复 Configuration Manager 客户端代理的最佳方法是使用 ccmrepair.exe。我将介绍一些其他方法，您可以使用这些方法通过修复来轻松修复 ConfigMgr 代理问题。

我经常收到电子邮件询问修复 SCCM 客户端代理的步骤，我会回复包含修复步骤的电子邮件。此外，我决定写一篇文章，现在我可以要求用户使用这篇文章作为这些类型查询的参考，否则谷歌可能会这样做。

当您遇到客户端代理问题时，您可能需要修复 SCCM 客户端。无论是 SCCM 客户端 WMI 问题、客户端运行状况问题等。一些管理员更喜欢卸载 sccm 代理，然后再安装。此过程称为 ConfigMgr 客户端重新安装。与修复操作相比，重新安装客户端代理将花费更多时间。使用命令行，可以使用 ccmrepair 快速修复 sccm 客户端代理。

当您在设置中安装配置管理器时，您将在所有端点上安装 SCCM 客户端代理。安装代理后，您可以使用配置管理器管理端点。

当您想要在计算机上安装 Configuration Manager 客户端代理时，可以使用 ccmsetup.exe 命令。通过在命令行上提供客户端安装参数，您可以修改安装行为。没有可以使用 ccmsetup.exe 运行的修复参数。

使用 CCMRepair.exe 命令行修复 SCCM 客户端代理

使用 CCMRepair.exe，您可以使用以下步骤通过命令行修复 SCCM 客户端代理。

• 登录您的计算机。以管理员身份运行命令提示符。
• 将路径更改为C:\Windows\CCM。
• 要开始 SCCM 客户端代理修复，请运行命令 ccmrepair.exe。

修复 ConfigMgr 客户端代理需要几分钟时间。当我说修复时，基本上意味着客户端代理已重新安装。如果您看到状态为“完成”，则表示客户端代理修复已成功完成。

C:\Windows\CCM>ccmrepair.exe
Repairing product {88B420C9-C484-4E20-8D02-C25243A36B80}…
Done.

您可以通过查看 ccmsetup.log 来监控 SCCM 客户端代理修复过程。 ccmsetup.log 文件位于客户端计算机上的 C:\Windows\ccmsetup\Logs 文件夹中。此外，对于其他客户端日志，请查看 SCCM 日志文件。

CcmSetup is exiting with return code 0 行确认 SCCM 客户端代理修复已成功完成。修复 ConfigMgr 客户端后，无需重新启动计算机。

有些人可能担心 SCCM 客户端代理修复可能会删除 CCMCache 文件夹中存在的所有文件夹。但是，当我验证这一点时，如果您使用命令行运行 ccmrepair，我注意到 CCMCache 文件夹中的文件夹完好无损，这是一件好事。

使用右键单击工具修复 SCCM 客户端代理

使用右键单击工具，您可以通过以下步骤执行 SCCM 客户端代理修复。

• 启动配置管理器控制台。
• 导航到资产和合规性\概述\设备。选择要修复 SCCM 代理的设备。
• 右键单击设备，然后选择右键单击工具 > 客户端工具 > 修复客户端。
• 您会看到一个对话框，询问“您确定要修复客户端吗？”。单击是继续修复。

同样，您可以通过监视客户端计算机上的 ccmsetup.log 来监视 SCCM 客户端代理修复过程。

使用右键单击工具修复 SCCM 客户端的一个注意事项是它会删除 ccmcache 文件夹中的文件夹。客户端缓存是部署到客户端的软件、应用程序和更新的临时下载位置。客户端缓存位于%windir%\ccmcache。因此，当您使用右键单击工具修复配置管理器客户端代理时，请记住这一点。

使用运行脚本修复 Configuration Manager 客户端

您可以再次使用ccmrepair.exe来修复SCCM客户端代理，但这次我们将其与SCCM中的“运行脚本”功能一起使用。此方法的优点是它允许您同时修复多台远程计算机上的配置管理器客户端。

在 Configuration Manager 控制台中，转到软件库\概述\脚本。右键单击脚本，然后单击创建脚本。在“脚本详细信息”窗口中，指定脚本名称（例如“修复 SCCM 客户端代理”），然后选择脚本语言“PowerShell”。我们将使用脚本下的 ccmrepair 命令来修复 Configuration Manager 客户端代理。输入以下命令并单击下一步。

C:\windows\ccm\ccmrepair.exe

在完成窗口中，单击关闭。

在配置管理器中创建新脚本时，您必须批准该脚本。有时批准拒绝按钮可能会被禁用。以下是修复 SCCM 中禁用的批准拒绝按钮的解决方案。右键单击 SCCM 客户端代理修复脚本，然后单击批准。

客户端修复脚本获得批准后，转到设备。选择一个设备，右键单击并运行脚本。正如我之前提到的，您还可以在设备集合上运行客户端修复脚本。

选择修复 SCCM 客户端代理脚本并单击下一步。

运行此脚本将修复设备上的 Configuration Manager 客户端代理。在客户端计算机上查看 ccmsetup.log 以监视客户端代理修复过程。

用于远程修复 SCCM 客户端的 PowerShell 脚本

使用下面的PowerShell脚本，您可以远程修复SCCM客户端。当您想要修复位于远程站点的计算机上的 ConfigMgr 客户端时，此脚本非常有用。要使用此脚本，请将其复制到记事本并将其重命名为 ConfigMgAgentRepair.ps1。您可以使用 CMPivot 运行此脚本或在远程计算机上运行此 PowerShell 脚本。

# Usage: SCCM-RepairClient <TargetName>
function SCCM-RepairClient([String] $strTargetName)
{
$SCCMClient = [wmiclass] "\$strTargetName\root\ccm:sms_client"
$SCCMClient.RepairClient()
}

SCCM 客户端代理修复常见问题解答

与 Configuration Manager 客户端代理修复相关的一些常见问题和解答。

什么是 CCMRepair.exe？

ccmrepair.exe 是一个可执行文件，允许您修复 Configuration Manager 客户端代理。

CCMRepair 的位置在哪里？

ccmrepair 文件位于 C:\windows\ccm\ 文件夹中。

如何修复 SCCM 客户端代理？

要修复计算机上的 SCCM 客户端代理，请运行位于 C:\windows\ccm\ 文件夹中的 ccmrepair.exe。

CCMRepair 的日志文件是什么？

您可以通过查看 ccmsetup.log 来监控 SCCM 客户端代理修复过程。 ccmsetup.log 文件位于客户端计算机上的 C:\Windows\ccmsetup\Logs 文件夹中。

如何确认SCCM客户端修复成功？

ccmsetup.log 中的 CcmSetup is exiting with return code 0 行确认 SCCM 客户端代理修复成功。