# New-ImageVisualGridItem

Creates one chart or visual-block placement for a visual grid.

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.VisualGridItem`

Creates one chart or visual-block placement for a visual grid.

## Syntax

```
New-ImageVisualGridItem
[-Block] <IVisualBlock>
[-ColumnSpan <Int32>]
[-RowSpan <Int32>]
[-TargetId <String>]
[<CommonParameters>]
```

[#](#method-new-imagevisualgriditem-ivisualblock-int32-int32-string)

Parameter set: `Block`

```
New-ImageVisualGridItem
[-Chart] <Chart>
[-ColumnSpan <Int32>]
[-RowSpan <Int32>]
[-TargetId <String>]
[<CommonParameters>]
```

[#](#method-new-imagevisualgriditem-chart-int32-int32-string)

Parameter set: `Chart`

## Examples

### Place a metric card across two grid columns

```powershell
$card = New-ImageMetricCard -Label 'Requests' -Value 12840 -Trend '+12%'
New-ImageVisualGridItem -TargetId 'requests' -Block $card -ColumnSpan 2
```

## Parameters

**-Block IVisualBlock requiredposition: 0sets: Block**

Visual block hosted by the grid item.

**-ColumnSpan Int32 optional**

Number of grid columns occupied by the item.

**-RowSpan Int32 optional**

Number of grid rows occupied by the item.

**-TargetId String optional**

Optional stable motion target identifier.

**-Chart Chart requiredposition: 0sets: Chart**

Chart hosted by the grid item.

## 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:AD489B01B09796C6F6B0C7EC0350A71B7CD5958FF0FD69FE29AD126831246972 -->
