Skip to content

Latest commit

 

History

History
83 lines (59 loc) · 2.9 KB

install-instructions.md

File metadata and controls

83 lines (59 loc) · 2.9 KB
Raw

Install instructions

Prerequisites

  • Windows PowerShell 5.1 with .NET Framework 4.7.2+ or
  • PowerShell Core 6.2 or greater on Windows, MacOS and Linux or
  • PowerShell 7.0 or greater on Windows, MacOS and Linux

For a list of platforms that PowerShell Core is supported on see.

The following modules are required for PSRule.Rules.CAF to work:

  • PSRule
  • PSRule.Rules.Azure
  • Az.Accounts
  • Az.Resources

The required version of each module will automatically be installed along-side PSRule.Rules.CAF when using Install-Module or Update-Module cmdlets.

Getting the modules

PowerShell Gallery

Install from PowerShell Gallery for all users (requires permissions):

# Install module
Install-Module -Name 'PSRule.Rules.CAF' -Repository PSGallery;

Install from PowerShell Gallery for current user only:

# Install module
Install-Module -Name 'PSRule.Rules.CAF' -Repository PSGallery -Scope CurrentUser;

Save for offline use from PowerShell Gallery:

# Save module, in the .\modules directory
Save-Module -Name 'PSRule', 'PSRule.Rules.Azure', 'PSRule.Rules.CAF', 'Az.Accounts', 'Az.Resources' -Path '.\modules';

For pre-release versions the -AllowPrerelease switch must be added when calling Install-Module or Save-Module.

To install pre-release module versions, upgrading to the latest version of PowerShellGet may be required. To do this use:

Install-Module -Name PowerShellGet -Repository PSGallery -Scope CurrentUser -Force

Building from source

To build this module from source run ./build.ps1. This build script will compile the module and documentation then output the result into out/modules/PSRule.Rules.CAF.

The following PowerShell modules will be automatically downloaded if the required versions are not present:

  • PlatyPS
  • Pester
  • PSScriptAnalyzer
  • PowerShellGet
  • PackageManagement
  • InvokeBuild

These additional modules are only required for building PSRule and are not required for running PSRule.

If you are on a network that does not permit Internet access to the PowerShell Gallery, download these modules on an alternative device that has access. The following script can be used to download the required modules to an alternative device. After downloading the modules copy the module directories to devices with restricted Internet access.

# Save modules, in the .\modules directory
Save-Module -Name PlatyPS, Pester, PSScriptAnalyzer, PowerShellGet, PackageManagement, InvokeBuild -Repository PSGallery -Path '.\modules';

Additionally .NET Core SDK v3.1 is required. .NET Core will not be automatically downloaded and installed. To download and install the latest SDK see Download .NET Core 3.1.