Break Carbon out into separate modules

[splatteredbits]

⏳ Carbon.Accounts

In progress. RC available.

• ⏳ Add-GroupMember (as Install-CLocalGroupMember)
• Assert-AdminPrivilege
• ✔ ConvertTo-SecurityIdentifier
• ⏳ Get-Group (as Get-CLocalGroup)
• Get-IdentityPrincipalContext
• Get-Principal
• Get-User
• Get-WmiLocalUserAccount
• ⏳ Install-Group (as Install-CLocalGroup)
• Install-User
• ⏳ Remove-GroupMember (as Uninstall-CLocalGroupMember)
• ✔ Resolve-Identity
• ✔ Resolve-IdentityName
• Test-AdminPrivilege
• ⏳ Test-Group (as Test-CLocalGroup)
• ⏳ Test-GroupMember (as Test-CLocalGroupMember)
• ✔ Test-Identity
• Test-User
• ⏳ Uninstall-Group (as Uninstall-CLocalGroup)
• Uninstall-User

Carbon.ActiveDirectory

• Find-ADUser
• Format-ADSearchFilterValue
• Get-ADDomainController

Carbon.COM

• Get-ComPermission
• Get-ComSecurityDescriptor
• Grant-ComPermission
• Revoke-ComPermission

⏳ Carbon.Core

In progress.

• Complete-Job
• ConvertFrom-Base64
• ✔ ConvertTo-Base64
• ✔ Get-PathProvider
• Get-PowerShellModuleInstallPath
• ✔ Get-PowershellPath
• Invoke-ConsoleCommand
• ✔ Invoke-PowerShell
• New-Credential
• Remove-EnvironmentVariable
• ✔ Resolve-FullPath
• Resolve-NetPath
• Resolve-RelativePath
• Set-EnvironmentVariable
• ✔ Start-PowerShellProcess
• ✔ Test-OSIs32Bit (as Test-COperatingSystem)
• ✔ Test-OSIs64Bit (as Test-COperatingSystem)
• ✔ Test-PowerShellIs32Bit (as Test-CPowerShell)
• ✔ Test-PowerShellIs64Bit (as Test-CPowerShell)
• ✔ Test-TypeDataMember
• Test-UncPath

✔ Carbon.Cryptography

• ❌ ConvertTo-Key
• ✔ Convert-SecureStringToString
• ✔ Get-Certificate
• ✔ Get-Permission (as Get-CPrivateKeyPermission)
• ❌ Get-CertificateStore
• ✔ Grant-Permission (as Grant-CPrivateKeyPermission)
• ✔ Install-Certificate
• ✔ New-RsaKeyPair
• ✔ Protect-String
• ✔ Revoke-Permission (as Revoke-CPrivateKeyPermission)
• ✔ Test-Permission (as Test-CPrivateKeyPermission)
• ✔ Uninstall-Certificate
• ✔ Unprotect-String

Carbon.DotNet

• Remove-DotNetAppSetting
• Set-DotNetAppSetting
• Set-DotNetConnectionString
• Test-DotNet

✔ Carbon.DSC

• ✔ Carbon_EnvironmentVariable
• ✔ Carbon_FirewallRule
• ✔ Carbon_Group
• ✔ Carbon_IniFile
• ✔ Carbon_Permission
• ✔ Carbon_Privilege
• ✔ Carbon_ScheduledTask
• ✔ Carbon_Service
• ✔ Clear-DscLocalResourceCache
• ✔ Clear-MofAuthoringMetadata
• ✔ Copy-DscResource
• ✔ Get-DscError
• ✔ Get-DscWinEvent
• ✔ Initialize-Lcm
• ✔ Start-DscPullConfiguration
• ✔ Test-DscTargetResource
• ✔ Write-DscError

Carbon.FileSharing

• Get-FileShare
• Get-FileSharePermission
• Test-FileShare
• Uninstall-FileShare

⏳ Carbon.FileSystem

In progress.

• Disable-AclInheritance (as Disable-CNtfsAclInheritance)
• Disable-NtfsCompression
• Enable-AclInheritance (as Enable-CNtfsAclInheritance)
• Enable-NtfsCompression
• ✔ Get-Permission (as Get-CNtfsPermission)
• ✔ Grant-Permission (as Grant-CNfsPermission)
• Install-Directory
• Install-FileShare
• Install-Junction
• New-Junction
• New-TempDirectory
• Read-File
• Remove-Junction
• Resolve-PathCase
• ✔ Revoke-Permission (as Revoke-CNtfsPermission)
• ✔ Test-Permission (as Test-CNtfsPermission)
• Test-PathIsJunction
• Uninstall-Directory
• Uninstall-Junction
• Write-File

