Project

PSWriteHTML

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

Stars 1,023
Forks 115
Open issues 54
PowerShell Gallery downloads 7,576,901
Release v1.45.0
Language: PowerShell Updated: 2026-11-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

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.