WinRegOps
0.4.0-preview0003
The module is designed to handle tasks like retrieving specific registry values, exporting registry keys, managing subkeys, and removing keys with enhanced error handling. It allows for seamless interaction with the Windows registry across various environments and use cases, such as system configuration, profile management, and application settings.
This module can be used independently or as a dependency for higher-level management modules, offering flexibility and reliability in registry operations.
Key features:
- Open registry keys (local and remote).
- Query and retrieve registry values.
- Create, delete, and backup registry keys and subkeys.
- Built-in error handling for permission issues and remote access.
- Works with multiple registry hives (e.g., HKEY_LOCAL_MACHINE, HKEY_CURRENT_USER).
Typical use cases include:
- Simplifying registry access in complex automation tasks.
- Providing a reliable registry management layer for other modules like ProfileManagement.
- Managing the lifecycle of registry keys during system configuration changes.
Minimum PowerShell version
5.1
See the version list below for details.
Installation Options
Owners
Copyright
(c) 2024 LarryWisherMan. All rights reserved.
Package Details
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-preview0003] - 2024-09-18
### 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
FileList
- WinRegOps.nuspec
- WinRegOps.psm1
- WinRegOps.psd1
- en-US\about_WinRegOps.help.txt
Version History
Version | Downloads | Last updated |
---|---|---|
0.4.0-previe... | 17 | 9/24/2024 |
0.4.0-previe... (current version) | 17 | 9/18/2024 |
0.4.0-previe... | 4 | 9/17/2024 |
0.4.0-previe... | 8 | 9/16/2024 |
0.3.0 | 27 | 9/11/2024 |
0.3.0-previe... | 2 | 9/11/2024 |
0.3.0-previe... | 8 | 9/9/2024 |
0.3.0-previe... | 2 | 9/9/2024 |
0.2.0 | 8 | 9/9/2024 |