Project

PowerBGInfo

Generate support-ready Windows desktop and logon backgrounds from PowerShell data, charts, and topology.

Stars310
Forks27
Open issues0
PowerShell Gallery downloads612914
Releasev2.0.1
Language: C# Updated: 2026-08-09T12:24:58.0000000+00:00

Curated Examples

Export and deploy a PowerBGInfo configuration

Separate PowerBGInfo layout authoring from scheduled or RMM execution.

Export a reviewed layout to JSON when deployment should not carry a long inline script.

$configPath = 'C:\ProgramData\PowerBGInfo\workstation.json'

New-BGInfo {
    New-BGInfoValue -BuiltinValue HostName -Name 'Machine'
    New-BGInfoValue -BuiltinValue FullUserName -Name 'User'
    New-BGInfoValue -BuiltinValue OSName -Name 'Operating system'
    New-BGInfoValue -Name 'Support' -Value 'helpdesk@contoso.com'
} -MonitorIndex 0 `
    -Target File `
    -ConfigurationDirectory 'C:\ProgramData\PowerBGInfo' `
    -JsonPath $configPath `
    -ExportOnly

Invoke-BGInfo -Path $configPath

Keep the JSON beside the deployment policy, test with file output first, and run the final user or system target from the appropriate security context.