✔ Carbon.IIS

Complete.

• ✔ Add-IisDefaultDocument
• ✔ Add-IisServerManagerMember
• ✔ Disable-IisSecurityAuthentication
• ✔ Enable-IisDirectoryBrowsing
• ✔ Enable-IisSecurityAuthentication
• ✔ Enable-IisSsl (as Enable-IisHttps)
• ✔ Get-IisApplication
• ✔ Get-IisAppPool
• ✔ Get-IisConfigurationSection
• ✔ Get-IisHttpHeader
• ✔ Get-IisHttpRedirect
• ✔ Get-IisMimeMap
• ✔ Get-IisSecurityAuthentication
• ✔ Get-IisVersion
• ✔ Get-IisWebsite
• ✔ Install-IisApplication
• ✔ Install-IisAppPool
• ✔ Install-IisVirtualDirectory
• ✔ Install-IisWebsite
• ❌ Invoke-AppCmd
• ✔ Join-IisVirtualPath
• ✔ Lock-IisConfigurationSection
• ✔ Remove-IisMimeMap
• ✔ Set-IisHttpHeader
• ✔ Set-IisHttpRedirect
• ✔ Set-IisMimeMap
• ✔ Set-IisWebsiteID
• ✔ Set-IisWebsiteSslCertificate
• ✔ Set-IisWindowsAuthentication
• ✔ Test-IisAppPool
• ✔ Test-IisConfigurationSection
• ✔ Test-IisSecurityAuthentication
• ✔ Test-IisWebsite
• ✔ Uninstall-IisAppPool
• ✔ Uninstall-IisWebsite
• ✔ Unlock-IisConfigurationSection
• ❌ Write-IisVerbose

Carbon.INI

• Remove-IniEntry
• Set-IniEntry
• Split-Ini

Carbon.InternetExplorer

• Disable-IEEnhancedSecurityConfiguration
• Enable-IEActivationPermission

Carbon.MSMQ

• Get-MsmqMessageQueue
• Get-MsmqMessageQueuePath
• Grant-MsmqMessageQueuePermission
• Install-Msmq
• Install-MsmqMessageQueue
• Reset-MsmqQueueManagerID
• Test-MsmqMessageQueue
• Uninstall-MsmqMessageQueue

Carbon.Networking

• Get-IPAddress
• Get-PathToHostsFile
• Remove-HostsEntry
• Reset-HostsFile
• Set-HostsEntry
• Test-IPAddress

Carbon.PerformanceCounters

• Get-PerformanceCounter
• Install-PerformanceCounter
• Test-PerformanceCounter
• Test-PerformanceCounterCategory
• Uninstall-PerformanceCounterCategory

✔ Carbon.Registry

• ✔ Get-Permission (as Get-CRegistryKeyPermission)
• ✔️ Get-RegistryKeyValue
• ✔ Grant-Permission (as Grant-CRegistryKeyPermission)
• ✔️ Install-RegistryKey
• ✔️ Remove-RegistryKeyValue
• ✔ Revoke-Permission (as Revoke-CRegistryKeyPermission)
• ✔️ Set-RegistryKeyValue
• ✔ Test-Permission (as Test-CRegistryKeyPermission)
• ✔️ Test-RegistryKeyValue

✔️ Carbon.ScheduledTasks

• ✔️ Get-ScheduledTask
• ✔️ Install-ScheduledTask
• ✔️ Test-ScheduledTask
• ✔️ Uninstall-ScheduledTask

✔ Carbon.Security

• ❌ ConvertTo-ContainerInheritanceFlags
• ❌ ConvertTo-InheritanceFlag
• ❌ ConvertTo-PropagationFlag
• ❌ ConvertTo-ProviderAccessControlRights
• ✔ Get-Permission (file system/registry functionality only)
• ✔ Get-Privilege
• ✔ Grant-Permission (file system/registry functionality only)
• ✔ Grant-Privilege
• ✔ Revoke-Permission (file system/registry functionality only)
• ✔ Revoke-Privilege
• ❌ Set-CryptoKeySecurity (moved to Carbon.Cryptography)
• ✔ Test-Permission (file system/registry functionality only)
• ✔ Test-CPrivilege

