About the PSRR Module

The module can be installed automatically by downloading the MSI package or manually by downloading a ZIP file. The MSI package will install the module under your Documents folder (%USERPROFILE%\Documents\WindowsPowerShell\Modules\PSRR). The ZIP file contains the module files only and you need to extract its content to one of two places:
  1. %USERPROFILE%\Documents\WindowsPowerShell\Modules
  2. %WINDIR%\System32\WindowsPowerShell\v1.0\Modules (need admin privileges)
  3. If the directory tree (of one of the above) doesn't exist then you should manually create it.

Prerequisites

Windows PowerShell 3.0 http://www.microsoft.com/download/en/details.aspx?id=27548


How to use the module

Check if the module is installed correctly, from your PowerShell session type:

PS > Get-Module -Name PSRR -ListAvailable

ModuleType Name                      ExportedCommands
---------- ----                      ----------------
Manifest   PSRR                      {Get-RegBinary.ps1, Get-RegDefault.ps1, Get-RegDWord.ps1, Get-RegExpandS...


If you don't see the above result then the module was not installed correctly. If you choose to download and install the module manually (zip file), make sure the module directory exists under "%USERPROFILE%\Documents\WindowsPowerShell\Modules"

The major addition to the PSRR module is the ability to manage both 64-bit and 32-bit registry keys and values by using the new View parameter (available on all module functions) from PowerShell x86 or x64 instances.

In a nutshell, the registry in 64-bit versions of Windows is divided into 32-bit and 64-bit keys. Many of the 32-bit keys have the same names as their 64-bit counterparts, and vice versa. In the 64-bit version of Registry Editor, 32-bit keys are displayed under the following registry key: HKEYLOCALMACHINE\Software\WOW6432Node.

See the help for any function on how to use the View Parameter.


Importing the module:
PS > Import-Module PSRR

NOTE An elevated PowerShell session is needed to load the module. If the session is not elevated a warning message is written to the console
and you wont be able to use any of the module’s functions.


PS > Get-Command -Module PSRR 

CommandType Name                Definition
----------- ----                ----------
Function    Get-RegBinary       ...
Function    Get-RegDefault      ...
Function    Get-RegDWord        ...
Function    Get-RegExpandString ...
Function    Get-RegKey          ...
Function    Get-RegMultiString  ...
Function    Get-RegQWord        ...
Function    Get-RegString       ...
Function    Get-RegValue        ...
Function    New-RegKey          ...
Function    Remove-RegKey       ...
Function    Remove-RegValue     ...
Function    Set-RegBinary       ...
Function    Set-RegDefault      ...
Function    Set-RegDWord        ...
Function    Set-RegExpandString ...
Function    Set-RegMultiString  ...
Function    Set-RegQWord        ...
Function    Set-RegString       ...
Function    Test-RegKey         ...
Function    Test-RegValue       ...


There is also an about_PSRR_Module help file (under the en_US folder), to review it:

PS > Get-Help about_PSRR_Module

Last edited Nov 1, 2011 at 3:21 PM by Shay, version 5