Home

Welcome to the PSResourceGet.Bootstrap wiki

^{PSResourceGet.Bootstrap v0.2.0}

This module tries to solve (in an opinionated way) how to get the module Microsoft.PowerShell.PSResourceGet onto a system.

Here you will find all the information you need to make use of the latest release of the PSResourceGet.Bootstrap module. This includes details of the commands that are available, current capabilities, known issues.

Please leave comments, feature requests, and bug reports for this module in the issues section of this repository.

Getting started

Bootstrap Script

The fastest way to bootstrap the module Microsoft.PowerShell.PSResourceGet is to use the bootstrap script:

iwr bit.ly/psresourceget | iex

This uses default values and will bootstrap Microsoft.PowerShell.PSResourceGet to the scope CurrentUser.

Note

The bit.ly-link uses URL https://github.com/viscalyx/PSResourceGet.Bootstrap/releases/latest/download/bootstrap.ps1. which bounces to the latest full release artifact, e.g. https://github.com/viscalyx/PSResourceGet.Bootstrap/releases/download/v0.1.0/bootstrap.ps1.

& ([ScriptBlock]::Create((iwr 'bit.ly/psresourceget'))) -Scope 'AllUsers'

This will bootstrap the Microsoft.PowerShell.PSResourceGet module to the scope AllUsers.

& ([ScriptBlock]::Create((iwr 'bit.ly/psresourceget'))) -Destination 'C:\Modules'

This will bootstraps the Microsoft.PowerShell.PSResourceGet module, saving it to the specified destination path C:\Modules.

Tip

The bootstrap script has the same parameter sets as the command Start-PSResourceGetBootstrap.

Download the module from PowerShell Gallery

Important

Downloading this module from the PowerShell Gallery using Install-Module and then running the command Start-PSResourceGetBootstrap is kind of pointless. Then you might as well install the module Microsoft.PowerShell.PSResourceGet directly. The best use of this method is id PSResourceGet.Bootstrap is used as a nested module by another module, for example in a Sampler templated project. The built module should then import the nested module explicitly.

To get started either:

1. Install from the PowerShell Gallery using PowerShellGet by running the following command:

Install-Module -Name PSResourceGet.Bootstrap -Repository PSGallery

2. Bootstrap Microsoft.PowerShell.PSResourceGet by running the following command:

Start-PSResourceGetBootstrap

3. Install a resource using Install-PSResource.

Install-PSResource -Name 'Sampler'

Powershell

It is recommended to use the latest PowerShell version. The minimum Windows Management Framework (PowerShell) version required is 5.1.

Change log

A full list of changes in each version can be found in the change log.