Project

PSWriteOffice

PowerShell document automation across Word, Excel, PowerPoint, PDF, Reader, Confluence, Visio, and open text formats.

Stars 159
Forks 14
PowerShell Gallery downloads 158,661
Release v3.0.5
Language: C# Updated: 2026-09-03

API Reference

Cmdlet

Add-OfficeVisioEllipse

Aliases: VisioEllipse
Namespace PSWriteOffice
Aliases
VisioEllipse
Inputs
OfficeIMO.Visio.VisioPage
Outputs
OfficeIMO.Visio.VisioShape

Adds an ellipse shape to the current Visio page.

Remarks

Adds an ellipse shape to the current Visio page.

Examples

Authored help example

Add a start node.

PS>


OfficeVisio -Path .\Flow.vsdx {
                VisioEllipse -Key start -Text 'Start' -X 1 -Y 5 -Width 1.4 -Height 0.7 -FillColor '#DCFCE7'
            }
        

Adds an ellipse to the active Visio page.

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

Add-OfficeVisioEllipse [-FillColor <String>] [-Height <Double>] [-Key <String>] [-LineColor <String>] [-LineWeight <Double>] [-Name <String>] [-Page <VisioPage>] [-PassThru] [-Text <String>] [-Unit <Inches|Centimeters|Millimeters>] [-Width <Double>] [-X <Double>] [-Y <Double>] [<CommonParameters>]
#
Parameter set: All Parameter Sets

Parameters

FillColor String optionalposition: namedpipeline: False
Fill color name or hex value.
Height Double optionalposition: namedpipeline: False
Shape height.
Key String optionalposition: namedpipeline: False
DSL key used by connector commands.
LineColor String optionalposition: namedpipeline: False
Line color name or hex value.
LineWeight Double optionalposition: namedpipeline: False
Line weight.
Name String optionalposition: namedpipeline: False
Optional shape name.
Page VisioPage optionalposition: namedpipeline: True (ByValue)
Target page. Optional inside VisioPage or OfficeVisio.
PassThru SwitchParameter optionalposition: namedpipeline: False
Emit the object created or changed by the command.
Text String optionalposition: 0pipeline: False
Text placed inside the shape.
Unit VisioMeasurementUnit optionalposition: namedpipeline: Falsevalues: 3
Measurement unit for coordinates and dimensions.
Possible values: Inches, Centimeters, Millimeters
Width Double optionalposition: namedpipeline: False
Shape width.
X Double optionalposition: namedpipeline: False
X coordinate of the shape origin.
Y Double optionalposition: namedpipeline: False
Y coordinate of the shape origin.

Outputs

OfficeIMO.Visio.VisioShape