Skip to main content

Documentation Index

Fetch the complete documentation index at: https://tally.wharflab.com/llms.txt

Use this file to discover all available pages before exploring further.

powershell/PSUseCorrectCasing is a PSScriptAnalyzer diagnostic emitted by tally for PowerShell snippets embedded in Dockerfiles.
PropertyValue
SeverityInformation
CategoryPSScriptAnalyzer
Auto-fixNo

​
Description

This is a style/formatting rule. PowerShell is case insensitive wherever possible, so the casing of cmdlet names, parameters, keywords and operators doesn’t matter. This rule nonetheless ensures consistent casing for clarity and readability. Using lowercase keywords helps distinguish them from commands. Using lowercase operators helps distinguish them from parameters.

​
How

  • Use exact casing for type names.
  • Use exact casing of the cmdlet and its parameters.
  • Use lowercase for language keywords and operators.

​
Configuration

Rules = @{
    PSUseCorrectCasing = @{
        Enable        = $true
        CheckCommands = $true
        CheckKeyword  = $true
        CheckOperator = $true
    }
}

​
Parameters

​
Enable: bool (Default value is $false)

Enable or disable the rule during ScriptAnalyzer invocation.

​
CheckCommands: bool (Default value is $true)

If true, require the case of all command and parameter names to match their canonical casing.

​
CheckKeyword: bool (Default value is $true)

If true, require the case of all keywords to be lowercase.

​
CheckOperator: bool (Default value is $true)

If true, require the case of all operators to be lowercase. For example: -eq, -ne, -gt

​
Examples

​
Wrong way

ForEach ($file in Get-childitem -Recurse) {
    $file.Extension -EQ '.txt'
}

invoke-command { 'foo' } -runasadministrator

​
Correct way

foreach ($file in Get-ChildItem -Recurse) {
    $file.Extension -eq '.txt'
}

Invoke-Command { 'foo' } -RunAsAdministrator

​
Source

This rule documentation is adapted from Microsoft’s PSScriptAnalyzer documentation for UseCorrectCasing, licensed under CC BY 4.0.