about_Carbon

Carbon is a PowerShell module for automating the configuration of computers running Windows 7, 8, 2008, and 2012. It can configure and manage:

All functions are designed to be idempotent: when run multiple times with the same arguments, your system will be in the same state without failing or producing errors.

System Requirements

PowerShell 4.0/5.0 and .NET Framework 4.5

Windows 7, 8, 2008, or 2012.

To use IIS functions, IIS must be installed/enabled, including the Web-Scripting-Tools feature.

Installation

See the about_Carbon_Installation help topic for installation instructions.

Support

See the about_Carbon_Support help topic for ways to ask questions about using Carbon.

Overview

Only PowerShell approved verbs are used for command names. Carbon assigns special meaning to these verbs:

Carbon has no dependencies and is designed to work on a computer running a fresh install of Windows. Some functions do interact with some Windows features. If those features aren't installed, you'll get errors.

Carbon has an automated test suite that runs after every change on a computer running Windows 2012 R2. Before release, the test suite is run automatically on a computer running Windows 7 and PowerShell 5. No releases are made unless all tests pass.

Versioning

Carbon uses semantic versioning. We use our version number to communicate how Carbon changes from the last version. Carbon version numbers have the form Major.Minor.Patch.

When upgrading to a new version, if:

See Also