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-HTMLListItem

Module: PSWriteHTML

Creates a new HTML list item with customizable styling options.

Syntax

New-HTMLListItem
[-Alignment <left|center|right|justify>]
[[-BackGroundColor] <String[]>]
[[-Color] <String[]>]
[-Direction <rtl>]
[-FontFamily <String[]>]
[-FontSize <Object[]>]
[-FontStyle <normal|italic|oblique>]
[-FontVariant <normal|small-caps>]
[-FontWeight <String[]>]
[-LineBreak]
[[-NestedListItems] <ScriptBlock>]
[[-Text] <String[]>]
[-TextDecoration <line-through|overline|underline>]
[-TextTransform <uppercase|lowercase|capitalize>]
[<CommonParameters>]

Parameter set: All Parameter Sets

Description

The New-HTMLListItem function generates an HTML list item with various styling options such as text color, background color, font size, font weight, alignment, and more.

Examples

Example 1

New-HTMLListItem -Text 'Item 1' -Color 'blue' -FontSize '12px' -FontWeight 'bold' -Alignment 'center'
Creates an HTML list item with the text 'Item 1' in blue color, font size of 12 pixels, bold font weight, and centered alignment.

Example 2

New-HTMLListItem -Text 'Item 2' -FontFamily 'Arial' -TextDecoration 'underline' -Direction 'rtl'
Creates an HTML list item with the text 'Item 2' in Arial font family, underlined text decoration, and right-to-left direction.

Parameters

-Alignment String[] optional: Specifies the alignment of the text within the list item. Valid values are 'left', 'center', 'right', and 'justify'.; Possible values: left, center, right, justify
-BackGroundColor String[] optionalposition: 3: Specifies the background color of the list item.
-Color String[] optionalposition: 2: Specifies the color of the text in the list item.
-Direction String[] optional: Specifies the direction of the text. Valid value is 'rtl' (right-to-left).; Possible values: rtl
-FontFamily String[] optional: Specifies the font family for the text in the list item.
-FontSize Object[] optional: Specifies the font size of the text in the list item.
-FontStyle String[] optional: Specifies the style of the font. Valid values are 'normal', 'italic', and 'oblique'.; Possible values: normal, italic, oblique
-FontVariant String[] optional: Specifies the variant of the font. Valid values are 'normal' and 'small-caps'.; Possible values: normal, small-caps
-FontWeight String[] optional: Specifies the weight of the font. Valid values include 'normal', 'bold', 'bolder', 'lighter', and numeric values from 100 to 900.; Possible values: normal, bold, bolder, lighter, 100, 200, 300, 400, 500, 600, 700, 800, 900
-LineBreak SwitchParameter optional: Indicates whether to include a line break after the list item.
-NestedListItems ScriptBlock optionalposition: 0: Specifies the nested list items to be included within the current list item.
-Text String[] optionalposition: 1: Specifies the text content of the list item.
-TextDecoration String[] optional: Specifies the decoration of the text. Valid values are 'none', 'line-through', 'overline', and 'underline'.; Possible values: line-through, overline, underline
-TextTransform String[] optional: Specifies the transformation of the text. Valid values are 'uppercase', 'lowercase', and 'capitalize'.; Possible values: uppercase, lowercase, capitalize

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.