Carbon
1.9.0
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.
See the version list below for details.
Installation Options
Owners
Copyright
(c) 2011 - 2013 Aaron Jensen. All rights reserved.
Package Details
Author(s)
- Aaron Jensen
Tags
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
Dependencies
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](https://bitbucket.org/splatteredbits/carbon/issue/134/import-carbon-fails-with-path-environment)).
### 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](https://bitbucket.org/splatteredbits/carbon/issue/133/set-cryptokeysecurity-invalid-parameters)).
* Fixed an exception that gets thrown when setting a private key's permissions and the only certificate key is AT_SIGNATURE (issue [#132](https://bitbucket.org/splatteredbits/carbon/issue/132/set-cryptokeysecurity-throws-exception)).
### Services
* `Install-Service` stops Windows service even when no settings/configuration has changed (fixes issue [#131](https://bitbucket.org/splatteredbits/carbon/issue/131/install-service-always-restarts-service)).
* `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](https://bitbucket.org/splatteredbits/carbon/issue/143/uninstall-service-script-has-hard-coded)). Thanks to [Travis Mathison](https://bitbucket.org/tdmathison) for the fix.
FileList
- Carbon.nuspec
- about_Carbon.help.txt
- Carbon.format.ps1xml
- Carbon.psd1
- Carbon.psm1
- Carbon.psm1.orig
- Carbon.types.ps1xml
- Import-Carbon.ps1
- ActiveDirectory\Find-ADUser.ps1
- ActiveDirectory\Format-ADSearchFilterValue.ps1
- ActiveDirectory\Get-ADDomainController.ps1
- bin\Carbon.dll
- bin\Carbon.Iis.dll
- bin\Carbon.Iis.pdb
- bin\Carbon.pdb
- bin\Carbon.Xdt.dll
- bin\Carbon.Xdt.pdb
- bin\Ionic.Zip.dll
- bin\Microsoft.Web.XmlTransform.dll
- bin\Protect-String.ps1
- bin\Set-DotNetAppSetting.ps1
- bin\Set-DotNetConnectionString.ps1
- Certificates\Get-Certificate.ps1
- Certificates\Get-CertificateStore.ps1
- Certificates\Get-SslCertificateBinding.ps1
- Certificates\Install-Certificate.ps1
- Certificates\Remove-SslCertificateBinding.ps1
- Certificates\Set-SslCertificateBinding.ps1
- Certificates\Test-SslCertificateBinding.ps1
- Certificates\Uninstall-Certificate.ps1
- COM\Get-ComPermission.ps1
- COM\Get-ComSecurityDescriptor.ps1
- COM\Grant-ComPermission.ps1
- COM\Revoke-ComPermission.ps1
- Computer\Get-ProgramInstallInfo.ps1
- Computer\Remove-EnvironmentVariable.ps1
- Computer\Resolve-NetPath.ps1
- Computer\Set-EnvironmentVariable.ps1
- Computer\Test-OSIs32Bit.ps1
- Computer\Test-OSIs64Bit.ps1
- Cryptography\New-RsaKeyPair.ps1
- Cryptography\Protect-String.ps1
- Cryptography\Unprotect-String.ps1
- DotNet\Set-DotNetAppSetting.ps1
- DotNet\Set-DotNetConnectionString.ps1
- DotNet\Test-DotNet.ps1
- DscResources\Carbon_EnvironmentVariable\Carbon_EnvironmentVariable.xml
- DscResources\Carbon_EnvironmentVariable\en-US\Carbon_EnvironmentVariable.xml
- en-US\Carbon.psm1-Help.xml
- en-US\Get-MamlDocument.xml
- en-US\New-MamlDocument.xml
- FileSystem\Compress-Item.ps1
- FileSystem\Disable-NtfsCompression.ps1
- FileSystem\Enable-NtfsCompression.ps1
- FileSystem\Expand-Item.ps1
- FileSystem\Install-Junction.ps1
- FileSystem\New-Junction.ps1
- FileSystem\New-TempDirectory.ps1
- FileSystem\Remove-Junction.ps1
- FileSystem\Test-NtfsCompression.ps1
- FileSystem\Test-PathIsJunction.ps1
- FileSystem\Test-ZipFile.ps1
- Firewall\Assert-FirewallConfigurable.ps1
- Firewall\Disable-FirewallStatefulFtp.ps1
- Firewall\Enable-FirewallStatefulFtp.ps1
- Firewall\Get-FirewallRule.ps1
- Firewall\Test-FirewallStatefulFtp.ps1
- HostsFile\Get-PathToHostsFile.ps1
- HostsFile\Remove-HostsEntry.ps1
- HostsFile\Reset-HostsFile.ps1
- HostsFile\Set-HostsEntry.ps1
- IIS\Add-IisDefaultDocument.ps1
- IIS\Add-IisServerManagerMember.ps1
- IIS\Disable-IisSecurityAuthentication.ps1
- IIS\Enable-IisDirectoryBrowsing.ps1
- IIS\Enable-IisSecurityAuthentication.ps1
- IIS\Enable-IisSsl.ps1
- IIS\Get-IisApplication.ps1
- IIS\Get-IisAppPool.ps1
- IIS\Get-IisConfigurationSection.ps1
- IIS\Get-IisHttpHeader.ps1
- IIS\Get-IisHttpRedirect.ps1
- IIS\Get-IisMimeMap.ps1
- IIS\Get-IisSecurityAuthentication.ps1
- IIS\Get-IisVersion.ps1
- IIS\Get-IisWebsite.ps1
- IIS\Install-IisApplication.ps1
- IIS\Install-IisAppPool.ps1
- IIS\Install-IisVirtualDirectory.ps1
- IIS\Install-IisWebsite.ps1
- IIS\Invoke-AppCmd.ps1
- IIS\Join-IisVirtualPath.ps1
- IIS\Lock-IisConfigurationSection.ps1
- IIS\Remove-IisMimeMap.ps1
- IIS\Set-IisHttpHeader.ps1
- IIS\Set-IisHttpRedirect.ps1
- IIS\Set-IisMimeMap.ps1
- IIS\Set-IisWebsiteID.ps1
- IIS\Set-IisWebsiteSslCertificate.ps1
- IIS\Set-IisWindowsAuthentication.ps1
- IIS\Test-IisAppPool.ps1
- IIS\Test-IisConfigurationSection.ps1
- IIS\Test-IisSecurityAuthentication.ps1
- IIS\Test-IisWebsite.ps1
- IIS\Uninstall-IisAppPool.ps1
- IIS\Uninstall-IisWebsite.ps1
- IIS\Unlock-IisConfigurationSection.ps1
- INI\Remove-IniEntry.ps1
- INI\Set-IniEntry.ps1
- INI\Split-Ini.ps1
- InternetExplorer\Disable-IEEnhancedSecurityConfiguration.ps1
- InternetExplorer\Enable-IEActivationPermission.ps1
- MSI\Invoke-WindowsInstaller.ps1
- MSMQ\Get-MsmqMessageQueue.ps1
- MSMQ\Get-MsmqMessageQueuePath.ps1
- MSMQ\Grant-MsmqMessageQueuePermission.ps1
- MSMQ\Install-Msmq.ps1
- MSMQ\Install-MsmqMessageQueue.ps1
- MSMQ\Reset-MsmqQueueManagerID.ps1
- MSMQ\Test-MsmqMessageQueue.ps1
- MSMQ\Uninstall-MsmqMessageQueue.ps1
- Network\Get-IPAddress.ps1
- Network\Test-IPAddress.ps1
- Path\Get-PathProvider.ps1
- Path\Resolve-FullPath.ps1
- Path\Resolve-PathCase.ps1
- Path\Resolve-RelativePath.ps1
- Path\Test-UncPath.ps1
- PerformanceCounters\Get-PerformanceCounter.ps1
- PerformanceCounters\Install-PerformanceCounter.ps1
- PerformanceCounters\Test-PerformanceCounter.ps1
- PerformanceCounters\Test-PerformanceCounterCategory.ps1
- PerformanceCounters\Uninstall-PerformanceCounterCategory.ps1
- PowerShell\Add-TrustedHost.ps1
- PowerShell\Clear-TrustedHost.ps1
- PowerShell\Complete-Job.ps1
- PowerShell\Get-PowershellPath.ps1
- PowerShell\Get-TrustedHost.ps1
- PowerShell\Invoke-ConsoleCommand.ps1
- PowerShell\Invoke-PowerShell.ps1
- PowerShell\Set-TrustedHost.ps1
- PowerShell\Test-PowerShellIs32Bit.ps1
- PowerShell\Test-PowerShellIs64Bit.ps1
- Privileges\Get-Privilege.ps1
- Privileges\Grant-Privilege.ps1
- Privileges\Revoke-Privilege.ps1
- Privileges\Test-Privilege.ps1
- Registry\Get-RegistryKeyValue.ps1
- Registry\Install-RegistryKey.ps1
- Registry\Remove-RegistryKeyValue.ps1
- Registry\Set-RegistryKeyValue.ps1
- Registry\Test-RegistryKeyValue.ps1
- ScheduledTasks\Get-ScheduledTask.ps1
- ScheduledTasks\Install-ScheduledTask.ps1
- ScheduledTasks\Test-ScheduledTask.ps1
- ScheduledTasks\Uninstall-ScheduledTask.ps1
- Security\Assert-AdminPrivilege.ps1
- Security\Convert-SecureStringToString.ps1
- Security\ConvertTo-ContainerInheritanceFlags.ps1
- Security\ConvertTo-InheritanceFlag.ps1
- Security\ConvertTo-PropagationFlag.ps1
- Security\ConvertTo-ProviderAccessControlRights.ps1
- Security\Get-Permission.ps1
- Security\Grant-Permission.ps1
- Security\Grant-Permission.ps1.orig
- Security\New-Credential.ps1
- Security\Protect-Acl.ps1
- Security\Revoke-Permission.ps1
- Security\Set-CryptoKeySecurity.ps1
- Security\Test-AdminPrivilege.ps1
- Security\Test-Permission.ps1
- Service\Assert-Service.ps1
- Service\Get-ServiceAcl.ps1
- Service\Get-ServiceConfiguration.ps1
- Service\Get-ServicePermission.ps1
- Service\Get-ServiceSecurityDescriptor.ps1
- Service\Grant-ServiceControlPermission.ps1
- Service\Grant-ServicePermission.ps1
- Service\Install-Service.ps1
- Service\Restart-RemoteService.ps1
- Service\Revoke-ServicePermission.ps1
- Service\Set-ServiceAcl.ps1
- Service\Test-Service.ps1
- Service\Uninstall-Service.ps1
- Shares\Install-SmbShare.ps1
- Text\ConvertFrom-Base64.ps1
- Text\ConvertTo-Base64.ps1
- UsersAndGroups\Add-GroupMember.ps1
- UsersAndGroups\Get-WmiLocalUserAccount.ps1
- UsersAndGroups\Install-Group.ps1
- UsersAndGroups\Install-User.ps1
- UsersAndGroups\Resolve-IdentityName.ps1
- UsersAndGroups\Test-Identity.ps1
- UsersAndGroups\Test-User.ps1
- UsersAndGroups\Uninstall-User.ps1
- WindowsFeatures\Assert-WindowsFeatureFunctionsSupported.ps1
- WindowsFeatures\Get-WindowsFeature.ps1
- WindowsFeatures\Install-WindowsFeature.ps1
- WindowsFeatures\Resolve-WindowsFeatureName.ps1
- WindowsFeatures\Test-WindowsFeature.ps1
- WindowsFeatures\Uninstall-WindowsFeature.ps1
- Xml\Convert-XmlFile.ps1
Version History
| Version | Downloads | Last updated |
|---|---|---|
| 2.16.0-rc1 | 47 | 3/19/2024 |
| 2.15.1 | 7,815,753 | 8/18/2023 |
| 2.15.0 | 37,696 | 8/17/2023 |
| 2.14.1 | 1,428,634 | 7/5/2023 |
| 2.14.1-rc1 | 13 | 7/3/2023 |
| 2.14.0 | 75,143 | 7/3/2023 |
| 2.14.0-rc1 | 103 | 5/10/2023 |
| 2.13.0 | 4,694,291 | 2/16/2023 |
| 2.13.0-rc2 | 94 | 1/20/2023 |
| 2.13.0-rc1 | 5 | 1/20/2023 |
| 2.12.0 | 6,366,575 | 8/10/2022 |
| 2.11.3 | 1,366,290 | 6/30/2022 |
| 2.11.2 | 3,080,948 | 3/28/2022 |
| 2.11.1 | 943,188 | 2/28/2022 |
| 2.11.1-alpha732 | 571 | 2/28/2022 |
| 2.11.0 | 3,795,770 | 11/3/2021 |
| 2.11.0-rc710 | 607 | 10/19/2021 |
| 2.11.0-rc707 | 567 | 10/19/2021 |
| 2.10.2 | 7,140,113 | 3/17/2021 |
| 2.10.1 | 26,452 | 3/16/2021 |
| 2.10.1-rc660 | 610 | 3/8/2021 |
| 2.10.0 | 22,962 | 3/15/2021 |
| 2.10.0-rc651 | 726 | 2/3/2021 |
| 2.9.4 | 3,002,336 | 12/8/2020 |
| 2.9.3 | 607,167 | 11/18/2020 |
| 2.9.3-rc623 | 628 | 10/9/2020 |
| 2.9.2 | 14,020,773 | 1/17/2020 |
| 2.9.1 | 1,546,516 | 11/1/2019 |
| 2.9.0 | 995,083 | 9/19/2019 |
| 2.9.0-rc587 | 586 | 9/16/2019 |
| 2.8.1 | 4,228,475 | 3/26/2019 |
| 2.8.0 | 31,745 | 3/25/2019 |
| 2.7.0 | 3,922,460 | 12/11/2018 |
| 2.6.0 | 5,440,792 | 7/8/2018 |
| 2.5.4 | 206,543 | 6/2/2018 |
| 2.5.3 | 1,339 | 6/1/2018 |
| 2.5.2 | 233 | 6/1/2018 |
| 2.5.1 | 247 | 6/1/2018 |
| 2.5.0 | 828,397 | 6/18/2017 |
| 2.4.1 | 242,682 | 2/21/2017 |
| 2.4.0 | 124,348 | 11/9/2016 |
| 2.3.0 | 39,270 | 9/29/2016 |
| 2.2.0 | 22,401 | 5/12/2016 |
| 2.1.1 | 1,220 | 2/25/2016 |
| 2.1.0 | 553 | 2/9/2016 |
| 2.0.1 | 1,068 | 10/20/2015 |
| 2.0.0 | 1,957 | 10/11/2015 |
| 1.9.0 (current version) | 1,460 | 5/7/2015 |