# New-ImageAvatar

Creates a rounded avatar image. 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**

`System.String`

Creates a rounded avatar image.

## Syntax

```
New-ImageAvatar
[-CornerRadius <Single>]
[-FilePath] <String>
[-Height <Int32>]
[-Open]
[-OutputPath] <String>
[-Width <Int32>]
[<CommonParameters>]
```

[#](#method-new-imageavatar-single-string-int32-switchparameter-string-int32)

Parameter set: `Path`

```
New-ImageAvatar
[-CornerRadius <Single>]
[-FilePath] <String>
[-Height <Int32>]
[-Open]
[-OutputStream] <Stream>
[-Width <Int32>]
[<CommonParameters>]
```

[#](#method-new-imageavatar-single-string-int32-switchparameter-stream-int32)

Parameter set: `Stream`

## Examples

### Generate an avatar and open it

```powershell
New-ImageAvatar -FilePath user.jpg -OutputPath avatar.png -Open
```

## Parameters

**-CornerRadius Single optional**

Corner radius for rounding.

**-FilePath String requiredposition: 0pipeline: True (ByValue)**

Path to the input image.

**-Height Int32 optional**

Height of the avatar.

**-Open SwitchParameter optional**

Open the avatar after saving.

**-OutputPath String requiredposition: 1sets: Path**

Destination path when saving to disk.

**-Width Int32 optional**

Width of the avatar.

**-OutputStream Stream requiredposition: 1sets: Stream**

Stream that receives the avatar image.

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