Automates setup and configuration of users, groups, services, privileges, permissions (file system, registry, and private keys), IIS, certificates, security, junctions, hosts files, INI files, performance counters, scheduled tasks, .NET and more.

There is a newer prerelease version of this module available.
See the version list below for details.

Installation Options

Copy and Paste the following command to install this package using PowerShellGet More Info

Install-Module -Name Carbon -RequiredVersion 1.9.0

You can deploy this package directly to Azure Automation. Note that deploying packages with dependencies will deloy all the dependencies to Azure Automation. Learn More

Manually download the .nupkg file to your system's default download location. Note that the file won't be unpacked, and won't include any dependencies. Learn More


Aaron Jensen


(c) 2011 - 2013 Aaron Jensen. All rights reserved.



groups identity principal iis powershell trusted-host security firewall service dsc dsc-resources computer environment networking ini text file-system ntfs registry certificates acl privileges users scheduled-tasks zip compression sid xml internet-explorer com active-directory shares smb ip msi installers msmq path hosts-file performance-counters programs windows-features junctions credential cryptography encryption rsa directory ssl .net windows operating-system os


This module has no dependencies.

Release Notes

# 1.9.0 (8 November 2014)

This is the last minor release for version 1.0. Future 1.0-compatible releases will *only* contain bug fixes, no new features. It takes too much time to maintain two versions, and I'd rather spend my time getting 2.0 out the door.  Carbon 2.0 will require PowerShell 4.0, so start planning.

## Enhancements

### Certificates

* Added `KeyStorageFlags` parameter to `Get-Certificate` when loading a certificate from a file for better control when storing the certificate.

### Hosts File

* `Set-HostsEntry` now handles writing to an in-use/locked hosts file, retrying up to 10 times before writing an error, waiting a random amount of time (from 0 to 1000 milliseconds) between each retry attempt.

### IIS

* `Get-IisMimeMap`, `Remove-IisMimeMap`, and `Set-IisMimeMap` now support managing MIME types for websites, virtual directories, and applications.

### Scheduled Tasks

* Created `Get-ScheduledTask` function for getting the scheduled tasks on the local computer using `schtasks.exe`.
* Created `Install-ScheduledTask` function for installing a scheduled task using `schtasks.exe`.
* Created `Test-ScheduledTask` function for testing if a scheduled tasks on the local computer exists using `schtasks.exe`.
* Created `Uninstall-ScheduledTask` function for deleting a scheduled task using `schtasks.exe`.

### Services

* `Install-Service` now supports setting a command to run when a service fails.

## Bug Fixes

### General

* `Import-Carbon` fails when `-WhatIf` switch is used.
* Importing Carbon no longer writes an error if the `PATH` environment variable contains a path to a non-existent drive (issue [#134](

### INI

* `Set-IniEntry` fails when adding the first section-less setting to a file.

### Internet Explorer

* `Enable-IEActivationPermission` no longer returns the `hkcr:` drive.

### Security

* Fixed an error that occurs when setting permissions on a private key fails: the error message is created using an invalid format string (issue [#133](
* Fixed an exception that gets thrown when setting a private key's permissions and the only certificate key is AT_SIGNATURE (issue [#132](

### Services

* `Install-Service` stops Windows service even when no settings/configuration has changed (fixes issue [#131](
* `Install-Service` didn't clear services depended on during a re-install.
* `Install-Service` wasn't restarting a manual service if it was running when configuration began.
* `Uninstall-Service` hard codes the path to the Windows directory (fixes issue [#143]( Thanks to [Travis Mathison]( for the fix.

Version History

Version Downloads Last updated
2.9.2 9,005,815 1/17/2020
2.9.1 1,542,139 11/1/2019
2.9.0 993,927 9/19/2019
2.9.0-rc587 17 9/16/2019
2.8.1 4,218,874 3/26/2019
2.8.0 31,646 3/25/2019
2.7.0 3,915,339 12/11/2018
2.6.0 5,411,031 7/8/2018
2.5.4 206,499 6/2/2018
2.5.3 1,289 6/1/2018
2.5.2 180 6/1/2018
2.5.1 196 6/1/2018
2.5.0 825,949 6/18/2017
2.4.1 240,427 2/21/2017
2.4.0 123,708 11/9/2016
2.3.0 39,211 9/29/2016
2.2.0 22,179 5/12/2016
2.1.1 1,163 2/25/2016
2.1.0 473 2/9/2016
2.0.1 998 10/20/2015
2.0.0 195 10/11/2015
1.9.0 (current version) 584 5/7/2015
Show less