Carbon

Carbon is a DevOps PowerShell module for automating the configuration of Windows 2008, Windows 2008 R2, and 7 computers. Carbon can configure and manage:

System Requirements

Carbon's automated test suite runs in the following environment:

Feel free to try on your operating system/PowerShell/.NET combination. If you experience any problems, file a bug report or send an e-mail.

Installation

Download the latest release.

Unblock the .zip file (right-click it, choose "Properties", click "Unblock", then click "OK").

Unzip the Carbon module anywhere on your file system. Import the module by running:

		> & 'Path\To\Carbon\Directory\Import-Carbon.ps1'
	

Replace Path\To\Carbon\Directory with the actual path where you unzipped Carbon.

If you don't want to worry about remembering/finding the path to Carbon, put the Carbon directory into one of the following directories:

Then, you can simply

		> Import-Module Carbon
	

Usage

If importing Carbon in a script, we recommend always using relative paths to create a full path to Import-Carbon.ps1. This makes your scripts portable. You can get the directory in which the current script is executing, and use that to get the path to Carbon, like this:

		> $PSScriptRoot = Split-Path -Parent $MyInvocation.MyCommand.Definition
		> & (Join-Path $PSScriptRoot ..\Tools\Carbon\Import-Carbon.ps1 -Resolve)
	

For more usage information, see the Carbon help topic:

		> help Carbon
	

To get a list of all commands imported by Carbon:

		> Get-Command | Where-Object { $_.ModuleName -eq 'Carbon' }