Project

PowerBGInfo

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

View on GitHub Releases Get package
Stars 312
Forks 27
PowerShell Gallery downloads 612,914
Release v2.0.3
Language: C# Updated: 2026-09-02

API Reference

Command

New-BGInfoConfiguration

Namespace PowerBGInfo
Inputs
None
Outputs
PowerBGInfo.BgInfoConfiguration

Creates a BGInfo configuration object.

Remarks

Use this to build reusable configurations that can be exported to JSON.

Examples

Authored help example

EXAMPLE 1


New-BGInfoConfiguration -FilePath 'C:\Path'

Common Parameters

This command supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable.

For more information, see about_CommonParameters.

Syntax

New-BGInfoConfiguration [-AllUsers] [-BackgroundColor <Object>] [-ChartLayout <Manual|Stack>] [-Charts <BgInfoChart[]>] [-ChartStackAlignToTextBlock] [-ChartStackAnchor <TopLeft>] [-ChartStackDirection <Vertical|Horizontal>] [-ChartStackOffsetX <Int32>] [-ChartStackOffsetY <Int32>] [-ChartStackOutsideTextBlock] [-ChartStackSpacing <Int32>] [-Color <Object>] [-ConfigurationDirectory <String>] [-DisableWallpaperRefresh] [-DisableWallpaperSlideshow] [-Entries <BgInfoEntry[]>] [-ExcludeDefaultUserProfile] [-FilePath <String>] [-FontFamilyName <String>] [-FontSize <Single>] [-Images <BgInfoImage[]>] [-MonitorIndex <Int32>] [-OutputFileName <String>] [-PositionX <Single>] [-PositionY <Single>] [-SpaceBetweenColumns <Int32>] [-SpaceBetweenLines <Int32>] [-SpaceX <Int32>] [-SpaceY <Int32>] [-Target <Wallpaper|LogonScreen|Both|File>] [-TextPosition <TopLeft>] [-Topologies <BgInfoTopology[]>] [-UseScreenCoordinates] [-ValueColor <Object>] [-ValueFontFamilyName <String>] [-ValueFontSize <Single>] [-ValueWrapWidth <Int32>] [-Variables <BgInfoVariable[]>] [-VisualCanvases <BgInfoVisualCanvas[]>] [-WallpaperFit <Center>] [<CommonParameters>]
#
Parameter set: All Parameter Sets

Parameters

AllUsers SwitchParameter optionalposition: namedpipeline: False
Apply wallpaper for all user profiles.
BackgroundColor Object optionalposition: namedpipeline: False
Background color to use when no wallpaper image is available.
ChartLayout BgInfoChartLayoutMode optionalposition: namedpipeline: Falsevalues: 2
Chart layout mode.
Possible values: Manual, Stack
Charts BgInfoChart[] optionalposition: namedpipeline: False
Charts to include in the configuration.
ChartStackAlignToTextBlock SwitchParameter optionalposition: namedpipeline: False
Align stacked charts to the text block.
ChartStackAnchor BgInfoTextPosition optionalposition: namedpipeline: Falsevalues: 9
Anchor used when stacking charts.
Possible values: TopLeft, TopCenter, TopRight, MiddleLeft, MiddleCenter, MiddleRight, BottomLeft, BottomCenter, BottomRight
ChartStackDirection BgInfoChartStackDirection optionalposition: namedpipeline: Falsevalues: 2
Direction used when stacking charts.
Possible values: Vertical, Horizontal
ChartStackOffsetX Int32 optionalposition: namedpipeline: False
Horizontal offset for stacked charts.
ChartStackOffsetY Int32 optionalposition: namedpipeline: False
Vertical offset for stacked charts.
ChartStackOutsideTextBlock SwitchParameter optionalposition: namedpipeline: False
Place stacked charts outside of the text block.
ChartStackSpacing Int32 optionalposition: namedpipeline: False
Spacing between stacked charts.
Color Object optionalposition: namedpipeline: False
Default label color.
ConfigurationDirectory String optionalposition: namedpipeline: False
Output directory for generated BGInfo images.
DisableWallpaperRefresh SwitchParameter optionalposition: namedpipeline: False
Disable wallpaper refresh (keep old behavior).
DisableWallpaperSlideshow SwitchParameter optionalposition: namedpipeline: False
Disable automatic preservation of the current Windows wallpaper slideshow.
Entries BgInfoEntry[] optionalposition: namedpipeline: False
Entries to include in the configuration.
ExcludeDefaultUserProfile SwitchParameter optionalposition: namedpipeline: False
Exclude the default user profile when applying to all users.
FilePath String optionalposition: namedpipeline: False
Optional base wallpaper file path.
FontFamilyName String optionalposition: namedpipeline: False
Default label font family.
FontSize Single optionalposition: namedpipeline: False
Default label font size.
Images BgInfoImage[] optionalposition: namedpipeline: False
Image overlays to include in the configuration.
MonitorIndex Int32 optionalposition: namedpipeline: False
Monitor index to target for wallpaper operations.
OutputFileName String optionalposition: namedpipeline: False
Optional output file name for the generated image.
PositionX Single optionalposition: namedpipeline: False
Legacy position X placeholder.
PositionY Single optionalposition: namedpipeline: False
Legacy position Y placeholder.
SpaceBetweenColumns Int32 optionalposition: namedpipeline: False
Spacing between label and value columns.
SpaceBetweenLines Int32 optionalposition: namedpipeline: False
Vertical spacing between rows.
SpaceX Int32 optionalposition: namedpipeline: False
X padding used for layout positioning.
SpaceY Int32 optionalposition: namedpipeline: False
Y padding used for layout positioning.
Target BgInfoTarget optionalposition: namedpipeline: Falsevalues: 4
Output target (Wallpaper, File, LogonScreen, or Both).
Possible values: Wallpaper, LogonScreen, Both, File
TextPosition BgInfoTextPosition optionalposition: namedpipeline: Falsevalues: 9
Layout anchor position.
Possible values: TopLeft, TopCenter, TopRight, MiddleLeft, MiddleCenter, MiddleRight, BottomLeft, BottomCenter, BottomRight
Topologies BgInfoTopology[] optionalposition: namedpipeline: False
Topology diagrams to include in the configuration.
UseScreenCoordinates SwitchParameter optionalposition: namedpipeline: False
Use screen coordinates for layout positioning.
ValueColor Object optionalposition: namedpipeline: False
Default value color.
ValueFontFamilyName String optionalposition: namedpipeline: False
Default value font family.
ValueFontSize Single optionalposition: namedpipeline: False
Default value font size.
ValueWrapWidth Int32 optionalposition: namedpipeline: False
Maximum width used when wrapping value text. Set to 0 to disable wrapping.
Variables BgInfoVariable[] optionalposition: namedpipeline: False
Variables to include in the configuration.
VisualCanvases BgInfoVisualCanvas[] optionalposition: namedpipeline: Falsealiases: VisualCanvas
Visual canvas overlays to include in the configuration.
WallpaperFit DesktopWallpaperPosition optionalposition: namedpipeline: Falsevalues: 6
Wallpaper fit mode used after generation.
Possible values: Center, Tile, Stretch, Fit, Fill, Span

Outputs

PowerBGInfo.BgInfoConfiguration