PowerShell/tools/install-powershell-readme.md
Darwin 68ab1e09a6 Adding ability to install previews side-by-side with production releases (#7194)
-preview switch:
 - installs pwsh-preview packages when a package manager is being used.
 - uses link name pwsh-preview when tar ball install is being done
 - results in preview release being available for calling manually, but does not become systemwide version
Issue #7177
2018-06-28 11:46:58 -07:00

2.4 KiB

install-powershell.sh

Features of install-powershell.sh

  • can be called directly from git
  • optionally installs vs code and vs powershell extension (aka PowerShell IDE) using optional -includeide switch
  • defaults to completely automated operation (if appropriate permissions are available)
  • automatically looks up latest version via git tags
  • automatic selection of appropriate install sub-script
  • configures software installs for repositories when repositories are in place, otherwise pulls files from git releases. As repository versions are made available, script will be updated to take advantage.
  • user permission checking
  • sub-installers called from local file system if they exist, otherwise pulled from git
  • sub-installers can be called directly if auto-selection is not needed

Minimum Requirements for install-powershell.sh

  • bash shell
  • sed
  • native package manager available
  • curl (auto-installed if missing)

Parameters

  • -includeide - installs vscode and vscode powershell extension (only relevant to machines with desktop environment)
  • -interactivetesting - do a quick launch test of vscode - only relevant when used with -includeide
  • -skip-sudo-check - use sudo without verifying it's availability (hard to accurately do on some distros)
  • -preview - installs preview of powershell core side-by-side with any existing production releases.

Usage

Direct from Github

bash <(wget -O - https://raw.githubusercontent.com/PowerShell/PowerShell/master/tools/install-powershell.sh) <ARGUMENTS>

wget -O - https://raw.githubusercontent.com/PowerShell/PowerShell/master/tools/install-powershell.sh | bash -s <ARGUMENTS>

Local Copy

bash install-powershell.sh <ARGUMENTS>

Examples

Only Install PowerShell Core

bash <(wget -O - https://raw.githubusercontent.com/PowerShell/PowerShell/master/tools/install-powershell.sh)

Install PowerShell Core with IDE

bash <(wget -O - https://raw.githubusercontent.com/PowerShell/PowerShell/master/tools/install-powershell.sh) -includeide

Install PowerShell Core with IDE and do tests that require a human to interact with the installation process

bash <(wget -O - https://raw.githubusercontent.com/PowerShell/PowerShell/master/tools/install-powershell.sh) -includeide -interactivetesting

Installation To do list

  • Detect and wait when package manager is busy/locked? - at least Ubuntu (CentOS does this internally)