PSWriteHTML

PSWriteHTML is an open-source PowerShell project with packages, release history, and working documentation.

Stars 995

Forks 114

Open issues 69

PowerShell Gallery downloads 7,436,513

Release v1.41.0

Language: PowerShell Updated: 2026-04-11

API Reference

Function

New-TablePercentageBar

Aliases: New-HTMLTablePercentageBar

Namespace PSWriteHTML

Aliases

New-HTMLTablePercentageBar

Creates a new table percentage bar object with specified attributes.

Remarks

This function creates a new table percentage bar object with the provided attributes. It allows customization of the appearance of the percentage bar within a table.

Examples

Authored help example

EXAMPLE 1


New-TablePercentageBar -ColumnID 1 -ColumnName "Progress" -Type 'round' -TextColor "#ffffff" -BorderColor "#000000" -BorderStyle 'solid' -BarColor "#00ff00" -BackgroundColor "#ffffff" -RoundValue 2

Description: Creates a new table percentage bar object for the column "Progress" with specified attributes.

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-TablePercentageBar [-BackgroundColor <String>] [-BarColor <String>] [-BorderColor <String>] [-BorderStyle <solid|outset|groove|ridge>] [-ColumnID <Int32>] [-ColumnName <String>] [-ConditionalFormatting <ScriptBlock>] [-RoundValue <Int32>] [-TextColor <String>] [-Type <square|round>] [<CommonParameters>]

Parameter set: All Parameter Sets

Parameters

BackgroundColor String optionalposition: 8pipeline: False: Specifies the background color of the percentage bar.
BarColor String optionalposition: 7pipeline: False: Specifies the color of the percentage bar itself.
BorderColor String optionalposition: 5pipeline: False: Specifies the color of the border of the percentage bar.
BorderStyle String optionalposition: 6pipeline: Falsevalues: 4: Specifies the style of the border of the percentage bar. Valid values are 'solid', 'outset', 'groove', or 'ridge'.; Possible values: solid, outset, groove, ridge
ColumnID Int32 optionalposition: 1pipeline: False: Specifies the ID of the column where the percentage bar will be displayed.
ColumnName String optionalposition: 2pipeline: False: Specifies the name of the column where the percentage bar will be displayed.
ConditionalFormatting ScriptBlock optionalposition: 0pipeline: False: Specifies any conditional formatting rules for the percentage bar.
RoundValue Int32 optionalposition: 9pipeline: False: Specifies the decimal places to round the percentage value to.
TextColor String optionalposition: 4pipeline: False: Specifies the color of the text within the percentage bar.
Type String optionalposition: 3pipeline: Falsevalues: 2: Specifies the shape of the percentage bar. Valid values are 'square' or 'round'.; Possible values: square, round