Read INI files in PowerShell

ini.ps1

function Get-IniFile {
    <#
    .SYNOPSIS
    Read an ini file.
    
    .DESCRIPTION
    Reads an ini file into a hash table of sections with keys and values.
    
    .PARAMETER filePath
    The path to the INI file.
    
    .PARAMETER anonymous
    The section name to use for the anonymous section (keys that come before any section declaration).
    
    .PARAMETER comments
    Enables saving of comments to a comment section in the resulting hash table.
    The comments for each section will be stored in a section that has the same name as the section of its origin, but has the comment suffix appended.
    Comments will be keyed with the comment key prefix and a sequence number for the comment. The sequence number is reset for every section.
    
    .PARAMETER commentsSectionsSuffix
    The suffix for comment sections. The default value is an underscore ('_').
    .PARAMETER commentsKeyPrefix
    The prefix for comment keys. The default value is 'Comment'.
    
    .EXAMPLE
    Get-IniFile /path/to/my/inifile.ini
    
    .NOTES
    The resulting hash table has the form [sectionName->sectionContent], where sectionName is a string and sectionContent is a hash table of the form [key->value] where both are strings.
    This function is largely copied from https://stackoverflow.com/a/43697842/1031534
    A modified version with a working example is pulished at https://gist.github.com/seakintruth/05da4c3c38f72c4b796aeae9be453e8e

    .LICENSE
    Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)
    #>
    
    param(
        [parameter(Mandatory = $true)] [string] $filePath,
        [string] $anonymous = 'NoSection',
        [switch] $comments,
        [string] $commentsSectionsSuffix = '_',
        [string] $commentsKeyPrefix = 'Comment'
    )
    $ini = @{}
    switch -regex -file ($filePath) {
        "^\[(.+)\]$" {
            # Section
            $section = $matches[1]
            $ini[$section] = @{}
            $CommentCount = 0
            if ($comments) {
                $commentsSection = $section + $commentsSectionsSuffix
                $ini[$commentsSection] = @{}
            }
            continue
        }
        "^(;.*)$" {
            # Comment
            if ($comments) {
                if (!($section)) {
                    $section = $anonymous
                    $ini[$section] = @{}
                }
                $value = $matches[1]
                $CommentCount = $CommentCount + 1
                $name = $commentsKeyPrefix + $CommentCount
                $commentsSection = $section + $commentsSectionsSuffix
                $ini[$commentsSection][$name] = $value
            }
            continue
        }

        "^(.+?)\s*=\s*(.*)$" {
            # Key
            if (!($section)) {
                $section = $anonymous
                $ini[$section] = @{}
            }
            $name, $value = $matches[1..2]
            $ini[$section][$name] = $value
            continue
        }
    }
    return $ini
}
<#
.SYNOPSIS
    Get hashtable content. Then you can pipe it to Out-File to create INI file.
.NOTES
    This function is largely copied from https://stackoverflow.com/a/43697842/1031534
    A modified version with a working example is pulished at https://gist.github.com/seakintruth/05da4c3c38f72c4b796aeae9be453e8e
    Little modification of the way to get the parameter when we call the function (see line 96).
.LICENSE
    Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)

#>
function New-IniContent {
    [cmdletbinding()]
    param(
        [parameter(ValueFromPipeline)] [hashtable] $data,
        [string] $anonymous = 'NoSection'
    )
    process {
        $iniData = $data
        # Previously, $iniData was egqual to $_ but could only accept parameter from pipeline. With this declaration, $iniData accepts parameter from pipeline or raw declaration like "New-IniContent $myHashContent"

        if ($iniData.Contains($anonymous)) {
            $iniData[$anonymous].GetEnumerator() |  ForEach-Object {
                Write-Output "$($_.Name)=$($_.Value)"
            }
            Write-Output ''
        }
        $iniData.GetEnumerator() | ForEach-Object {
            $sectionData = $_
            if ($sectionData.Name -ne $anonymous) {
                Write-Output "[$($sectionData.Name)]"
                $iniData[$sectionData.Name].GetEnumerator() |  ForEach-Object {
                    Write-Output "$($_.Name)=$($_.Value)"
                }
            }
            Write-Output ''
        }
    }
}

<# Example Code for reading and writing to an INI file
$strScriptPath = [System.IO.Path]::GetDirectoryName($myInvocation.MyCommand.Definition)
$strPersonalAccessTokenPath = Join-Path -Path $strScriptPath -ChildPath "secured/personal_access_token.ini"
if (!(Test-Path $strPersonalAccessTokenPath)) {
    $dataHashTable = [hashtable]::new()
    $dataHashTable['General'] = @{ 
        PersonalAccessToken = 'NULL'
        Notes = 'Personal Access Tokens can be generated by each account on the Server under user settings'
        Comments = 'Secure this Text file prior to adding a Personal Access Token and saving this .ini file'
    }
    $dataHashTable['Example'] = @{ 
        Notes = 'This is just an example INI Section'
        Comments = 'End'
    }
    New-IniContent  $dataHashTable | Out-File -FilePath $strPersonalAccessTokenPath
    $strPersonalAccessToken =  Get-IniFile $strPersonalAccessTokenPath
    # $strPersonalAccessToken="NULL"
} else {
    $strPersonalAccessToken =  Get-IniFile $strPersonalAccessTokenPath
}
Add-Type -AssemblyName PresentationCore,PresentationFramework
[System.Windows.MessageBox]::Show($strPersonalAccessToken.General.PersonalAccessToken)

END EXAMPLE CODE #>