Project

ImagePlayground

Automate image processing, codes, metadata, charts, topology, and visual stories from PowerShell.

Stars 101
Forks 7
Total downloads 711,982
Release ImagePlayground-PowerShellModule.v3.2.7
Language: C# Updated: 2026-10-26
Command

ConvertTo-Image

Module
ImagePlayground
Inputs
System.String

Converts an image to a different format.

Syntax

ConvertTo-Image
[-CompressionLevel <Int32>]
[-FilePath] <String>
[-OutputPath] <String>
[-Quality <Int32>]
[<CommonParameters>]
#
Parameter set: All Parameter Sets

Description

Outputs a new file using the extension from OutputPath.

When OutputPath ends with .ico, the file is only copied if the source file is also an icon.

Examples

Convert PNG to JPEG

ConvertTo-Image -FilePath image.png -OutputPath image.jpg -Quality 85

Convert JPEG to PNG

ConvertTo-Image -FilePath photo.jpg -OutputPath photo.png -CompressionLevel 6

Parameters

-CompressionLevel Int32 optional
Compression level for PNG images.
-FilePath String requiredposition: 0pipeline: True (ByValue)
The file must exist.
-OutputPath String requiredposition: 1
The extension determines the output format.
-Quality Int32 optional
Quality for JPEG or WEBP images.

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.