I’m extremely happy to announce the release of Carbon v1.0.0. Thanks to everyone who’s already started using Carbon. Please continue to provide feedback. I love to hear from everyone that’s using it, good or bad. Also, now that we’re at v1.0, don’t hesitate to spread the word!
If you’re on v0.5.0.1, you should be able to upgrade with little or no work as this release is includes mostly fixes for bugs found in that release.
Upgrade Instructions
- Remove the
Quietparameter from theImport-Carbon.ps1script. - If you’re nesting Carbon as a sub-module of another module, STOP. This causes havoc. Create an
Import-*.ps1script for your module which imports Carbon before importing your own module. Update your scripts to import your module with your fancy newImport-*.ps1script. See Best Practices for Importing PowerShell Modules for details.
Enhancements
General
- The
Import-Carbon.ps1script no longer checks if Carbon is a sub-module of another module, so theQuietparameter was removed. Please don’t nest Carbon in your modules! It will cause havoc. Import-Carbon.ps1will no longer stop execution if an error occurs during an import (i.e. the$ErrorActionPreference = 'Stop'line was removed).
Services
- Renamed Install-Service’s
Dependenciesparameter toDependency(with backwards-compatible alias), to follow PowerShell naming standards.
Users and Groups
- Install-User: you can now set a user’s full name with the optional
FullNameparameter.
Bug Fixes
IIS
- Added
Test-IisWebsiteExistsalias for Test-IisWebsite, for backwards-compatibility with earlier releases.
Security
- Grant-Permission returns boolean values to the pipeline when clearing access rules.
- Added
Unprotect-AclAccessRulesalias for Protect-Acl, for backwards-compatibility with earlier releases. - Updated v0.5.0.0 section of release notes to include a note that
Unprotect-AclAccessRuleswas renamed to Protect-Acl.
Service
- Install-Service fails if
Dependencyparameter doesn’t have a value. Sometimes.
Shares
- Install-SmbShare fails if a principal name contains a space.
Users and Groups
- Add-GroupMember doesn’t handle when the .NET Active Directory throws an exception when adding members to a group, causing script termination.