# New-ImageTopologyNodePort

Creates a named attachment port for a topology node.

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

Creates a named attachment port for a topology node.

## Syntax

```
New-ImageTopologyNodePort
[-Id] <String>
[-Label <String>]
[-Offset <Double>]
[-Side] <Auto|Top|Right|Bottom|Left>
[<CommonParameters>]
```

[#](#method-new-imagetopologynodeport-string-string-double-topologyedgeport)

Parameter set: `All Parameter Sets`

## Examples

### Add an output port to a service node

```powershell
$port = New-ImageTopologyNodePort -Id output -Side Right -Offset 0.5 -Label Database
New-ImageTopologyNode -Id api -Label API -Kind Service -Port $port
```

Creates a port halfway along the right boundary and attaches it to the service node.

## Parameters

**-Id String requiredposition: 0**

Node-local stable port identifier.

**-Label String optional**

Optional visible or host-facing label.

**-Offset Double optional**

Normalized position along the side from zero to one.

**-Side TopologyEdgePort requiredposition: 1**

Explicit node boundary side.

Possible values: `Auto`, `Top`, `Right`, `Bottom`, `Left`

## 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:36FDA3933C7888E4A533262C0132C2EE863F585AF1C80A667845CA976E50D2FC -->
