# New-ImageMetricCard

Creates a dashboard metric card. Review available syntax, parameters, pipeline guidance, and reference details in ImagePlayground API Reference.

Project

ImagePlayground

Automate image processing, codes, metadata, charts, topology, and visual stories from PowerShell.

[View on GitHub](https://github.com/EvotecIT/ImagePlayground) [Visit Website](#) [Releases](https://github.com/EvotecIT/ImagePlayground/releases) [Changelog](#) [Get package](https://www.powershellgallery.com/packages/ImagePlayground)

Stars **102**

Forks **7**

Open issues 

Total downloads **708,853**

Release **ImagePlayground-PowerShellModule.v3.2.7**

Language: C# Updated: 2026-11-18

Command 

**Module**

`ImagePlayground`

**Inputs**

`None`

**Outputs**

`ChartForgeX.VisualBlocks.MetricCard`

Creates a dashboard metric card.

## Syntax

```
New-ImageMetricCard
[-Caption <String>]
[-Format <String>]
[-Height <Int32>]
[-Icon <VisualIcon>]
[-Label] <String>
[-MiniChart <Sparkline|Bars>]
[-MiniColor <ChartColor>]
[-MiniValues <Double[]>]
[-NoCard]
[-Status <Neutral|Positive|Warning|Negative|Info>]
[-Theme <ChartTheme>]
[-Transparent]
[-Trend <String>]
[-Unit <String>]
[-Value] <Object>
[-Width <Int32>]
[<CommonParameters>]
```

[#](#method-new-imagemetriccard-string-string-int32-visualicon-string-string-chartcolor-double-switchparameter-visualstatus-charttheme-switchparameter-string-string-object-int32)

Parameter set: `All Parameter Sets`

## Description

The returned ChartForgeX block can be composed by New-ImageVisualGrid or New-ImageVisualStory.

## Examples

### Create a metric card with a sparkline

```powershell
New-ImageMetricCard -Label 'Requests' -Value 12840 -Trend '+12%' -Status Positive -MiniValues 8200,9400,10100,12840
```

## Parameters

**-Caption String optional**

Optional supporting caption.

**-Format String optional**

Optional numeric or date format string.

**-Height Int32 optional**

Card height in pixels.

**-Icon VisualIcon optional**

Built-in metric icon.

Possible values: `ForkKnife`, `Flame`, `Lightning`, `Droplet`, `Runner`, `Bicycle`, `Person`

**-Label String requiredposition: 0**

Metric label.

**-MiniChart String optional**

Mini chart kind.

Possible values: `Sparkline`, `Bars`

**-MiniColor ChartColor optional**

Optional mini chart color.

**-MiniValues Double[] optional**

Values used by the optional mini chart.

**-NoCard SwitchParameter optional**

Hide the card surface.

**-Status VisualStatus optional**

Semantic metric status.

Possible values: `Neutral`, `Positive`, `Warning`, `Negative`, `Info`

**-Theme ChartTheme optional**

ChartForgeX theme.

Possible values: `Default`, `Dark`, `Light`, `Colorblind`, `Aurora`, `Editorial`, `Candy`, `PeopleInfographic`, `Terminal`, `TransparentOverlayDark`, `Minimal`, `DashboardLight`, `SaasDashboardLight`, `RestaurantDashboardLight`

**-Transparent SwitchParameter optional**

Use a transparent card background.

**-Trend String optional**

Optional trend text.

**-Unit String optional**

Optional unit displayed beside the value.

**-Value Object requiredposition: 1**

Metric value.

**-Width Int32 optional**

Card width in pixels.

## 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](https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_commonparameters).

Evotec API Reference Copyright 2026 Evotec Services

<!-- PowerForge markdown artifact sha256:805DCC771B89E98F631828138BE2FC8D661FE0AFB3F2A12D3D0A89A3147D96BD -->
