ccmsetup Failed With Error Code 0x87d00227
by Sharmila | Updated Jul 25, 2023
ccmsetup Failed With Error Code 0x87d00227
Error code 0x87d00227 in Configuration Manager (ConfigMgr) indicates that the functionality is disabled, preventing the installation of a new client on a device. This error commonly occurs when a device is connected to a metered network, and ConfigMgr restricts downloads of content over such networks by default.
A metered network is a type of internet connection that has a data limit, typically used in mobile hotspots or limited data plans. To conserve data usage and prevent unexpected charges, devices connected to metered networks often restrict certain activities, including automatic downloads of large files or updates.
Starting from Configuration Manager version 2006, a new ccmsetup parameter called "/AllowMetered" has been introduced to address this issue. This parameter allows downloads of contents over metered networks, giving administrators the flexibility to manage client installations on devices connected to such networks.
By using the "/AllowMetered" parameter during the ccmsetup process, administrators can override the default behavior and enable the installation of the Configuration Manager client on devices, even when they are connected to metered networks. This parameter is particularly useful in scenarios where administrators need to deploy clients on devices with limited data connections, ensuring that the devices stay up-to-date with the latest Configuration Manager policies, applications, and updates.
Implementing the "/AllowMetered" parameter requires careful consideration, as enabling downloads on metered networks can lead to increased data consumption. Administrators should evaluate the impact on data usage and ensure that devices connected to metered networks have sufficient data allowances to handle the client installation and subsequent content downloads.
To use the "/AllowMetered" parameter during the ccmsetup process, administrators can follow these steps:
By enabling the "/AllowMetered" parameter, administrators can proactively manage client installations and ensure that devices connected to metered networks remain compliant with Configuration Manager policies. This capability enhances the overall management and control of Configuration Manager clients in environments where metered networks are prevalent, allowing organizations to maintain a secure and up-to-date client infrastructure.
How to Fix Error Code 0x87d00227?
Reinstalling SCCM Client with /AllowMetered Switch
If you encounter issues with the SCCM client installation on a machine that was previously on a metered network or if you want to ensure a clean client reinstallation, you can follow these steps to use the /AllowMetered switch and the ccmclean tool to achieve a successful client setup.
Prepare the Environment:
a. Locate ccmclean.exe: Navigate to your SCCM site server installation directory, and find the "Tools" folder. Copy the ccmclean.exe tool from this directory to the client machine where you want to reinstall the SCCM client.
b. Locate ccmsetup.exe: Similarly, locate the "client" folder in the SCCM site server installation directory and copy ccmsetup.exe to the c:Windowsccmsetup folder on the client machine.
Uninstall the Existing SCCM Client:
a. Open a command prompt or PowerShell with administrative privileges on the client machine.
b. Change the directory to c:windowsccmsetup using the following command:
c. Run ccmclean.exe to remove the existing SCCM client and all its references:
d. Monitor the progress of the cleanup process by checking the ccmsetup.log file.
Reinstall the SCCM Client with /AllowMetered Switch:
a. Once the cleanup process is completed, copy ccmsetup.exe from the c:Windowsccmsetup folder to the same location.
b. Install the SCCM client with the /AllowMetered switch by running the following command:
Note: Replace "MPSERVERNAME" with the name of your SCCM management point server and "XYZ" with your assigned site code.
Client Push Installation (Optional):
a. If you need to fix the issue on multiple machines using client push, you can add the /AllowMetered switch in the Client Push Installation Properties.
b. Ensure that the /AllowMetered switch is set in the client push installation properties before initiating the client push to reinstall the SCCM client on multiple machines.
Using PowerShell Remote (Alternative Method):
-
You can also use PowerShell remote to run ccmclean and ccmsetup on the remote computer. Here's how:
-
Open PowerShell on your computer and enter the following command to connect to the remote computer:
Change to the c:Windowsccmsetup folder on the remote computer using the following commands:
-
Uninstall the SCCM client by running ccmclean:
-
After the cleanup is completed, copy ccmsetup.exe to the c:Windowsccmsetup folder on the remote computer.
-
Install the SCCM client with the /AllowMetered switch using the following command:
-
Note: Replace "MPSERVERNAME" with the name of your SCCM management point server and "XYZ" with your assigned site code.
-
Following these steps, you can successfully reinstall the SCCM client with the /AllowMetered switch and ensure a clean setup on the client machine, even if it was previously on a metered network. Additionally, you can use PowerShell remote for remote client uninstallation and installation, which can be helpful for managing multiple machines in your SCCM environment.
What is Error code 0x87d00227?
Error code 0x87d00227 in the context of ccmsetup refers to a specific error that occurs during the installation or update of the Configuration Manager (ConfigMgr) client on a Windows computer. The error message associated with this code is "ccmsetup failed with error code 0x87d00227." This error typically indicates that the ConfigMgr client installation or update has been prevented or blocked due to the machine being connected to a metered network.
A metered network is a type of network connection where data usage is measured, and there may be restrictions on downloading large files or updates to conserve data usage. In such scenarios, the ConfigMgr client installation may be restricted to prevent excessive data consumption over the metered connection.
However, starting with ConfigMgr version 2006, a new parameter called "/AllowMetered" was introduced for ccmsetup. When this parameter is used, it allows the ConfigMgr client to download and install content even if the machine is connected to a metered network. This means that the installation or update process bypasses the metered connection restriction and proceeds with the installation.
Causes of Error code 0x87d00227
If you encounter the "ccmsetup failed with error code 0x87d00227" message, it indicates that the ConfigMgr client installation or update has been blocked due to the metered network connection. To resolve this issue, you can use the /AllowMetered parameter with ccmsetup to allow the installation to proceed even on a metered network.
Here's an example of how to use the /AllowMetered parameter during the ConfigMgr client installation:
By including the /AllowMetered parameter in the ccmsetup command, you enable the ConfigMgr client installation to continue regardless of the metered network connection, ensuring that the client is successfully installed or updated on the Windows computer.
Remember that before using the /AllowMetered parameter, you should verify that the installation or update process is acceptable for your organization's network usage policies, as it may consume data and bandwidth. Additionally, it's essential to have the necessary administrative privileges to perform the ConfigMgr client installation or update on the target machine.
ccmsetup failed with error code 0x87d00227 - FAQ
Error code 0x87d00227 in ConfigMgr indicates that the functionality is disabled, preventing the installation of a new client on a device. This commonly occurs when the device is connected to a metered network, and ConfigMgr restricts downloads of content over such networks by default.
Starting from Configuration Manager version 2006, the /AllowMetered parameter allows downloads of content over metered networks, enabling the installation of the Configuration Manager client on devices connected to such networks. It overrides the default behavior and allows the client installation to proceed on metered connections.
Yes, enabling downloads on metered networks can lead to increased data consumption. Administrators should evaluate the impact on data usage and ensure that devices connected to metered networks have sufficient data allowances to handle the client installation and subsequent content downloads.
To use the /AllowMetered parameter during the ccmsetup process, open a command prompt or a script that initiates the ccmsetup installation process. Add the "/AllowMetered" parameter to the ccmsetup command line and initiate the ccmsetup installation on the target devices.
To remotely perform the cleanup and reinstallation of the ConfigMgr client on a remote computer using PowerShell remoting, follow these steps:
- Ensure administrative access and PowerShell remoting on both local and remote computers.
- Copy ccmclean.exe and ccmsetup.exe to the remote computer.
- Establish a remote PowerShell session with the target computer.
- Navigate to the ccmsetup folder, run ccmclean.exe to uninstall the client.
- Install the ConfigMgr client using ccmsetup.exe with the /AllowMetered parameter.
- Exit the remote PowerShell session.