PSIni - GitLite

KO | EN

gitlite — search

#javascript #python #react #ai #typescript #go #rust #docker #java #windows #kubernetes #vue #mcp #openai

PSIni

(★ 164)

Work with INI files in PowerShell using hashtables

파일 탐색기

최종 버전 다운로드 (.zip)

- devcontainer.json
- - bug_report.md
  - feature_request.md
- - build_and_test.yml
  - release.yml
- changelog.configuration.json
- CODE_OF_CONDUCT.md
- dependabot.yml
- FUNDING.yml
- PULL_REQUEST_TEMPLATE.md
- .gitattributes
- settings.json
- Migrating-to-v4.md
- arrays.ps1
- comment-ini.ps1
- full-example.ps1
- handle-quotes.ps1
- new-features-v4.ps1
- read-ini.ps1
- README.md
- remove-ini.ps1
- save-ini.ps1
- settings.ini
- string-parsing.ps1
- uncomment-ini.ps1
- update-ini.ps1
- - Get-AllowedEncoding.ps1
  - Invoke-ConditionalParameterValidationEncoding.ps1
  - Invoke-ConditionalParameterValidationPath.ps1
  - Out-Key.ps1
  - Write-DebugMessage.ps1
- - Export-Ini.ps1
  - Import-Ini.ps1
- PSIni.psd1
- PSIni.psm1
- - Get-FileEncoding.ps1
  - Resolve-ModuleSource.ps1
  - Resolve-ProjectRoot.ps1
- Export-Ini.Unit.Tests.ps1
- Import-Ini.Unit.Tests.ps1
- PsIni.Help.Tests.ps1
- PsIni.Integration.Tests.ps1
- PsIni.Project.Tests.ps1
- PsIni.Style.Tests.ps1
- PsIni.Tests.ps1
- PSScriptAnalyzer.Tests.ps1
- sample.ini
- sample[].ini
- build.requirements.psd1
- BuildTools.psm1
- setup.ps1
- update.dependencies.ps1
.editorconfig
.gitattributes
.gitignore
CHANGELOG.md
CODEOWNERS
CONTRIBUTING.md
LICENSE
PSIni.build.ps1
PSScriptAnalyzerSettings.psd1
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# PSIni

[![GitHub release](https://img.shields.io/github/release/lipkau/PSIni.svg?style=for-the-badge)](https://github.com/lipkau/PSIni/releases/latest)
![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/lipkau/PSIni/build_and_test.yml?branch=master&style=for-the-badge)
[![PowerShell Gallery](https://img.shields.io/powershellgallery/dt/PSIni.svg?style=for-the-badge)](https://www.powershellgallery.com/packages/PSIni)
![License](https://img.shields.io/github/license/lipkau/PSIni.svg?style=for-the-badge)

## Table of Contents

- [PSIni](#psini)
  - [Table of Contents](#table-of-contents)
  - [Description](#description)
    - [Origin](#origin)
  - [Installation](#installation)
  - [Examples](#examples)
    - [Create INI file from hashtable](#create-ini-file-from-hashtable)
    - [Read the content of an INI file](#read-the-content-of-an-ini-file)
  - [Contributors](#contributors)

## Description

Work with INI files in PowerShell using hashtables.

### Origin

This code was originally a blog post for [Hey Scripting Guy](https://devblogs.microsoft.com/scripting/).
> [Use PowerShell to Work with Any INI File](https://devblogs.microsoft.com/scripting/use-powershell-to-work-with-any-ini-file/)

Over time this project got a lot of enhancements and major face-lifts.

## Installation

PSIni is published to the [Powershell Gallery](https://www.powershellgallery.com/packages/PSIni)
and can be installed as follows:

```powershell
Install-Module PSIni <# -Scope User #>
```

> **Note:** If you're upgrading from PSIni v3 to v4, please refer to the [migration guide](docs/Migrating-to-v4.md) for details on breaking changes and new features.

---

When using the source (this repository), you can easily get the necessary setup by running

```powershell
. ./tools/setup.ps1
```

_Additional information can be found in [CONTRIBUTING](CONTRIBUTING.md)._

## Examples

### Create INI file from hashtable

Create a hashtable and save it to `./settings.ini`:

```powershell
$Category1 = @{"Key1"="Value1";"Key2"="Value2"}
$Category2 = @{"Key1"="Value1";"Key2"="Value2"}
$NewINIContent = @{"Category1"=$Category1;"Category2"=$Category2}

Import-Module PSIni
Export-Ini -InputObject $NewINIContent -Path ".\settings.ini"
```

Results:

> ```Ini
> [Category1]
> Key1=Value1
> Key2=Value2
>
> [Category2]
> Key1=Value1
> Key2=Value2
> ```

### Read the content of an INI file

Returns the key "Key2" of the section "Category2" from the `./settings.ini` file:

```powershell
$FileContent = Import-Ini -Path "C:\settings.ini"
$FileContent["Category2"]["Key2"]
```

## Contributors

This project benefited immensely from the contribution of powershell enthusiasts.
Thank you ❤️

The Contributors: <https://github.com/lipkau/PSIni/graphs/contributors>