Project

PSWriteHTML

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

View on GitHub Releases Get package
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-HTMLStatusItem

Module PSWriteHTML
Inputs
None
Outputs
System.Object

New-HTMLStatusItem [-Name <string>] [-Status <string>] [-Icon <Object>] [-Percentage <string>] [-FontColor <string>] [<CommonParameters>]

Syntax

New-HTMLStatusItem [-FontColor <String>] [-Icon <Dead|Bad|Good>] [-Name <String>] [-Percentage <0%|10%|30%|70%|100%>] [-Status <String>] [<CommonParameters>]
#
Parameter set: Statusimo
New-HTMLStatusItem [-BackgroundColor <String>] [-FontColor <String>] [-IconHex <String>] [-Name <String>] [-Status <String>] [<CommonParameters>]
#
Parameter set: Hex
New-HTMLStatusItem [-BackgroundColor <String>] [-FontColor <String>] [-IconSolid <String>] [-Name <String>] [-Status <String>] [<CommonParameters>]
#
Parameter set: FontAwesomeSolid
New-HTMLStatusItem [-BackgroundColor <String>] [-FontColor <String>] [-IconRegular <String>] [-Name <String>] [-Status <String>] [<CommonParameters>]
#
Parameter set: FontAwesomeRegular
New-HTMLStatusItem [-BackgroundColor <String>] [-FontColor <String>] [-IconBrands <String>] [-Name <String>] [-Status <String>] [<CommonParameters>]
#
Parameter set: FontAwesomeBrands

Description

New-HTMLStatusItem [-Name <string>] [-Status <string>] [-Icon <Object>] [-Percentage <string>] [-FontColor <string>] [<CommonParameters>]

New-HTMLStatusItem [-Name <string>] [-Status <string>] [-FontColor <string>] [-BackgroundColor <string>] [-IconHex <string>] [<CommonParameters>]

New-HTMLStatusItem [-Name <string>] [-Status <string>] [-FontColor <string>] [-BackgroundColor <string>] [-IconSolid <string>] [<CommonParameters>]

New-HTMLStatusItem [-Name <string>] [-Status <string>] [-FontColor <string>] [-BackgroundColor <string>] [-IconRegular <string>] [<CommonParameters>]

New-HTMLStatusItem [-Name <string>] [-Status <string>] [-FontColor <string>] [-BackgroundColor <string>] [-IconBrands <string>] [<CommonParameters>]

Examples

Authored help example

EXAMPLE 1

New-HTMLStatusItem -Name 'Name'

Parameters

-FontColor String optional
-Icon Object optionalsets: Statusimo
Possible values: Dead, Bad, Good
-Name String optionalaliases: ServiceName
-Percentage String optionalsets: Statusimo
Possible values: 0%, 10%, 30%, 70%, 100%
-Status String optionalaliases: ServiceStatus
-BackgroundColor String optionalsets: Hex, FontAwesomeSolid, FontAwesomeRegular, FontAwesomeBrands
-IconHex String optionalsets: Hex
-IconSolid String optionalsets: FontAwesomeSolid
-IconRegular String optionalsets: FontAwesomeRegular
-IconBrands String optionalsets: FontAwesomeBrands

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.