Functions/Remove-IniComment.ps1
|
Set-StrictMode -Version Latest Function Remove-IniComment { <# .Synopsis Uncomments out specified content of an INI file .Description Uncomments out specified keys in all sections or certain sections. The ini source can be specified by a file or piped in by the result of Get-IniContent. The modified content is returned as a ordered dictionary hashtable and can be piped to a file with Out-IniFile. .Notes Author : Sean Seymour <seanjseymour@gmail.com> based on work by Oliver Lipkau <oliver@lipkau.net> Source : https://github.com/lipkau/PsIni http://gallery.technet.microsoft.com/scriptcenter/ea40c1ef-c856-434b-b8fb-ebd7a76e8d91 Version : 1.0.0 - 2016/08/18 - SS - Initial release #Requires -Version 2.0 .Inputs System.String System.Collections.IDictionary .Outputs System.Collections.Specialized.OrderedDictionary .Parameter FilePath Specifies the path to the input file. .Parameter InputObject Specifies the Hashtable to be modified. Enter a variable that contains the objects or type a command or expression that gets the objects. .Parameter CommentChar Specify what characters should be describe a comment. Lines starting with the characters provided will be rendered as comments. Default: ";" .Parameter Keys String of one or more keys to modify, separated by a delimiter. Default is a comma, but this can be changed with -KeyDelimiter. Required. .Parameter KeyDelimiter Specify what character should be used to split the -Keys parameter value. Default: "," .Parameter Sections String of one or more sections to limit the changes to, separated by a delimiter. Default is a comma, but this can be changed with -SectionDelimiter. Surrounding section names with square brackets is not necessary but is supported. Ini keys that do not have a defined section can be modified by specifying '_' (underscore) for the section. .Parameter SectionDelimiter Specify what character should be used to split the -Sections parameter value. Default: "," .Example $ini = Remove-IniComment -FilePath "C:\myinifile.ini" -Sections 'Printers' -Keys 'Headers' ----------- Description Reads in the INI File c:\myinifile.ini, uncomments out any keys named 'Headers' in the [Printers] section, and saves the modified ini to $ini. .Example Remove-IniComment -FilePath "C:\myinifile.ini" -Sections 'Terminals,Monitors' -Keys 'Updated' | Out-IniFile "C:\myinifile.ini" -Force ----------- Description Reads in the INI File c:\myinifile.ini and uncomments out any keys named 'Updated' in the [Terminals] and [Monitors] sections. The ini is then piped to Out-IniFile to write the INI File to c:\myinifile.ini. If the file is already present it will be overwritten. .Example Get-IniContent "C:\myinifile.ini" | Remove-IniComment -Keys 'Headers' | Out-IniFile "C:\myinifile.ini" -Force ----------- Description Reads in the INI File c:\myinifile.ini using Get-IniContent, which is then piped to Remove-IniComment to uncomment any 'Headers' keys in any section. The ini is then piped to Out-IniFile to write the INI File to c:\myinifile.ini. If the file is already present it will be overwritten. .Example Get-IniContent "C:\myinifile.ini" | Remove-IniComment -Keys 'Updated' -Sections '_' | Out-IniFile "C:\myinifile.ini" -Force ----------- Description Reads in the INI File c:\myinifile.ini using Get-IniContent, which is then piped to Remove-IniComment to uncomment any 'Updated' keys that are orphaned, i.e. not specifically in a section. The ini is then piped to Out-IniFile to write the INI File to c:\myinifile.ini. .Link Get-IniContent Out-IniFile #> [CmdletBinding(DefaultParameterSetName = "File")] [OutputType( [System.Collections.IDictionary] )] Param ( [Parameter(ParameterSetName="File",Mandatory=$True,Position=0)] [ValidateNotNullOrEmpty()] [String]$FilePath, [Parameter(ParameterSetName="Object",Mandatory=$True,ValueFromPipeline=$True)] [ValidateNotNullOrEmpty()] [System.Collections.IDictionary]$InputObject, [Parameter(Mandatory = $True)] [ValidateNotNullOrEmpty()] [String]$Keys, [String]$KeyDelimiter = ',', [char[]]$CommentChar = @(";"), [ValidateNotNullOrEmpty()] [String]$Sections, [String]$SectionDelimiter = ',' ) Begin { Write-Debug "PsBoundParameters:" $PSBoundParameters.GetEnumerator() | ForEach { Write-Debug $_ } if ($PSBoundParameters['Debug']) { $DebugPreference = 'Continue' } Write-Debug "DebugPreference: $DebugPreference" Write-Verbose "$($MyInvocation.MyCommand.Name):: Function started" } # Uncomment out the specified keys in the list, either in the specified section or in all sections. Process { # Get the ini from either a file or object passed in. if ($PSCmdlet.ParameterSetName -eq 'File') { $content = Get-IniContent $FilePath } if ($PSCmdlet.ParameterSetName -eq 'Object') { $content = $InputObject } # Specific section(s) were requested. if ($Sections) { foreach ($section in $Sections.Split($SectionDelimiter)) { # Get rid of whitespace and section brackets. $section = $section.Trim() -replace '[][]','' Write-Debug ("Processing '{0}' section." -f $section) foreach ($key in $Keys.Split($KeyDelimiter)) { Write-Debug ("Processing '{0}' key." -f $key) $key = $key.Trim() if (!($content[$section])) { Write-Verbose ("$($MyInvocation.MyCommand.Name):: '{0}' section does not exist." -f $section) # Break out of the loop after this, because we don't want to check further keys for this non-existent section. break } # Since this is a comment, we need to search through all the CommentX keys in this section. # That's handled in the Convert-IniCommentToEntry function, so don't bother checking key existence here. Convert-IniCommentToEntry $content $key $section $CommentChar } } } else # No section supplied, go through the entire ini since changes apply to all sections. { foreach ($item in $content.GetEnumerator()) { $section = $item.key Write-Debug ("Processing '{0}' section." -f $section) foreach ($key in $Keys.Split($KeyDelimiter)) { $key = $key.Trim() Write-Debug ("Processing '{0}' key." -f $key) Convert-IniCommentToEntry $content $key $section $CommentChar } } } return $content } End { Write-Verbose "$($MyInvocation.MyCommand.Name):: Function ended" } } Set-Alias ric Remove-IniComment |