Client health checks

Applies to: Configuration Manager (current branch)

The Configuration Manager client regularly runs the checks and remediations to keep healthy. For more information, see How to monitor clients.

Client checks

Verify that the client was installed correctly

If the client isn't correctly installed, start by troubleshooting client install. Review the ccmsetup.log. Often, remediation requires that you reinstall the client.

Verify that client prerequisites are installed

Verify that the client prerequisites are installed. It reads the file ccmsetup.xml in the client installation folder to discover the prerequisites. By default: C:\Windows\ccmsetup\ccmsetup.xml

Most client prerequisites are available by default in Windows, or installed automatically by the Configuration Manager client. To remediate problems with prerequisites, you can try to install them manually, or reinstall the client.

Verify the client service

There are three checks for the SMS Agent Host client service (CcmExec):

  • First, it verifies that the service exists. If it doesn't exist, you need to reinstall the client.

  • Next, it verifies that the service startup type is automatic. To remediate a failure with this check, reset the service startup type to automatic. Check group policies to make sure something isn't automatically configuring the service startup type.

  • Then it verifies that the client service is running. The remediation for this check is to start the client service. Then monitor it to make sure it keeps running. Review Windows event logs to see if there are any related activities that might be stopping the service. Review client logs to make sure it's not failing to start.

Verify that client check has recently run

Verify that the client check scheduled task (CcmEval) has run at least one time in the past three days. You can manually run the scheduled task. Make sure that Windows can run scheduled tasks.

Verify that the client database is healthy

The client uses a built-in version of SQL Server Compact Edition (CE) to locally store information. If this check fails, reinstall the Configuration Manager client to remediate.

Verify WMI

There are several checks specific to WMI. The first three checks are for the Windows Management Instrumentation (WMI) service (Winmgmt).

  • Verify that the service exists. WMI is a fundamental component of Windows. If this service doesn't exist, you may need to reinstall Windows.

  • Verify that the service startup type is automatic. To remediate a failure with this check, reset the service startup type to automatic. Check group policies to make sure something isn't automatically configuring the service startup type.

  • Verify that the service is running. The remediation for this check is to start the WMI service. Then monitor it to make sure it keeps running. Review Windows event logs to see if there are any related activities that might be stopping the service.

There are two other checks to test the overall health of WMI on the device:

  • The WMI repository integrity test checks that Configuration Manager client entries exist in WMI. If this check fails, reinstall the Configuration Manager client.

  • The WMI event sink test checks whether the Configuration Manager-related WMI event sink is lost. If this check fails, restart the client service.

Verify the antimalware service

There are two checks for whatever antimalware service is registered with Windows:

  • Verify that the antimalware service startup type is automatic. To remediate a failure with this check, reset the service startup type to automatic. Check group policies to make sure something isn't automatically configuring the service startup type.

  • Verify that the antimalware service is running. The remediation for this check is to start the antimalware service. Then monitor it to make sure it keeps running. Review Windows event logs to see if there are any related activities that might be stopping the service.

If you're using Windows Defender, the Configuration Manager client also verifies the Windows Defender Antivirus Network Inspection Service (WdNisSvc). It checks to make sure the service startup type is manual.

Verify Windows Update service

This check verifies that the Windows Update service (wuauserv) startup type is automatic or manual. To remediate a failure with this check, reset the service startup type to automatic. Check group policies to make sure something isn't automatically configuring the service startup type.

Verify the policy platform

There are three checks for the Microsoft Policy Platform service (lppsvc):

  • Verify that the service exists. The policy platform is one of the prerequisite components that the Configuration Manager client automatically installs. If this service doesn't exist, reinstall the Configuration Manager client.

  • Verify that the service startup type is manual. To remediate a failure with this check, reset the service startup type to manual. Check group policies to make sure something isn't automatically configuring the service startup type.

  • Policy platform WMI integrity test. Repair the policy platform.

Verify BITS service

There are two checks for the Background Intelligent Transfer Service (BITS):

  • Verify that the service exists. BITS is a fundamental component of Windows. If this service doesn't exist, you may need to reinstall Windows.

  • Verify that the service startup type is automatic or manual. To remediate a failure with this check, reset the service startup type to automatic. Check group policies to make sure something isn't automatically configuring the service startup type.

Verify remote control

If you enable the remote control agent in client settings, there are two checks for the Configuration Manager Remote Control service (CmRcService):

  • Verify that the service type is automatic or manual. To remediate a failure with this check, reset the service startup type to automatic. Check group policies to make sure something isn't automatically configuring the service startup type.

  • Verify that the service is running. The remediation for this check is to start the remote control service. Then monitor it to make sure it keeps running. Review Windows event logs to see if there are any related activities that might be stopping the service.

Verify wake-up proxy

If you enable the wake-up proxy in client settings, there are two checks for the Configuration Manager Wake-up Proxy service:

  • Verify that the service startup type is automatic. To remediate a failure with this check, reset the service startup type to automatic. Check group policies to make sure something isn't automatically configuring the service startup type.

  • Verify that the service is running. The remediation for this check is to start the wake-up proxy service. Then monitor it to make sure it keeps running. Review Windows event logs to see if there are any related activities that might be stopping the service.

Most common check failures

The following checks have the most commonly reported failures. The numbers are included to provide scale between the checks.

  • Verify CcmEval task has run in recent cycles (4,950)
  • Verify client prerequisites (554)
  • Verify Windows Update service startup type (399)
  • Verify Configuration Manager Remote Control service status (345)
  • Verify Configuration Manager Remote Control service startup type (294)
  • Verify SMS Agent Host service status (249)
  • Verify SQL Server CE database is healthy (157)
  • Verify client WMI Provider (131)
  • Verify client installation (120)
  • WMI event sink test (93)

Next steps

Client health dashboard

How to configure client status

How to deploy clients to Windows computers

Configuration Manager troubleshooting