From 581050ec43280f35bdac0c4d2168ae6404f026a3 Mon Sep 17 00:00:00 2001 From: Dongbo Wang Date: Tue, 22 Nov 2016 17:50:45 -0800 Subject: [PATCH] Update docs with release alpha.13 (#2765) * Update docs with release alpha.13 * Additional doc updates * Update the 'Get PowerShell' table --- .spelling | 3 ++ CHANGELOG.md | 31 +++++++++++++++---- README.md | 34 ++++++++++++--------- appveyor.yml | 2 +- demos/Azure/README.md | 2 +- docker/release/centos7/Dockerfile | 4 +-- docker/release/nanoserver/Dockerfile | 2 +- docker/release/ubuntu14.04/Dockerfile | 4 +-- docker/release/ubuntu16.04/Dockerfile | 4 +-- docker/release/windowsservercore/Dockerfile | 2 +- docs/FAQ.md | 2 +- docs/installation/linux.md | 26 ++++++++-------- 12 files changed, 71 insertions(+), 45 deletions(-) diff --git a/.spelling b/.spelling index e707946961..4f96a36929 100644 --- a/.spelling +++ b/.spelling @@ -722,3 +722,6 @@ AssemblyLoadContext csharp fullclr shebang + - CHANGELOG.md +v6.0.0 +alpha.13 diff --git a/CHANGELOG.md b/CHANGELOG.md index c255e9233a..2d13522700 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,12 +1,31 @@ Changelog ========= -Unreleased ----------- -- Improve pipeline for native commands. - Start native process in Prepare() instead of Complete(). - `ping | grep` doesn't block anymore. -- Added -Top and -Bottom parameters to Sort-Object +v6.0.0-alpha.13 - 2016-11-22 +---------------------------- +- Fix `NullReferenceException` in binder after turning on constrained language mode +- Enable `Invoke-WebRequest` and `Invoke-RestMethod` to not validate the HTTPS certificate of the server if required. +- Enable binder debug logging in PowerShell Core +- Add parameters `-Top` and `-Bottom` to `Sort-Object` or Top/Bottom N sort +- Enable `Update-Help` and `Save-Help` on Unix platforms +- Update the formatter for `System.Diagnostics.Process` to not show the `Handles` column +- Improve `Write-Progress` performance by adding timer to update a progress pane every 100 ms +- Enable correct table width calculations with ANSI escape sequences on Unix +- Fix background jobs for Unix and Windows +- Add `Get-Uptime` to `Microsoft.PowerShell.Utility` +- Make `Out-Null` as fast as `> $null` +- Add Dockerfile for windowsservercore and NanoServer +- Fix WebRequest failure to handle missing ContentType in response header +- Make `Write-Host` fast by delay initializing some properties in InformationRecord +- Ensure PowerShell Core adds an initial `/` rooted drive on Unix platforms +- Enable streaming behavior for native command execution in pipeline, so that `ping | grep` doesn't block +- Make `Write-Information` accept objects from pipeline +- Fixes deprecated syscall issue on macOS 10.12 +- Fix code errors found by the static analysis using PVS-Studio +- Add support to W3C Extended Log File Format in `Import-Csv` +- Guard against `ReflectionTypeLoadException` in type name auto-completion +- Update build scripts to support win7-x86 runtime +- Move PackageManagement code/test to oneget.org v6.0.0-alpha.12 - 2016-11-03 ---------------------------- diff --git a/README.md b/README.md index c144f02770..fb5b36bb03 100644 --- a/README.md +++ b/README.md @@ -20,22 +20,26 @@ Get PowerShell You can download and install a PowerShell package for any of the following platforms. -| Platform | Downloads | How to Install | -| ------------------------------ | ---------------------- | ----------------------------- | -| Windows 10 / Server 2016 | [.msi][rl-windows10] | [Instructions][in-windows] | -| Windows 8.1 / Server 2012 R2 | [.msi][rl-windows81] | [Instructions][in-windows] | -| Ubuntu 16.04 | [.deb][rl-ubuntu16] | [Instructions][in-ubuntu16] | -| Ubuntu 14.04 | [.deb][rl-ubuntu14] | [Instructions][in-ubuntu14] | -| CentOS 7 | [.rpm][rl-centos] | [Instructions][in-centos] | -| macOS 10.11 | [.pkg][rl-macos] | [Instructions][in-macos] | -| Docker | | [Instructions][in-docker] | +| Platform | Downloads | How to Install | +| ---------------------------------- | ---------------------- | ----------------------------- | +| Windows 10 / Server 2016 (x64) | [.msi][rl-windows10] | [Instructions][in-windows] | +| Windows 8.1 / Server 2012 R2 (x64) | [.msi][rl-windows81] | [Instructions][in-windows] | +| Windows 7 (x64) | [.msi][rl-windows7-64] | [Instructions][in-windows] | +| Windows 7 (x86) | [.msi][rl-windows7-86] | [Instructions][in-windows] | +| Ubuntu 16.04 | [.deb][rl-ubuntu16] | [Instructions][in-ubuntu16] | +| Ubuntu 14.04 | [.deb][rl-ubuntu14] | [Instructions][in-ubuntu14] | +| CentOS 7 | [.rpm][rl-centos] | [Instructions][in-centos] | +| macOS 10.11 | [.pkg][rl-macos] | [Instructions][in-macos] | +| Docker | | [Instructions][in-docker] | -[rl-windows10]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.12/PowerShell_6.0.0.12-alpha.12-win10-x64.msi -[rl-windows81]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.12/PowerShell_6.0.0.12-alpha.12-win81-x64.msi -[rl-ubuntu16]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.12/powershell_6.0.0-alpha.12-1ubuntu1.16.04.1_amd64.deb -[rl-ubuntu14]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.12/powershell_6.0.0-alpha.12-1ubuntu1.14.04.1_amd64.deb -[rl-centos]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.12/powershell-6.0.0_alpha.12-1.el7.centos.x86_64.rpm -[rl-macOS]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.12/powershell-6.0.0-alpha.12.pkg +[rl-windows10]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.13/PowerShell_6.0.0.13-alpha.13-win10-x64.msi +[rl-windows81]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.13/PowerShell_6.0.0.13-alpha.13-win81-x64.msi +[rl-windows7-64]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.13/PowerShell_6.0.0.13-alpha.13-win7-x64.msi +[rl-windows7-86]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.13/PowerShell_6.0.0.13-alpha.13-win7-x86.msi +[rl-ubuntu16]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.13/powershell_6.0.0-alpha.13-1ubuntu1.16.04.1_amd64.deb +[rl-ubuntu14]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.13/powershell_6.0.0-alpha.13-1ubuntu1.14.04.1_amd64.deb +[rl-centos]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.13/powershell-6.0.0_alpha.13-1.el7.centos.x86_64.rpm +[rl-macOS]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.13/powershell-6.0.0-alpha.13.pkg [installation]: docs/installation [in-windows]: docs/installation/windows.md#msi diff --git a/appveyor.yml b/appveyor.yml index 7771a53acd..5cc8bc0b78 100644 --- a/appveyor.yml +++ b/appveyor.yml @@ -1,4 +1,4 @@ -version: 6.0.0-alpha.12-{build} +version: 6.0.0-alpha.13-{build} image: Visual Studio 2015 diff --git a/demos/Azure/README.md b/demos/Azure/README.md index 9f45b27493..22b77e3e6d 100644 --- a/demos/Azure/README.md +++ b/demos/Azure/README.md @@ -3,7 +3,7 @@ This demo (Azure-Demo.ps1) shows management of Azure Compute resource using Azure Resource Management (ARM) cmdlets. ## Prerequisites ## -- Install PowerShell 6.0.0-alpha.12 +- Install PowerShell 6.0.0-alpha.13 - Install AzureRM.NetCore.Preview, AzureRM.Profile.NetCore.Preview and AzureRM.Resources.NetCore.Preview modules to a local directory. - The instructions for downloading these modules are in Azure-Demo.ps1 file. - You have to use the command "Install-Package -Name AzureRM.NetCore.Preview -Source https://www.powershellgallery.com/api/v2 -ProviderName NuGet -ExcludeVersion -Destination " diff --git a/docker/release/centos7/Dockerfile b/docker/release/centos7/Dockerfile index ba4e34e9ab..7e4f4b601f 100644 --- a/docker/release/centos7/Dockerfile +++ b/docker/release/centos7/Dockerfile @@ -1,8 +1,8 @@ FROM centos:7 MAINTAINER Andrew Schwartzmeyer -ARG POWERSHELL_RELEASE=v6.0.0-alpha.12 -ARG POWERSHELL_PACKAGE=powershell-6.0.0_alpha.12-1.el7.centos.x86_64.rpm +ARG POWERSHELL_RELEASE=v6.0.0-alpha.13 +ARG POWERSHELL_PACKAGE=powershell-6.0.0_alpha.13-1.el7.centos.x86_64.rpm # Setup the locale ENV LANG en_US.UTF-8 diff --git a/docker/release/nanoserver/Dockerfile b/docker/release/nanoserver/Dockerfile index 42bb8a7d17..835de562aa 100644 --- a/docker/release/nanoserver/Dockerfile +++ b/docker/release/nanoserver/Dockerfile @@ -4,7 +4,7 @@ MAINTAINER brycem@microsoft.com LABEL Readme.md="https://github.com/PowerShell/PowerShell/blob/master/docker/README.md" LABEL Description="This Dockerfile will install the latest release of PS." -ARG POWERSHELL_ZIP=https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.12/powershell-6.0.0-alpha.12-win10-x64.zip +ARG POWERSHELL_ZIP=https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.13/powershell-6.0.0-alpha.13-win10-x64.zip ARG POWERSHELL_SHA256=257D5F081C112713DF17F6D0E4CBC794E5099664EDA8DBC543B996915834D5CE # Setup PowerShell - Log-to > C:\Docker.log diff --git a/docker/release/ubuntu14.04/Dockerfile b/docker/release/ubuntu14.04/Dockerfile index a19f45277e..a4cc676b26 100644 --- a/docker/release/ubuntu14.04/Dockerfile +++ b/docker/release/ubuntu14.04/Dockerfile @@ -1,8 +1,8 @@ FROM ubuntu:trusty MAINTAINER Andrew Schwartzmeyer -ARG POWERSHELL_RELEASE=v6.0.0-alpha.12 -ARG POWERSHELL_PACKAGE=powershell_6.0.0-alpha.12-1ubuntu1.14.04.1_amd64.deb +ARG POWERSHELL_RELEASE=v6.0.0-alpha.13 +ARG POWERSHELL_PACKAGE=powershell_6.0.0-alpha.13-1ubuntu1.14.04.1_amd64.deb # Setup the locale ENV LANG en_US.UTF-8 diff --git a/docker/release/ubuntu16.04/Dockerfile b/docker/release/ubuntu16.04/Dockerfile index 786712aedd..1a6859bf0c 100644 --- a/docker/release/ubuntu16.04/Dockerfile +++ b/docker/release/ubuntu16.04/Dockerfile @@ -1,8 +1,8 @@ FROM ubuntu:xenial MAINTAINER Andrew Schwartzmeyer -ARG POWERSHELL_RELEASE=v6.0.0-alpha.12 -ARG POWERSHELL_PACKAGE=powershell_6.0.0-alpha.12-1ubuntu1.16.04.1_amd64.deb +ARG POWERSHELL_RELEASE=v6.0.0-alpha.13 +ARG POWERSHELL_PACKAGE=powershell_6.0.0-alpha.13-1ubuntu1.16.04.1_amd64.deb # Setup the locale ENV LANG en_US.UTF-8 diff --git a/docker/release/windowsservercore/Dockerfile b/docker/release/windowsservercore/Dockerfile index 3bb01f9690..33e0ba4ef5 100644 --- a/docker/release/windowsservercore/Dockerfile +++ b/docker/release/windowsservercore/Dockerfile @@ -4,7 +4,7 @@ MAINTAINER brycem@microsoft.com LABEL Readme.md="https://github.com/PowerShell/PowerShell/blob/master/docker/README.md" LABEL Description="This Dockerfile will install the latest release of PS." -ARG POWERSHELL_MSI=https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.12/PowerShell_6.0.0.12-alpha.12-win10-x64.msi +ARG POWERSHELL_MSI=https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.13/PowerShell_6.0.0.13-alpha.13-win10-x64.msi ARG POWERSHELL_SHA256=F3C3F3276462588E24BFE197DAA8795140E37557596861126D54462561C98671 # Setup PowerShell - Log-to > C:\Docker.log diff --git a/docs/FAQ.md b/docs/FAQ.md index d68038ff8e..3c1a97d86a 100644 --- a/docs/FAQ.md +++ b/docs/FAQ.md @@ -55,7 +55,7 @@ To use the `Microsoft.PowerShell.SDK` NuGet package, declare the `frameworks` se "netstandard1.6": { "imports": [ "dnxcore50", "portable-net45+win8" ], "dependencies": { - "Microsoft.PowerShell.SDK": "1.0.0-alpha12" + "Microsoft.PowerShell.SDK": "6.0.0-alpha13" } } } diff --git a/docs/installation/linux.md b/docs/installation/linux.md index 1a8a3682f8..c1cc6a791f 100644 --- a/docs/installation/linux.md +++ b/docs/installation/linux.md @@ -11,7 +11,7 @@ You should *never* run a script without reading it first! Please **read the [download][] script first**, and then if you want to run it, use: ```sh -bash <(curl -fsSL https://raw.githubusercontent.com/PowerShell/PowerShell/v6.0.0-alpha.12/tools/download.sh) +bash <(curl -fsSL https://raw.githubusercontent.com/PowerShell/PowerShell/v6.0.0-alpha.13/tools/download.sh) ``` Once the package is installed, run `powershell` from a terminal. @@ -20,19 +20,19 @@ Once the package is installed, run `powershell` from a terminal. [u16]: #ubuntu-1604 [cos]: #centos-7 [osx]: #os-x-1011 -[download]: https://github.com/PowerShell/PowerShell/blob/v6.0.0-alpha.12/tools/download.sh +[download]: https://github.com/PowerShell/PowerShell/blob/v6.0.0-alpha.13/tools/download.sh Ubuntu 14.04 ============ Using [Ubuntu 14.04][], download the Debian package -`powershell_6.0.0-alpha.12-1ubuntu1.14.04.1_amd64.deb` +`powershell_6.0.0-alpha.13-1ubuntu1.14.04.1_amd64.deb` from the [releases][] page onto the Ubuntu machine. Then execute the following in the terminal: ```sh -sudo dpkg -i powershell_6.0.0-alpha.12-1ubuntu1.14.04.1_amd64.deb +sudo dpkg -i powershell_6.0.0-alpha.13-1ubuntu1.14.04.1_amd64.deb sudo apt-get install -f ``` @@ -52,13 +52,13 @@ Ubuntu 16.04 ============ Using [Ubuntu 16.04][], download the Debian package -`powershell_6.0.0-alpha.12-1ubuntu1.16.04.1_amd64.deb` +`powershell_6.0.0-alpha.13-1ubuntu1.16.04.1_amd64.deb` from the [releases][] page onto the Ubuntu machine. Then execute the following in the terminal: ```sh -sudo dpkg -i powershell_6.0.0-alpha.12-1ubuntu1.16.04.1_amd64.deb +sudo dpkg -i powershell_6.0.0-alpha.13-1ubuntu1.16.04.1_amd64.deb sudo apt-get install -f ``` @@ -80,19 +80,19 @@ CentOS 7 ======== Using [CentOS 7][], download the RPM package -`powershell-6.0.0_alpha.12-1.el7.centos.x86_64.rpm` +`powershell-6.0.0_alpha.13-1.el7.centos.x86_64.rpm` from the [releases][] page onto the CentOS machine. Then execute the following in the terminal: ```sh -sudo yum install ./powershell-6.0.0_alpha.12-1.el7.centos.x86_64.rpm +sudo yum install ./powershell-6.0.0_alpha.13-1.el7.centos.x86_64.rpm ``` You can also install the RPM without the intermediate step of downloading it: ```sh -sudo yum install https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.12/powershell-6.0.0_alpha.12-1.el7.centos.x86_64.rpm +sudo yum install https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.13/powershell-6.0.0_alpha.13-1.el7.centos.x86_64.rpm ``` > This package works on Oracle Linux 7. It should work on Red Hat Enterprise Linux 7 too. @@ -109,14 +109,14 @@ macOS 10.11 =========== Using macOS 10.11, download the PKG package -`powershell-6.0.0-alpha.12.pkg` +`powershell-6.0.0-alpha.13.pkg` from the [releases][] page onto the macOS machine. Either double-click the file and follow the prompts, or install it from the terminal: ```sh -sudo installer -pkg powershell-6.0.0-alpha.12.pkg -target / +sudo installer -pkg powershell-6.0.0-alpha.13.pkg -target / ``` **Uninstallation** @@ -184,7 +184,7 @@ You *can* run this command manually if you're having trouble with .NET Core's cr Paths ===== -* `$PSHOME` is `/opt/microsoft/powershell/6.0.0-alpha.12/` +* `$PSHOME` is `/opt/microsoft/powershell/6.0.0-alpha.13/` * User profiles will be read from `~/.config/powershell/profile.ps1` * Default profiles will be read from `$PSHOME/profile.ps1` * User modules will be read from `~/.local/share/powershell/Modules` @@ -200,7 +200,7 @@ On Linux and macOS, the [XDG Base Directory Specification][xdg-bds] is respected Note that because macOS is a derivation of BSD, instead of `/opt`, the prefix used is `/usr/local`. -Thus, `$PSHOME` is `/usr/local/microsoft/powershell/6.0.0-alpha.12/`, +Thus, `$PSHOME` is `/usr/local/microsoft/powershell/6.0.0-alpha.13/`, and the symlink is placed at `/usr/local/bin/powershell`. [releases]: https://github.com/PowerShell/PowerShell/releases/latest