WinRegOps

Author(s)

• LarryWisherMan

Tags

Windows Registry RemoteRegistry ProfileManagement SystemConfiguration RegistryOperations Automation PowerShell

Functions

Backup-RegistryKey Export-RegistryKey Get-RegistrySubKey Get-RegistryValue Get-RegistryValueKind Get-RegistryValueNames New-RegistryKeyValuesObject Open-RegistryKey Remove-RegistrySubKey Remove-RegistrySubKeyTree

Dependencies

• • WisherTools.Helpers (>= 0.2.0)

Release Notes

## [0.4.0-preview0004] - 2024-09-24

### Added

- `Get-RegistrySubKey` to replace `Open-RegistrySubKey`. This implementation follows
the .net class better

- `Invoke-DeleteSubKey` and `Invoke-DeleteSubKeyTree` private functions for removing
subkeys

- `Remove-RegistrySubKey` and `Removing-RegistryKeyTree` public
public implementation

- New Private function `Get-RegistrySubKeyOperation` for managing the logic of
opening a key or using an existing one provided in `Remove-RegistrySubKey`

- **`New-RegistryKeyValuesObject`**:
 - Retrieves and exports all the values of a specified registry key or subkey
 into a custom object. The object includes the registry path, backup date, user,
  computer name, and a dictionary of the key's values (including data type and value).

 - Supports backing up both root keys and subkeys.

- **`Get-RegistryValueNames`**:
 - Retrieves all the value names from a specified registry key. This function
 simplifies the process of listing all registry values for a given key.

- **`Get-RegistryValueKind`**:
 - Retrieves the type (kind) of a specified registry key value. This allows for
  easy identification of value types such as `String`, `DWord`, and `Binary`
   within registry keys.

### Fixed

- Error Handling for `[System.Security.SecurityException]` in `Open-RegistryKey`

### Changed

- `Get-RegistrySubKey` includes an alias for `Open-RegistrySubKey` to for compatibility
- `Open-RegistryKey` too make `-RegistryPath` optional to return the root hive