# New-ImageTopologyScenario

Creates an ordered topology scenario. 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.TopologyScenario`

Creates an ordered topology scenario.

## Syntax

```
New-ImageTopologyScenario
[-AutoPlay]
[-Color <String>]
[-Description <String>]
[-Id] <String>
[-Label] <String>
[-Loop]
[-Spotlight]
[-Step <TopologyScenarioStep[]>]
[-StepDefinition <ScriptBlock>]
[-StepDurationMilliseconds <Int32>]
[<CommonParameters>]
```

[#](#method-new-imagetopologyscenario-switchparameter-string-string-string-string-switchparameter-switchparameter-topologyscenariostep-scriptblock-int32)

Parameter set: `All Parameter Sets`

## Description

Scenarios drive HTML route controls, highlighted static views, and script-free SVG, GIF, and APNG route motion.

## Examples

### Create a request-flow scenario

```powershell
New-ImageTopologyScenario -Id request -Label 'Request flow' -StepDefinition { New-ImageTopologyScenarioStep -Id client-api -Kind Edge; New-ImageTopologyScenarioStep -Id api-db -Kind Edge } -AutoPlay
```

## Parameters

**-AutoPlay SwitchParameter optional**

Allow interactive HTML output to begin playback automatically.

**-Color String optional**

Optional CSS color used to accent the scenario.

**-Description String optional**

Optional scenario description.

**-Id String requiredposition: 0**

Stable scenario identifier.

**-Label String requiredposition: 1**

Scenario label shown by HTML controls.

**-Loop SwitchParameter optional**

Loop scenario playback.

**-Spotlight SwitchParameter optional**

Dim topology elements that do not participate in the scenario.

**-Step TopologyScenarioStep[] optional**

Scenario steps supplied directly.

**-StepDefinition ScriptBlock optional**

Script block that emits steps from New-ImageTopologyScenarioStep.

**-StepDurationMilliseconds Int32 optional**

Default duration of each step in milliseconds.

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