NAME

Get-RegMultiString

SYNOPSIS

Retrieves an array of null-terminated strings (REG_MULTI_SZ) from local or remote computers.

SYNTAX

Get-RegMultiString [[-ComputerName] <>] [[-Hive] <>] [-Key] <> [-Value] <> [-View] [-Ping] [<CommonParameters>]

DESCRIPTION

 

PARAMETERS

-ComputerName <String[]>

Adds a new member even the object has a custom member with the same name. You cannot use the Force parameter to replace a standard member of a type.

Required? false
Position? 1
Default value $env:COMPUTERNAME
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false

 

-Hive <String>

Adds a new member even the object has a custom member with the same name. You cannot use the Force parameter to replace a standard member of a type.

Required? false
Position? 2
Default value LocalMachine
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

 

-Key <String>

Adds a new member even the object has a custom member with the same name. You cannot use the Force parameter to replace a standard member of a type.

Required? true
Position? 3
Default value  
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

 

-Value <String>

Adds a new member even the object has a custom member with the same name. You cannot use the Force parameter to replace a standard member of a type.

Required? true
Position? 4
Default value  
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

 

-View <RegistryView>

Adds a new member even the object has a custom member with the same name. You cannot use the Force parameter to replace a standard member of a type.

Required? false
Position? named
Default value Default
Accept pipeline input? false
Accept wildcard characters? false

 

-Ping <SwitchParameter>

Adds a new member even the object has a custom member with the same name. You cannot use the Force parameter to replace a standard member of a type.

Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false

 

<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer and OutVariable. For more information, type,
"get-help about_commonparameters".

INPUTS

 

OUTPUTS

PSFanatic.Registry.RegistryValue (PSCustomObject)

NOTES

Author: Shay Levy
Blog : http://PowerShay.com

EXAMPLES

-------------------------- EXAMPLE 1 --------------------------

C:\PS>$Key = "SYSTEM\CurrentControlSet\services\LanmanServer\Shares"

Get-RegMultiString -Key $Key -Value Drivers

ComputerName Hive Key Value Data
------------ ---- --- ----- ----
COMPUTER1 LocalMachine SYSTEM\CurrentControlSet\services\LanmanServer\Shares Drivers {CSCFlags=0, MaxUses=429496729...


Description
-----------
The command gets the flags of the Drivers system shared folder from the local computer.
The name of ComputerName parameter, which is optional, is omitted.

-------------------------- EXAMPLE 2 --------------------------

C:\PS>[Environment]::Is64BitProcess

False

PS> Get-RegMultiString -Key SOFTWARE\MyKey -ComputerName Server1 -Value 64MultiString -View Registry64

ComputerName Hive Key Value Data Type
------------ ---- --- ----- ---- ----
Server1 LocalMachine SOFTWARE\MyKey 64MultiString {PowerShell, Rocks!} MultiString


Description
-----------
This command is using an elevated 32-bit instance of Windows PowerShell to read values from
a 64-bit registry section of a remote 64-bit server. First we verify that the current console
is a 32-bit instance by using the Is64BitProcess system environment variable.

Connecting to the 64-bit section of the remote server registry is done using the View
parameter.

-------------------------- EXAMPLE 3 --------------------------

C:\PS>"DC1","DC2" | Get-RegMultiString -Key $Key -Value Sysvol -Ping

ComputerName Hive Key Value Data
------------ ---- --- ----- ----
DC1 LocalMachine SYSTEM\CurrentControlSet\services\LanmanServer\Shares Sysvol {CSCFlags=256, MaxUses=429496...
DC2 LocalMachine SYSTEM\CurrentControlSet\services\LanmanServer\Shares Sysvol {CSCFlags=256, MaxUses=429496...

Description
-----------
The command gets the flags of the Sysvol system shared folder from two DC computers.
When the Switch parameter Ping is specified the command issues a ping test to each computer.
If the computer is not responding to the ping request a warning message is written to the console and the computer is not processed.

-------------------------- EXAMPLE 4 --------------------------

C:\PS>Get-Content servers.txt | Get-RegMultiString -Key $Key -Value Sysvol

ComputerName Hive Key Value Data
------------ ---- --- ----- ----
DC1 LocalMachine SYSTEM\CurrentControlSet\services\LanmanServer\Shares Sysvol {CSCFlags=256, MaxUses=429496...
DC2 LocalMachine SYSTEM\CurrentControlSet\services\LanmanServer\Shares Sysvol {CSCFlags=256, MaxUses=429496...

Description
-----------
The command uses the Get-Content cmdlet to get the DC names from a text file.

RELATED LINKS

http://psrr.codeplex.com
Set-RegMultiString
Get-RegValue
Remove-RegValue
Test-RegValue

Last edited Jun 11, 2012 at 12:45 PM by Shay, version 3

Comments

No comments yet.