4 Best Ways to Repair SCCM Client Agent | Fix ConfigMgr Agent Issues

Prajwal Desai
Posted by Prajwal Desai
Repair SCCM Client Agent Fix ConfigMgr Agent Issues

In this post, we will go through the steps to repair SCCM client agent to fix all agent issues. The best way to repair a Configuration Manager client agent is to use ccmrepair.exe. I will cover some additional methods using which you can easily fix your ConfigMgr agent issues by repairing them.

I often get emails asking for the steps to repair SCCM client agent, and I do reply to the emails with the repair steps. Furthermore, I decided to write a post, and I can now ask users to use this article as a reference for these types of queries, or Google will probably do so.

When you encounter problems with the client agent, you might want to repair the SCCM client. Be it SCCM client WMI issues, client health issues etc. Some admins prefer to uninstall the sccm agent and then install it. This procedure is called as ConfigMgr client reinstallation. Reinstalling the client agent will take more time when compared to the repair operation. Using the command line, the sccm client agent can be repaired quickly with ccmrepair.

When you install Configuration Manager in your setup, you install the SCCM client agents on all your endpoints. After you install the agents, you can manage your endpoints using Configuration Manager.

When you want to install a Configuration Manager client agent on a computer, you use the ccmsetup.exe command. By providing client installation parameters on the command line, you can modify the installation behavior. There is no repair parameter that you can run with ccmsetup.exe.

Repair SCCM Client Agent using CCMRepair.exe Command Line

Using CCMRepair.exe, you can repair SCCM client agent via command line using below steps.

  • Login to your computer. Run the Command Prompt as Administrator.
  • Change the path to C:\Windows\CCM.
  • To begin the SCCM client agent repair, run the command ccmrepair.exe.
Repair SCCM Client Agent using CCMRepair
Repair SCCM Client Agent using CCMRepair

It takes a few minutes to repair the ConfigMgr client agent. When I say repair, it basically means the client agent is reinstalled. If you see “Done” as the status, it means the client agent repair is successfully completed.

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

You can monitor the SCCM client agent repair process by reviewing the ccmsetup.log. The ccmsetup.log file is located in the C:\Windows\ccmsetup\Logs folder on the client computer. In addition, for other client logs, take a look at the SCCM log files.

The line CcmSetup is exiting with return code 0 confirms that SCCM client agent repair is completed successfully. You don’t have to restart your computer after you repair the ConfigMgr client.

CcmSetup is exiting with return code 0
CcmSetup is exiting with return code 0

Some of you may have a concern that SCCM client agent repair might remove all the folders present in CCMCache folder. However, when I verified this, if you run ccmrepair using command line, I noticed that folders were intact in CCMCache folder which is a good thing.

CCMCache Folder
CCMCache Folder

SCCM Client Agent Repair using Right Click Tools

Using the Right Click Tools, you can perform SCCM client agent repair with below steps.

  • Launch the Configuration Manager console.
  • Navigate to Assets and Compliance\Overview\Devices. Select a device for which you want to repair SCCM agent.
  • Right-click the device and select Right Click Tools > Client Tools > Repair Client.
  • You get a dialog box asking, “Are you sure you want to repair the client?“. Click Yes to proceed with repair.
SCCM Client Agent Repair using Right Click Tools
SCCM Client Agent Repair using Right Click Tools

Again, you can monitor the SCCM client agent repair process by monitoring the ccmsetup.log on the client computer.

One caveat of using the right click tools to repair SCCM client is it deletes the folders within ccmcache folder. The client cache is a temporary download location for software, applications, and updates deployed to a client. The client cache is located in %windir%\ccmcache. So keep that in mind when you use right click tools to repair the configuration manager client agent.

ccmcache folder empty
ccmcache folder empty

Using Run Script to Repair Configuration Manager Client

Once again, you can use ccmrepair.exe to repair the SCCM client agent, but this time we will use it with the “Run Script” feature in SCCM. The advantage of this method is that it allows you to repair the Configuration Manager client on multiple remote computers at once.

In the Configuration Manager console, go to Software Library\Overview\Scripts. Right click Scripts and click Create Script. On the Script details window, specify a script name such as Repair SCCM Client Agent and select the script language as PowerShell. We’ll use the ccmrepair command under Script to fix the Configuration Manager client agent. Enter the below command and click Next.

C:\windows\ccm\ccmrepair.exe
Using Run Script Repair Configuration Manager Client
Using Run Script Repair Configuration Manager Client

On the Completion window, click Close.

Using Run Script Repair Configuration Manager Client
Using Run Script Repair Configuration Manager Client

When you create a new script in Configuration Manager, you must approve the script. Sometimes the approve deny button may be disabled. Here is a solution to fix approve deny button disabled in SCCM. Right-click the SCCM client agent repair script and click Approve.

Approve the SCCM Client Repair Script
Approve the SCCM Client Repair Script

Once the client repair script is approved, go to devices. Select a device, right click and Run Script. As I mentioned earlier, you can also run the client repair script on device collections as well.

Run Script SCCM Client Repair
Repair SCCM Client Agent

Select the repair SCCM client agent script and click Next.

Run Script SCCM Client Repair
Run Script SCCM Client Repair

Running this script will repair Configuration Manager client agent on device(s). On the client computer review the ccmsetup.log to monitor the client agent repair process.

Repair SCCM Client Agent
Repair SCCM Client Agent

PowerShell Script to Remotely Repair SCCM Client

Using the below PowerShell script, you can remotely repair SCCM client. This script is useful when you want to repair ConfigMgr client on a computer located in a remote site. To use this script, copy it to a notepad and rename it to ConfigMgAgentRepair.ps1. You can use the CMPivot to run this script or run this PowerShell script on the remote computer.

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

SCCM Client Agent Repair FAQ

Some commonly asked questions and answers related to Configuration Manager client agent repair.

What is CCMRepair.exe?

ccmrepair.exe is an executable that allows you to repair Configuration Manager client agent.

What is the location of CCMRepair?

The ccmrepair file is located in C:\windows\ccm\ folder.

How do I Repair SCCM client agent?

To repair SCCM client agent on a computer, run ccmrepair.exe that is located in C:\windows\ccm\ folder.

What is the log file for CCMRepair?

You can monitor the SCCM client agent repair process by reviewing the ccmsetup.log. The ccmsetup.log file is located in C:\Windows\ccmsetup\Logs folder on the client computer.

How to Confirm SCCM Client Repair is Successful?

The line CcmSetup is exiting with return code 0 in ccmsetup.log confirms the SCCM client agent repair is successful.

Share This Article
Prajwal Desai
Posted by Prajwal Desai
Follow:
Prajwal Desai is a Microsoft MVP in Intune and SCCM. He writes articles on SCCM, Intune, Windows 365, Windows Server, Windows 11, WordPress and other topics, with the goal of providing people with useful information.
12 Comments