2.0.3+58

Merge pull request #8 from webmd-health-services/feature/reduce-neste…

2.0.2

Change the layout of internal nested dependencies.

2.0.1+47

Merge pull request #6 from webmd-health-services/feature/pureinvoke-u…

2.0.0

Upgrade Instructions

Dropping support for PowerShell 6. PowerShell 7 and Windows PowerShell 5.1 are still supported.

Under Microsoft patterns and practices, an "identity" is user account and a "principal" is a user or group account.
We're updating Carbon.Accounts to follow this pattern by replacing Identity with Principal in function and class
names, and error messages.

• Rename usages of function Resolve-CIdentity to Resolve-CPrincipal.
• Rename usages of function Resolve-CIdentityName to Resolve-CPrincipalName.
• Rename usages of function Test-CIdentity to Test-CPrincipal.
• Rename usages of class Carbon_Accounts_Identity to Carbon_Accounts_Principal.
• Rename usages of enum Carbon_Accounts_Identity_Type to Carbon_Accounts_Principal_Type.

If migrating from Carbon's group functions (Add-CGroupMember, Get-CGroup, Install-CGroup, Remove-CGroupMember,
Test-CGroup, Test-CGroupMember, and Uninstall-CGroup):

• Functions re-written to use PowerShell's built-in Microsoft.PowerShell.LocalAccounts module so they do not support
  running under 32-bit PowerShell on a 64-bit operating system.
• Rename usages of Install-CGroup, Add-CGroupMember, and Remove-CGroupMember function's Members parameter to
  Member.
• Remove usages of Install-CGroup function's PassThru switch. Use Get-LocalGroup instead.
• Rename usages of Test-CGroupMember function's GroupName parameter to Name.
• Install-CGroup and Add-CGroupMember no longer support adding a local group to a group and writes an error instead.
  Previously, local built-in groups were allowed to be added because the underlying Windows API allowed them, but
  functionally, Windows ignores local groups in a local group. Review usages. To check if a group is a local group, use
  Resolve-CPrincipal and if the Type property on the returned object is Alias and the group is not a domain group,
  it will cause an error.
• Rename usages of Add-CGroupMember to Install-CLocalGroupMember.
• Rename usages of Get-CGroup to Get-CLocalGroup.
• Rename usages of Install-CGroup to Install-CLocalGroup.
• Rename usages of Remove-CGroupMember to Uninstall-CLocalGroupMember.
• Rename usages of Test-CGroup to Test-CLocalGroup.
• Rename usages of Test-CGroupMember to Test-CLocalGroupMember.
• Rename usages of Uninstall-CGroup to Uninstall-CLocalGroup.

Added

• Get-CLocalGroup for getting local groups. Has support for non-wildcard lookups.
• Get-CLocalGroupMember for getting local group members.
• Install-CLocalGroup for installing local groups.
• Install-CLocalGroupMember for adding accounts to local groups.
• Test-CLocalGroup for testing if local groups exist.
• Test-CLocalGroupMember for testing if accounts are in a local group.
• Uninstall-CGroup for removing groups.
• Uninstall-CGroupMember for removing accounts from a group.

Changed

• Renamed function Resolve-CIdentity to Resolve-CPrincipal.
• Renamed function Resolve-CIdentityName to Resolve-CPrincipalName.
• Renamed function Test-CIdentity to Test-CPrincipal.
• Renamed class Carbon_Accounts_Identity to Carbon_Accounts_Principal.
• Renamed enum Carbon_Accounts_Identity_Type to Carbon_Accounts_Principal_Type.

1.0.0

Upgrade Instructions

If switching to Carbon.Accounts from Carbon, do the following:

• Remove usages of the ConnectedServer property on System.DirectoryServices.AccountManagement.Principal objects.
  That was an extended type property added by Carbon and it no longer exists.
• Remove usages of the Carbon.Identity and Carbon.IdentityType types. Carbon.Accounts now uses and returns native
  PowerShell classes and enums instead. The new native/classes enums are identical to the old compiled types, so no need
  to update object usages.

Added

• ConvertTo-CSecurityIdentifier (from Carbon).
• Resolve-CIdentity (from Carbon).
• Test-CIdentity (from Carbon).
• Resolve-CIdentityName (from Carbon).