Project

PSWriteHTML

Generate HTML reports, dashboards, and emails from PowerShell without writing HTML, CSS, or JavaScript.

Stars 1,019
Forks 115
Open issues 54
PowerShell Gallery downloads 7,576,901
Release v1.41.0
Language: PowerShell Updated: 2026-10-03
Command

New-HTMLSummaryItem

Module PSWriteHTML

Creates a new HTML summary item with specified parameters.

Syntax

New-HTMLSummaryItem [-IconColor <String>] [-IconSize <Int32>] [-IconSolid <String>] [[-NestedItems] <ScriptBlock>] [-Open] [-Text <String>] [<CommonParameters>]
#
Parameter set: FontAwesomeSolid
New-HTMLSummaryItem [-IconColor <String>] [-IconRegular <String>] [-IconSize <Int32>] [[-NestedItems] <ScriptBlock>] [-Open] [-Text <String>] [<CommonParameters>]
#
Parameter set: FontAwesomeRegular
New-HTMLSummaryItem [-IconBrands <String>] [-IconColor <String>] [-IconSize <Int32>] [[-NestedItems] <ScriptBlock>] [-Open] [-Text <String>] [<CommonParameters>]
#
Parameter set: FontAwesomeBrands

Description

This function creates a new HTML summary item with customizable text, icons, and other visual properties.

Examples

Authored help example

EXAMPLE 1

New-HTMLSummaryItem -Text "Summary Item 1" -IconBrands "fa-windows" -IconSize 2 -IconColor "blue" -Open

Creates a new HTML summary item with the text "Summary Item 1", using the Windows icon brand, a size of 2, blue color, and initially open.

EXAMPLE 2

New-HTMLSummaryItem -Text "Summary Item 2" -IconRegular "fa-address-book" -IconSize 3 -IconColor "green"

Creates a new HTML summary item with the text "Summary Item 2", using the address book regular icon, a size of 3, and green color.

Parameters

-IconColor String optional
Specifies the color of the icon in the summary item.
-IconSize Int32 optional
Specifies the size of the icon in the summary item.
-IconSolid String optionalsets: FontAwesomeSolid
ICON SOLID
-NestedItems ScriptBlock optionalposition: 0
Specifies the nested items to include within the summary item.
-Open SwitchParameter optional
Indicates whether the summary item should be initially open or closed.
-Text String optional
Specifies the text content of the summary item.
-IconRegular String optionalsets: FontAwesomeRegular
Specifies the regular icon to use for the summary item. Valid values are retrieved from the available FontAwesome regular icons.
-IconBrands String optionalsets: FontAwesomeBrands
Specifies the icon brand to use for the summary item. Valid values are retrieved from the available FontAwesome brands.

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.