powershell7

This module has been developed to manage the installation of PowerShell 7.

Table of Contents

1. Description
2. Setup - The basics of getting started with powershell7
   • Beginning with powershell7
3. Usage - Configuration options and additional functionality
   • Install and Enable PowerShell 7
   • Disable Context Menu Options
   • Disable PS Remoting
4. Limitations - OS compatibility, etc.
5. Development - Guide for contributing to the module

Description

PowerShell 7 is the latest major update which builds on PowerShell 6 core. This version of PowerShell brings many new features, cmdlets and includes a number of bugfixes.

Setup

Beginning with powershell7

include powershell7 is enough to get started and have PowerShell 7 installed on your windows server.

Usage

All parameters for this module are contained in the powershell7 class. If you would like to alter installation settings such as context menu options please see below.

Install and Enable PowerShell 7

include powershell7

Disable Context Menu Options

class { 'powershell7':
  'add_explorer_context_menu_openpowershell' => 0,
  'add_file_context_menu_runpowershell' => 0,
}

Disable PS Remoting

class { 'powershell7':
  'enable_psremoting' => 0,
}

Change Update Notification Settings

PowerShell 7 added a new feature to alert users when a newer version of the PowerShell application is available. This can be configured to Off, Default or LTS. The notification doesn't provide any capabilities to update PowerShell but just to notify only.

class { 'powershell7':
  'powershell_updatecheck' => 'LTS,
}

Limitations

Currently this has only been designed and tested for Windows. PowerShell 7 on Linux is not yet supported in this module.

Development

If you would like to contribute to this module. Fork me on github, make your desired changes and create a Pull request back to n3snah/powershell7

Changelog

All notable changes to this project will be documented in this file.

Release 0.2.0

Features

• Added: able to set the notification policy for Powershell 7 Update checks.
• Added: added metadata.json tags for better visibility of what this module references.

Bugfixes

• Fix: powershell7::install exec kept running due to the creates attribute sourcing the wrong file.
• Fix: installation source URLs now allow HTTP as well has HTTPS locations.
• Fix: supported version of puppet was lowered to 6.0.0 as it works across all Puppet 6 versions.

Release 0.1.0

Features

• Added: Able to install PowerShell 7 on Windows Server (2012 R2, 2016, 2019)

Bugfixes

Known Issues