PowerShell/tools/install-powershell.sh-README.md
xtqqczze b03b968d0a
Restore markdownlint tests (#12549)
Co-authored-by: Travis Plunk <travis.plunk@microsoft.com>
2020-06-02 12:28:32 -07:00

2.5 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)
  • tr

Parameters

  • -includeide - installs VSCode and VSCode PowerShell extension (only relevant to machines with a desktop environment)
  • -interactivetesting - do a quick launch test of VSCode (only relevant when used with -includeide)
  • -skip-sudo-check - use sudo without verifying its availability (hard to accurately do on some distros)
  • -preview - installs the latest preview release 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)