Project

ImagePlayground

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

Stars 101

Forks 7

Total downloads 711,982

Release ImagePlayground-PowerShellModule.v3.2.7

Language: C# Updated: 2026-10-26

Command

New-ImageTopologyNode

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>]

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

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.