⚖️ MIT

A GitHub Action to setup PowerShell module hugoalh.GitHubActionsToolkit (GitHub)(PowerShell Gallery).

• GitHub Actions Runner

  🛡️ Require Permission

  N/A

  💽 Require Software

  • PowerShell >= v7.2.0

1. Import at the metadata (action.yml):

   runs:
     using: "composite"
     steps:
       - uses: "hugoalh/setup-powershell-toolkit-ghaction@<Tag>"

1. Import at the workflow (.github/workflows/<WorkflowName>.yml):

   jobs:
     job_id:
       runs-on: "________" # Any
       steps:
         - uses: "hugoalh/setup-powershell-toolkit-ghaction@<Tag>"

<Boolean = False> Whether to execute in sudo mode on non-Windows environment. This must set to True in order to able install for all users on non-Windows environment (i.e.: when input scope is "AllUsers").

<String = "^2.1.0"> Target version, by Semantic Versioning (SemVer) 2.0.0 with optional modifier; Default to major equitant latest version of 2.1.0.

• "Latest": Latest version
• "<1.2.3": Less than this version
• "<=1.2.3": Less than or equal to this version
• "1.2.3" / "=1.2.3": Equal to this version
• ">=1.2.3": Greater than or equal to this version
• ">1.2.3": Greater than this version
• "^1.2.3": Between this version and major equitant latest version
• "~1.2.3": Between this version and minor equitant latest version

<Boolean = False> Whether to allow target pre release version.

<String = "CurrentUser"> Installation scope.

• "AllUsers": For all users. Also need to set input sudo to True on non-Windows environment.
• "CurrentUser": For current user.

<Boolean = False> Whether to force install or reinstall target (pre release) version.

<Boolean = False> Whether to keep the setting that modified.

<String> Path of the installation.

<SemVer> Version of the installation.

• jobs:
    job_id:
      name: "Hello World"
      runs-on: "ubuntu-latest"
      steps:
        - name: "Setup PowerShell Toolkit"
          uses: "hugoalh/setup-powershell-toolkit-ghaction@v2.0.0"
        - run: |
            Import-Module -Name 'hugoalh.GitHubActionsToolkit' -Scope 'Local'
            Write-GitHubActionsNotice -Message 'Hello, world!'
          shell: "pwsh"

• GitHub Actions
  • Enabling debug logging