Fix SCCM Client Installation Error 0x87d00227 (ccmsetup Failed) – ConfigMgr Troubleshooting Guide

When deploying the SCCM client, you may encounter the error ccmsetup failed with error code 0x87d00227 in the ccmsetup.log file. This issue typically occurs when the client installation is blocked due to a metered network connection. In this guide, we’ll explain the cause of the error, walk through the solution using the /AllowMetered parameter, and show how to clean up previous installations with ccmclean to ensure a smooth client deployment.

Issue

SCCM client push installation failed, with the following error recorded in the ccmsetup.log file.

MapNLMCostDataToCCMCost() returning Cost 0x2

Client deployment cannot be fulfilled since use of a metered network is not allowed.

CcmSetup failed with error code 0x87d00227

Cause

The error code 0x87d00227 translates to Functionality disabled. This typically occurs when a device is connected to a metered network, preventing the SCCM client from installing.

Starting with ConfigMgr version 2006, a new ccmsetup parameter /AllowMetered was introduced. This parameter enables client installation by allowing content downloads over metered connections.

Solution for Error 0x87d00227

Add the parameter /AllowMetered in the Client Push Installation Properties. This allows SCCM client installation even if the device is connected to a metered network. The bypass applies only to SCCM client installation traffic.
If you are reinstalling the Configuration Manager client, the setup may reuse previous configurations and still display the error—even if the device is no longer on a metered connection. To avoid this, it’s recommended to clean up the previous SCCM client installation using ccmclean.

Steps to remove ConfigMgr client and all references:

Copy ccmclean.exe from the SCCM site server installation directory → Tools folder → to the client machine.
Run ccmclean.exe from the command line on the remote machine.
Monitor ccmsetup.log to verify cleanup progress.

Once the cleanup is complete, rerun ccmsetup with the /AllowMetered parameter to enable installation over metered networks.

If the issue needs to be fixed across multiple machines using Client Push, you can also add the /AllowMetered parameter directly in the Client Push Installation Properties. This ensures the setting is applied consistently during client deployments.

Run `ccmclean` and `ccmsetup` via PowerShell Remoting

1. Connect to the Remote Computer

Launch PowerShell.
Enter the remote session:powershell Enter-PSSession -ComputerName <ComputerName>
Navigate to the SCCM setup folder:powershell cd \ cd C:\Windows\ccmsetup

2. Uninstall SCCM Client

Copy ccmclean.exe from the SCCM site server installation directory → Tools folder → to the remote computer’s C:\Windows\ccmsetup folder.
Run the cleanup command:powershell.\ccmclean
Monitor ccmsetup.log to verify cleanup progress.

3. Install SCCM Client

Copy ccmsetup.exe from the SCCM site server installation directory → Client folder → to the remote computer’s C:\Windows\ccmsetup folder.
Run the installation command with required parameters:powershellccmsetup.exe /force /AllowMetered SMSMP=MPSERVERNAME SMSSITECODE=XYZ

4. Alternative Option

If you’ve already added the /AllowMetered switch in Client Push Installation Properties, you can simply use Client Push installation to reinstall the client across multiple machines without manual copying.

Subscribe to Techuisitive Newsletter

Be the first to know about our new blog posts. Get our newsletters directly in your inbox and stay up to date about Modern Desktop Management technologies & news.