Select-ImageConsoleStoryTab

Namespace ImagePlayground

Inputs

None

Outputs

ImagePlayground.PowerShell.ImageConsoleStoryStep

Switches an ImagePlayground console story to a previously declared persistent tab.

Remarks

Selection is always an intentional timeline action. The target tab keeps its transcript, working directory, profile, and palette, so the story can pause on a ready session or continue writing exactly where that session stopped.

Examples

Authored help example

Return to the initial PowerShell tab

PS>


Select-ImageConsoleStoryTab -Id PowerShell
            New-ImageConsoleStoryPause -Seconds 1.5
            New-ImageConsoleStoryCommand -Text 'Get-ChildItem .\artifacts'

Returns to the retained PowerShell buffer, holds it in a ready state, then continues the same session.

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.

Syntax

Select-ImageConsoleStoryTab -Id <String> [-TransitionSeconds <Double>] [<CommonParameters>]

Parameter set: All Parameter Sets

Parameters

Id String requiredposition: 0pipeline: False: Identifier of a tab declared earlier in the story. The initial tab is named main.
TransitionSeconds Double optionalposition: namedpipeline: False: Duration of the visual switch to the selected tab.

Outputs

ImagePlayground.PowerShell.ImageConsoleStoryStep: Use the console story command, output, table, blank-line, pause, tab, and tab-selection cmdlets to create steps.