Computers
Computers
Chocolatey Central Management gives you visibility into what's installed on a given computer, as well as their last check-in to Central Management and IP Address.
The Computers page can be accessed from the Central Management Dashboard via the menu entry in the left-hand sidebar.
Registering a New Computer
Client computers (agents) will show up in Central Management automatically as long as long as these conditions are met for the client computer:
- The
chocolatey
,chocolatey.extension
, andchocolatey-agent
packages are installed, alongside a valid Chocolatey for Business license. - The
useChocolateyCentralManagement
feature is enabled. - The
centralManagementServiceUrl
is set correctly in the chocolatey configuration file (typically tohttps://<FQDN_to_CCM_service_host>:24020/ChocolateyManagementService
) - The client has access to the above URL (this may require opening the port in your firewall, etc.) so that it can resolve the SSL certificate necessary to communicate with the CCM service.
Please see Central Management Client Setup for more details and setup.
Viewing Installed Software on a Computer
:choco-info: NOTE
Starting with Chocolatey Central Management 0.10.0, the groups that a computer is a member of is shown in both the table of all computers, as well as on the computer details pages. By default, this will only show the first 5 group memberships. If there are more group associations:
- The computers table will display a
...
link in the Groups column. Upon hovering this link, a tooltip will be shown with all group memberships.- On the computer details page, a
View More
link will be shown. When clicked, this will cause an expansion to show all group memberships and the link will update to sayView Less
. Clicking this link again will show the default previous view.
From the main Computers page in Central Management, locate the computer of interest in the list or by providing a search term in the table filter. Select the ⚙️ Actions menu in the corresponding left-hand column, and click Details.
You will be presented with a list of the installed software packages for the machine, similar to below.
Exporting a packages.config
file for a computer
:choco-info: NOTE
Starting with Chocolatey Central Management 0.11.0, the packages installed on a computer can be exported to a
packages.config
file.
From the Computer details page in Chocolatey Central Management, select the Export to packages.config
button.
Removing a Computer from Central Management
:choco-info: NOTE
Unless you first uninstall (at minimum) the
chocolatey-agent
or disable Central Management by disabling the feature setting, the deleted computer will reappear when the Chocolatey Agent performs its next check-in.
From the main Computers page in Central Management, locate the computer of interest in the list or by providing a search term in the table filter. Select the ⚙️ Actions menu in the corresponding left-hand column, and click Delete.
You will be prompted to confirm the deletion.
FAQ
What do I do if computers are not showing up in CCM?
You need to check the CCM service logs. The agent will always report success when it communicates with the service successfully. The service may reject what it receives, but due to security settings, it won't tell the client about that.
The logs are located at $env:ChocolateyInstall\logs\ccm-service.log
. If you are on a version of CCM prior to 0.2.0, the log will be located at $env:ChocolateyInstall\lib\chocolatey-management-service\tools\service\logs\chocolatey.service.host.log
.
For more common errors related to checking in, see the setup section (and component setup sub-sections) as they dive deeper into common errors and resolutions related to things such as this.