Edit

Share via

Invoke-Formatter

  • Reference
Module:
PSScriptAnalyzer

Formats a script text based on the input settings or default settings.

Syntax

Invoke-Formatter
      [-ScriptDefinition] <string>
      [[-Settings] <Object>]
      [[-Range] <int[]>]
      [<CommonParameters>]

Description

The Invoke-Formatter cmdlet takes a string input and formats it according to defined settings. If no Settings parameter is provided, the cmdlet assumes the default code formatting settings as defined in Settings/CodeFormatting.psd1.

Examples

EXAMPLE 1 - Format the input script text using the default settings

$scriptDefinition = @'
function foo {
"hello"
  }
'@

Invoke-Formatter -ScriptDefinition $scriptDefinition

function foo {
    "hello"
}

EXAMPLE 2 - Format the input script using the settings defined in a hashtable

$scriptDefinition = @'
function foo {
"hello"
}
'@

$settings = @{
    IncludeRules = @("PSPlaceOpenBrace", "PSUseConsistentIndentation")
    Rules = @{
        PSPlaceOpenBrace = @{
            Enable = $true
            OnSameLine = $false
        }
        PSUseConsistentIndentation = @{
            Enable = $true
        }
    }
}

Invoke-Formatter -ScriptDefinition $scriptDefinition -Settings $settings

function foo
{
    "hello"
}

EXAMPLE 3 - Format the input script text using the settings defined a `.psd1` file

Invoke-Formatter -ScriptDefinition $scriptDefinition -Settings /path/to/settings.psd1

Parameters

-Range

The range within which formatting should take place. The value of this parameter must be an array of four integers. These numbers must be greater than 0. The four integers represent the following four values in this order:

  • starting line number
  • starting column number
  • ending line number
  • ending column number
Type:Int32[]
Position:3
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ScriptDefinition

The text of the script to be formatted represented as a string. This is not a ScriptBlock object.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Settings

A settings hashtable or a path to a PowerShell data file (.psd1) that contains the settings.

Type:Object
Position:2
Default value:CodeFormatting
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Outputs

String

The formatted string result.