Carbon.Windows.Features

• Assert-WindowsFeatureFunctionsSupported
• Get-WindowsFeature
• Install-WindowsFeature
• Resolve-WindowsFeatureName
• Test-WindowsFeature
• Uninstall-WindowsFeature

Carbon.Windows.Firewall

• Assert-FirewallConfigurable
• Disable-FirewallStatefulFtp
• Enable-FirewallStatefulFtp
• Get-FirewallRule
• Test-FirewallStatefulFtp

⏳ Carbon.Windows.HTTPServer

In progress.

• Get-HttpUrlAcl
• ✔ Get-SslCertificateBinding (as Get-CHttpsCertificateBinding)
• Grant-HttpUrlPermission
• ✔ Remove-SslCertificateBinding (as Remove-CHttpsCertificateBinding)
• Revoke-HttpUrlPermission
• ✔ Set-SslCertificateBinding (as Set-CHttpsCertificateBinding)
• ✔ Test-SslCertificateBinding (as Test-CHttpsCertificateBinding)

✔ Carbon.Windows.Installer

Complete.

• ✔ Get-Msi
• ✔ Get-ProgramInstallInfo
• ✔ Install-Msi

Carbon.Windows.Services

• Assert-Service
• Get-ServiceAcl
• Get-ServiceConfiguration
• Get-ServicePermission
• Get-ServiceSecurityDescriptor
• Grant-ServiceControlPermission
• Grant-ServicePermission
• Install-Service
• Restart-RemoteService
• Revoke-ServicePermission
• Set-ServiceAcl
• Test-Service
• Uninstall-Service

Carbon.WinRM

• Add-TrustedHost
• Clear-TrustedHost
• Get-TrustedHost
• Set-TrustedHost

Carbon.XDT

• Convert-XmlFile

Carbon.Zip

• Compress-Item
• Expand-Item
• Test-ZipFile

[tgillitzer]

@splatteredbits Appreciate the work on Carbon. Can you clarify where this is at today? I know some of these separate packages have been created, but also some of these commands remain on the main Carbon project, which can lead to confusion/mistakes/etc.

Also, none of the documentation seems to mention the separate packages (or even the rename of all the commands to include the "C" prefix).

If its something I could help with, I'd be happy to help.

Thanks

[splatteredbits]

@tgillitzer

Can you clarify where this is at today?

I've updated the issue description to show which modules are in progress (⏳) and which are complete (✅). Anything not marked/labeled haven't been started. We only start migrating to a new module when something at work needs new functionality and/or needs to support PowerShell 7+. We never get a chance to work on this in our spare time.

but also some of these commands remain on the main Carbon project, which can lead to confusion/mistakes/etc

This is to maintain backwards-compatibility. If we remove commands from Carbon, we have to release a new major version. Since so many commands are getting migrated, we'd probably be at version 8 or 9 by now. If/when we need to release a new major version of Carbon (v3), that's when we'd take the time to remove all the old commands.

Can you give me more information about what is causing confusion? What mistakes have been made? If we were to release a new major version of Carbon with all the migrated commands gone, how would that affect you? How often would you like to see new major versions with migrated commands removed? Every months? Quarter? Half? Year? Or when some other milestone gets met?

none of the documentation seems to mention the separate packages (or even the rename of all the commands to include the "C" prefix)

Where should we put this information? Where did you go looking for it? What documentation are you looking at?

If its something I could help with, I'd be happy to help.

Was there a specific area you'd like to help on?

[splatteredbits]

• Renamed Carbon.Permissions module to Carbon.Security.
• Migrated Get/Grant/Revoke/Test-CPrivlege functions from Carbon.Accounts to Carbon.Security.
• Updated a bunch of "completed" checkmarks to be "in progress" hour glasses because they aren't done.
• Marked Get/Grant/Revoke/Test-CPrivateKeyPermission functions as in progress.

[splatteredbits]

Marked Get/Grant/Revoke/Test-CPrivilege functions as in-progress.

[splatteredbits]

Updated to show progress.

• Carbon.DSC completed.
• More progress on Carbon.Accounts.
• Carbon.Security completed.
• Carbon.ScheduledTasks completed.
• Carbon.Registry completed.
• Permission functions added to Carbon.FileSystem.
• Carbon.Cryptography completed (private key permission functions added).