# New-ImageTopologyGroup

Creates a topology group 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.TopologyGroup`

Creates a topology group definition.

## Syntax

```
New-ImageTopologyGroup
[-Color <String>]
[-Height <Double>]
[-Href <String>]
[-IconId <String>]
[-Id] <String>
[-Label] <String>
[-Latitude <Double>]
[-LayoutPolicy <TopologyGroupLayoutPolicy>]
[-Longitude <Double>]
[-Status <Healthy|Warning|Critical|Unknown|Disabled>]
[-Subtitle <String>]
[-Symbol <String>]
[-Tooltip <String>]
[-Width <Double>]
[-X <Double>]
[-Y <Double>]
[<CommonParameters>]
```

[#](#method-new-imagetopologygroup-string-double-string-string-string-string-double-topologygrouplayoutpolicy-double-topologyhealthstatus-string-string-string-double-double-double)

Parameter set: `All Parameter Sets`

## Description

Use this cmdlet inside New-ImageTopology to describe a logical region or cluster.

## Examples

### Create a site group

```powershell
New-ImageTopologyGroup -Id site-a -Label 'Site A' -Status Healthy -Symbol region
```

Creates a ChartForgeX topology group that can contain topology nodes.

## Parameters

**-Color String optional**

Optional group accent color as a CSS hex color.

**-Height Double optional**

Group 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 group identifier.

**-Label String requiredposition: 1**

Group label rendered in the diagram.

**-Latitude Double optional**

Optional group latitude for geographic layouts.

**-LayoutPolicy TopologyGroupLayoutPolicy optional**

Preferred node arrangement policy for dense grouped layouts.

Possible values: `Auto`, `HubAndBranch`, `Grid`, `PairRows`, `MiniMesh`, `CollapsedDots`

**-Longitude Double optional**

Optional group longitude for geographic layouts.

**-Status TopologyHealthStatus optional**

Group health or state.

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

**-Subtitle String optional**

Optional group subtitle.

**-Symbol String optional**

Short symbol rendered near the group header.

**-Tooltip String optional**

Optional tooltip for SVG and HTML outputs.

**-Width Double optional**

Group 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:63A22BB8C0FEBFE24F8CA491DFFCD186B3FB2A3AF24A7C3D50F1170CE53563BD -->
