Skip to content

PowerShell/PSResourceGet

Repository files navigation

PSResourceGet

License Documentation - PSResourceGet PowerShell Gallery - PSResourceGet Minimum Supported PowerShell Version

Important Notes

Note

PSResourceGet is short for the full name of the module, Microsoft.PowerShell.PSResourceGet. The full name is what is used in PowerShell and when published to the PowerShell Gallery.

  • If you were familiar with the PowerShellGet 3.0 project, we renamed the module to be PSResourceGet, for more information please read this blog.
  • If you would like to open a PR please open an issue first so that necessary discussion can take place.
  • Please note, the repository for PowerShellGet v2 is available at PowerShell/PowerShellGetv2.
  • The repository for the PowerShellGet v3, the compatibility layer between PowerShellGet v2 and PSResourceGet, is available at PowerShell/PowerShellGet.

Introduction

PSResourceGet is a PowerShell module with commands for discovering, installing, updating and publishing the PowerShell resources like Modules, Scripts, and DSC Resources.

Documentation

Click here to reference the documentation.

Requirements

  • PowerShell 5.0 or higher.

Install the PSResourceGet module

  • PSResourceGet is short for the full name Microsoft.PowerShell.PSResourceGet.
  • It's included in PowerShell since v7.4. Please use the PowerShell Gallery to get the latest version of the module.

Contributing Quickstart Guide

Get the source code

  • Download the latest source code from the release page (https://github.com/PowerShell/PSResourceGet/releases) OR clone the repository using git.
    PS > cd 'C:\Repos'
    PS C:\Repos> git clone https://github.com/PowerShell/PSResourceGet
  • Navigate to the local repository directory
    PS C:\> cd c:\Repos\PSResourceGet
    PS C:\Repos\PSResourceGet>

Build the project

# Build for the net472 framework
PS C:\Repos\PSResourceGet> .\build.ps1 -Clean -Build -BuildConfiguration Debug -BuildFramework net472

# Build for the netstandard2.0 framework
PS C:\Repos\PSResourceGet> .\build.ps1 -Clean -Build -BuildConfiguration Debug -BuildFramework netstandard2.0

Publish the module to a local repository

=======

  • Run functional tests
PS C:\Repos\PSResourceGet> Invoke-Pester
PS C:\Repos\PSResourceGet> Invoke-Pester <file-name>

Import the built module into a new PowerShell session

# If running PowerShell 6+
C:\> pwsh
C:\> Import-Module C:\Repos\PSResourceGet\out\PSResourceGet

# If running Windows PowerShell
c:\> PowerShell
C:\> Import-Module C:\Repos\PSResourceGet\out\PSResourceGet\PSResourceGet.psd1

Code of Conduct

Please see our Code of Conduct before participating in this project.

Security Policy

For any security issues, please see our Security Policy.