Project

PowerBGInfo

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

Stars 312
Forks 27
PowerShell Gallery downloads 612,914
Release v2.0.3
Language: C# Updated: 2026-09-02

API Reference

Command

New-BGInfoValue

Namespace PowerBGInfo
Inputs
None
Outputs
PowerBGInfo.BgInfoEntry

Creates a BGInfo value entry.

Remarks

Creates a BGInfo value entry.

Examples

Authored help example

EXAMPLE 1


New-BGInfoValue -Name 'Name' -Value 'Value'
        

EXAMPLE 2


New-BGInfoValue -BuiltinValue 'Value'
        

EXAMPLE 3


New-BGInfoValue -Name 'Name' -Value 'Value' -ForEach 'Value'
        

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-BGInfoValue [-Color <Object>] [-FontFamilyName <String>] [-FontSize <Single>] -Name <String> -Value <String> [-ValueColor <Object>] [-ValueFontFamilyName <String>] [-ValueFontSize <Single>] [<CommonParameters>]
#
Parameter set: Values

Parameters

Color Object optionalposition: namedpipeline: False
Label color override.
FontFamilyName String optionalposition: namedpipeline: False
Label font family override.
FontSize Single optionalposition: namedpipeline: False
Label font size override.
Name String requiredposition: namedpipeline: False
Label text to render.
Value String requiredposition: namedpipeline: False
Explicit value to render.
ValueColor Object optionalposition: namedpipeline: False
Value color override.
ValueFontFamilyName String optionalposition: namedpipeline: False
Value font family override.
ValueFontSize Single optionalposition: namedpipeline: False
Value font size override.

Outputs

PowerBGInfo.BgInfoEntry

New-BGInfoValue -BuiltinValue <UserName> [-Color <Object>] [-FontFamilyName <String>] [-FontSize <Single>] -Name <String> [-ValueColor <Object>] [-ValueFontFamilyName <String>] [-ValueFontSize <Single>] [<CommonParameters>]
#
Parameter set: Builtin

Parameters

BuiltinValue String requiredposition: namedpipeline: Falsevalues: 23
Built-in token to resolve to a value.
Possible values: UserName, HostName, FullUserName, CpuName, CpuMaxClockSpeed, CpuCores, CpuLogicalCores, RAMSize, RAMSpeed, RAMPartNumber, BiosVersion, BiosManufacturer, BiosReleaseDate, OSName, OSVersion, OSArchitecture, OSBuild, OSInstallDate, OSLastBootUpTime, UserDNSDomain, FQDN, IPv4Address, IPv6Address
Color Object optionalposition: namedpipeline: False
Label color override.
FontFamilyName String optionalposition: namedpipeline: False
Label font family override.
FontSize Single optionalposition: namedpipeline: False
Label font size override.
Name String requiredposition: namedpipeline: False
Label text to render.
ValueColor Object optionalposition: namedpipeline: False
Value color override.
ValueFontFamilyName String optionalposition: namedpipeline: False
Value font family override.
ValueFontSize Single optionalposition: namedpipeline: False
Value font size override.

Outputs

PowerBGInfo.BgInfoEntry

New-BGInfoValue [-Color <Object>] [-FontFamilyName <String>] [-FontSize <Single>] -ForEach <String> -Name <String> -Value <String> [-ValueColor <Object>] [-ValueFontFamilyName <String>] [-ValueFontSize <Single>] [<CommonParameters>]
#
Parameter set: Template

Parameters

Color Object optionalposition: namedpipeline: False
Label color override.
FontFamilyName String optionalposition: namedpipeline: False
Label font family override.
FontSize Single optionalposition: namedpipeline: False
Label font size override.
ForEach String requiredposition: namedpipeline: False
Variable name used to expand this entry multiple times.
Name String requiredposition: namedpipeline: False
Label text to render.
Value String requiredposition: namedpipeline: False
Explicit value to render.
ValueColor Object optionalposition: namedpipeline: False
Value color override.
ValueFontFamilyName String optionalposition: namedpipeline: False
Value font family override.
ValueFontSize Single optionalposition: namedpipeline: False
Value font size override.

Outputs

PowerBGInfo.BgInfoEntry