public/Get-DsRegistryValue.ps1
|
function Get-DsRegistryValue { <# .SYNOPSIS Get-DsRegistryValue .DESCRIPTION Export remote registry values .PARAMETER KeyPath Required. Registry path in PSProvider format (e.g. HKLM:SOFTWARE, not HKEY_LOCAL_MACHINE\SOFTWARE) .PARAMETER ValueName Required. Name of Registry value .PARAMETER ComputerName Optional. Names of one or more computers (comma-delimited) .PARAMETER InputFile Optional. Path\Name of file containing computer names to query .PARAMETER OutputFile Optional. Path\Name of CSV output file .PARAMETER ADGridSelect Optional. Prompt user to select computers read in from AD using a gridview listmenu .EXAMPLE $key = "HKLM:SYSTEM\CurrentControlSet\Control\SystemInformation" $val = "BIOSVersion" Get-DsRegistryValue -KeyPath $key -ValueName $val -ADGridSelect .EXAMPLE $key = "HKLM:SYSTEM\CurrentControlSet\Control\SystemInformation" $val = "BIOSVersion" Get-DsRegistryValue -KeyPath $key -ValueName $val -InputFile "c:\temp\computers.txt" .EXAMPLE $key = "HKLM:SYSTEM\CurrentControlSet\Control\SystemInformation" $val = "BIOSVersion" Get-DsRegistryValue -KeyPath $key -ValueName $val -ComputerName "DC01,DC02,DC03" .EXAMPLE $key = "HKLM:SOFTWARE\Policies\Microsoft\Windows NT\Printers\PointAndPrint" $val = "NoWarningNoElevationOnInstall" Get-DsRegistryValue -KeyPath $key -ValueName -InputFile "c:\temp\computers.txt" .NOTES 1.0.0 - 2022-08-04 - David Stein / https://github.com/Skatterbrainz .LINK https://github.com/Skatterbrainz/ds-utils/blob/master/docs/Get-DsRegistryValue.md #> [CmdletBinding()] param ( [parameter(Mandatory)][string][ValidateNotNullOrEmpty()]$KeyPath, [parameter(Mandatory)][string][ValidateNotNullOrEmpty()]$ValueName, [parameter()][string]$ComputerName = "", [parameter()][string]$InputFile = "", [parameter()][string]$OutputFile = "$($env:USERPROFILE)\documents\registry_values.csv", [parameter()][switch]$ADGridSelect ) if (![string]::IsNullOrWhiteSpace($ComputerName)) { $computers = @($ComputerName.Split(',')) } elseif (![string]::IsNullOrWhiteSpace($InputFile)) { if (Test-Path $InputFile) { $computers = Get-Content -Path $InputFile } else { Write-Warning "File not found: $InputFile" break } } elseif ($ADGridSelect) { if (Get-Module ActiveDirectory -ListAvailable) { $computers = Get-ADComputer -Filter '*' | Sort-Object Name | Select-Object -ExpandProperty Name | Out-GridView -Title "Select Computers to Query" -OutputMode Multiple } } if ($computers.Count -gt 0) { $total = $computers.Count $counter = 1 $output = @() foreach ($computer in $computers) { $response = $null $response = Invoke-Command -ComputerName $computer -ScriptBlock { $val = $null try { $val = Get-ItemProperty -Path $using:KeyPath -Name $using:ValueName -ErrorAction Stop } catch { $val = '(NotFound)' } [pscustomobject]@{ Path = $using:KeyPath Value = $using:ValueName Data = $val } } | Select-Object PSComputerName, Path, Value, Data $response $output += $response } $output | Export-Csv -Path $OutputFile -NoTypeInformation -Force Write-Host "Saved to $OutputFile" } } |