# New-ImageTopologyNode

Creates a topology node definition. 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.Topology.TopologyNode`

Creates a topology node definition.

## Syntax

```
New-ImageTopologyNode
[-BackgroundColor <String>]
[-Badge <String>]
[-Color <String>]
[-Detail <TopologyNodeDetail[]>]
[-DisplayMode <TopologyNodeDisplayMode>]
[-GroupId <String>]
[-Height <Double>]
[-Href <String>]
[-IconId <String>]
[-Id] <String>
[-Kind <TopologyNodeKind>]
[-Label] <String>
[-Latitude <Double>]
[-Longitude <Double>]
[-Port <TopologyNodePort[]>]
[-Status <Healthy|Warning|Critical|Unknown|Disabled>]
[-Subtitle <String>]
[-Symbol <String>]
[-Tooltip <String>]
[-Width <Double>]
[-X <Double>]
[-Y <Double>]
[<CommonParameters>]
```

[#](#member-c6c02fe2903e40770836dfa8)

Parameter set: `All Parameter Sets`

## Description

Use this cmdlet inside New-ImageTopology to describe a node in a topology diagram.

## Examples

### Create an API node

```powershell
New-ImageTopologyNode -Id api -Label 'API' -Kind Service -Status Healthy -Symbol API
```

Creates a ChartForgeX topology node that can be rendered by New-ImageTopology.

## Parameters

**-BackgroundColor String optional**

Optional node fill color as a CSS hex color.

**-Badge String optional**

Optional short badge text.

**-Color String optional**

Optional node accent color as a CSS hex color.

**-Detail TopologyNodeDetail[] optional**

Typed card detail rows created by New-ImageTopologyNodeDetail.

**-DisplayMode TopologyNodeDisplayMode optional**

Optional node display mode override.

Possible values: `Card`, `CompactCard`, `Tile`, `Pill`, `Icon`, `Artwork`, `Dot`, `Hidden`

**-GroupId String optional**

Optional parent group identifier.

**-Height Double optional**

Node height in pixels.

**-Href String optional**

Optional drill-down link for SVG and HTML outputs.

**-IconId String optional**

Reusable ChartForgeX icon identifier.

**-Id String requiredposition: 0**

Stable node identifier used by topology edges.

**-Kind TopologyNodeKind optional**

Node kind used for icon and legend selection.

Possible values: `Generic`, `Group`, `Location`, `Hub`, `Branch`, `Server`, `Service`, `Endpoint`, `Gateway`, `Cloud`, `Database`, `Storage`, `Network`, `NetworkSegment`, `Namespace`, `Application`, `Process`, `Queue`, `Person`, `Team`, `Certificate`

**-Label String requiredposition: 1**

Node label rendered in the diagram.

**-Latitude Double optional**

Optional node latitude for geographic layouts.

**-Longitude Double optional**

Optional node longitude for geographic layouts.

**-Port TopologyNodePort[] optional**

Named attachment ports created by New-ImageTopologyNodePort.

**-Status TopologyHealthStatus optional**

Node health or state.

Possible values: `Healthy`, `Warning`, `Critical`, `Unknown`, `Disabled`

**-Subtitle String optional**

Optional node subtitle.

**-Symbol String optional**

Short symbol rendered inside or near the node icon.

**-Tooltip String optional**

Optional tooltip for SVG and HTML outputs.

**-Width Double optional**

Node width in pixels.

**-X Double optional**

Manual X coordinate. Automatic layouts can ignore this value.

**-Y Double optional**

Manual Y coordinate. Automatic layouts can ignore this value.

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