ChocoCCM

This module servers to be a PowerShell wrapper to the underlying API that drives pretty much every aspect of Chocolatey Central Management

Contributing

Happy to accept new features and fixes. Outstanding issues which can be worked on tagged Up For Grabs under issues.

Submitting a PR

Here's the general process of fixing an issue in the DSC Resource Kit:

Fork the repository.
Clone your fork to your machine.
It's preferred to create a non-master working branch where you store updates.
Make changes.
Write pester tests to ensure that the issue is fixed.
Submit a pull request to the development branch.
Make sure your code does not contain merge conflicts.
Address comments (if any).

Installation

Published Builds

Install from the PowerShell Gallery:

Install-Module ChocoCCM
Import-Module ChocoCCM

To see a list of available commands:
```
Get-Command -Module ChocoCCM
```

IMPORTANT: Run Connect-CCMServer prior to running any other command. This will setup and store a $Session variable

Local Build

Clone this repository:

git clone https://github.com/chocolatey/ChocoCCM.git
cd ChocoCCM

Run build script
```
./build.ps1
```
Ensure there are no test failures during the build

Import the Module

Import-Module ./Output/ChocoCCM/ChocoCCM.psd1

To see a list of available commands:
```
Get-Command -Module ChocoCCM
```

IMPORTANT: Run Connect-CCMServer prior to running any other command. This will setup and store a $Session variable

Connect-CCMServer considerations

This cmdlet accepts a credential object. Either create one and pass it in, or leave it off and be prompted to enter credentials. Also, there is an -UseSSL parameter which will force HTTPS on all requests to the CCM API.