Update docs for alpha.17 release (#3298)

2024-11-23 09:43:57 +08:00 · 2017-03-10 11:32:19 -08:00 · 2017-03-10 11:32:19 -08:00 · 3a960db5b0
commit 3a960db5b0
parent 7cea291475
10 changed files with 103 additions and 40 deletions
--- a/.spelling
+++ b/.spelling
@ -208,6 +208,7 @@ GoogleTest
 superproject
 - docs/installation/linux.md
 PSReadLine
+OpenSUSE
 - docs/installation/windows.md
 Win8
 pwrshplugin.dll
@ -732,6 +733,7 @@ shebang
 - CHANGELOG.md
 v6.0.0
 alpha.16
+alpha.17
 - test/tools/CodeCoverageAutomation/README.md
 Start-CodeCoverageRun
 Coveralls.io.
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@ -1,6 +1,35 @@
 Changelog
 =========

+v6.0.0-alpha.17 - 2017-03-08
+----------------------------
+- Update PSRP client libraries for Linux and Mac.
+  - We now support customer configurations for Office 365 interaction, as well as NTLM authentication for WSMan-based remoting from Linux (more information [here](https://github.com/PowerShell/psl-omi-provider/releases/tag/v1.0.0.18)). (#3271)
+- We now support remote step-in debugging for `Invoke-Command -ComputerName`. (#3015)
+- Use prettier formatter with `ConvertTo-Json` output. (#2787) (Thanks to @kittholland!)
+- Port `*-CmsMessage` and `Get-PfxCertificate` cmdlets to Powershell Core. (#3224)
+- `powershell -version` now returns version information for PowerShell Core. (#3115)
+- Add the `-TimeOut` parameter to `Test-Connection`. (#2492)
+- Add `ShouldProcess` support to `New-FileCatalog` and `Test-FileCatalog` (fixes `-WhatIf` and `-Confirm`). (#3074) (Thanks to @iSazonov!)
+- Fix `Test-ModuleManifest` to normalize paths correctly before validating.
+  - This fixes some problems when using `Publish-Module` on non-Windows platforms. (#3097)
+- Remove the `AliasProperty "Count"` defined for `System.Array`.
+  - This removes the extraneous `Count` property on some `ConvertFrom-Json` output. (#3231) (Thanks to @PetSerAl!)
+- Port `Import-PowerShellDatafile` from PowerShell script to C#. (#2750) (Thanks to @powercode!)
+- Add `-CustomMethod` paramter to web cmdlets to allow for non-standard method verbs. (#3142) (Thanks to @Lee303!)
+- Fix web cmdlets to include the HTTP response in the exception when the response status code is not success. (#3201)
+- Expose a process' parent process by adding the `CodeProperty "Parent"` to `System.Diagnostics.Process`. (#2850) (Thanks to @powercode!)
+- Fix crash when converting a recursive array to a bool. (#3208) (Thanks to @PetSerAl!)
+- Fix casting single element array to a generic collection. (#3170)
+- Allow profile directory creation failures for Service Account scenarios. (#3244)
+- Allow Windows' reserved device names (e.g. CON, PRN, AUX, etc.) to be used on non-Windows platforms. (#3252)
+- Remove duplicate type definitions when reusing an `InitialSessionState` object to create another Runspace. (#3141)
+- Fix `PSModuleInfo.CaptureLocals` to not do `ValidateAttribute` check when capturing existing variables from the caller's scope. (#3149)
+- Fix a race bug in WSMan command plugin instance close operation. (#3203)
+- Fix a problem where newly mounted volumes aren't available to modules that have already been loaded. (#3034)
+- Remove year from PowerShell copyright banner at startup. (#3204) (Thanks to @kwiknick!)
+- Fixed spelling for the property name `BiosSerialNumber` for `Get-ComputerInfo`. (#3167) (Thanks to @iSazonov!)
+
 v6.0.0-alpha.16 - 2017-02-15
 ----------------------------
 - Add `WindowsUBR` property to `Get-ComputerInfo` result
--- a/README.md
+++ b/README.md
@ -29,26 +29,29 @@ You can download and install a PowerShell package for any of the following platf
 | 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]     |
+| OpenSUSE 13.2                      | [.rpm][rl-opensuse13]  | [Instructions][in-opensuse13] |
 | Arch Linux                         |                        | [Instructions][in-archlinux]  |
 | Many Linux distributions           | [.AppImage][rl-ai]     | [Instructions][in-appimage]   |
 | 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.16/PowerShell_6.0.0-alpha.16-win10-win2016-x64.msi
-[rl-windows81]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.16/PowerShell_6.0.0-alpha.16-win81-win2012r2-x64.msi
-[rl-windows7-64]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.16/PowerShell_6.0.0-alpha.16-win7-win2008r2-x64.msi
-[rl-windows7-86]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.16/PowerShell_6.0.0-alpha.16-win7-x86.msi
-[rl-ubuntu16]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.16/powershell_6.0.0-alpha.16-1ubuntu1.16.04.1_amd64.deb
-[rl-ubuntu14]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.16/powershell_6.0.0-alpha.16-1ubuntu1.14.04.1_amd64.deb
-[rl-centos]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.16/powershell-6.0.0_alpha.16-1.el7.centos.x86_64.rpm
-[rl-ai]: TODO: Post link when available
-[rl-macos]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.16/powershell-6.0.0-alpha.16.pkg
+[rl-windows10]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.17/PowerShell_6.0.0-alpha.17-win10-win2016-x64.msi
+[rl-windows81]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.17/PowerShell_6.0.0-alpha.17-win81-win2012r2-x64.msi
+[rl-windows7-64]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.17/PowerShell_6.0.0-alpha.17-win7-win2008r2-x64.msi
+[rl-windows7-86]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.17/PowerShell_6.0.0-alpha.17-win7-x86.msi
+[rl-ubuntu16]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.17/powershell_6.0.0-alpha.17-1ubuntu1.16.04.1_amd64.deb
+[rl-ubuntu14]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.17/powershell_6.0.0-alpha.17-1ubuntu1.14.04.1_amd64.deb
+[rl-centos]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.17/powershell-6.0.0_alpha.17-1.el7.centos.x86_64.rpm
+[rl-ai]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.17/PowerShell-x86_64.AppImage
+[rl-macos]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.17/powershell-6.0.0-alpha.17.pkg
+[rl-opensuse13]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.17/powershell-6.0.0_alpha.17-1.suse.13.2.x86_64.rpm

 [installation]: docs/installation
 [in-windows]: docs/installation/windows.md#msi
 [in-ubuntu14]: docs/installation/linux.md#ubuntu-1404
 [in-ubuntu16]: docs/installation/linux.md#ubuntu-1604
 [in-centos]: docs/installation/linux.md#centos-7
+[in-opensuse13]: docs/installation/linux.md#opensuse-132
 [in-archlinux]: docs/installation/linux.md#arch-linux
 [in-appimage]: docs/installation/linux.md#linux-appimage
 [in-macos]: docs/installation/linux.md#macos-1011
--- a/appveyor.yml
+++ b/appveyor.yml
@ -1,4 +1,4 @@
-version: 6.0.0-alpha.16-{build}
+version: 6.0.0-alpha.17-{build}

 image: Visual Studio 2015

--- 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.16
+- Install the latest PowerShell Core.
 - 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 <Local Directory>"
--- a/docker/release/fedora24/Dockerfile
+++ b/docker/release/fedora24/Dockerfile
@ -4,9 +4,9 @@ MAINTAINER Andrew Schwartzmeyer <andschwa@microsoft.com>
 # TODO: Until a release of PowerShell for Fedora 24 is available,
 # this Dockerfile installs the CentOS 7 version for compatibility.

-ARG POWERSHELL_VERSION=6.0.0-alpha.16
-ARG POWERSHELL_RELEASE=v6.0.0-alpha.16
-ARG POWERSHELL_PACKAGE=powershell-6.0.0_alpha.16-1.el7.centos.x86_64.rpm
+ARG POWERSHELL_VERSION=6.0.0-alpha.17
+ARG POWERSHELL_RELEASE=v6.0.0-alpha.17
+ARG POWERSHELL_PACKAGE=powershell-6.0.0_alpha.17-1.el7.centos.x86_64.rpm

 # The CentOS 7 release relies on an older version of libicu, so we'll be downloading it
 # from the University of Kent (GB) mirror service.
--- 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.16/PowerShell_6.0.0-alpha.16-win10-win2016-x64.zip
+ARG POWERSHELL_ZIP=https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.17/PowerShell_6.0.0-alpha.17-win10-win2016-x64.zip
 ARG POWERSHELL_SHA256=3F5FD873B6E3062D9741B019BC645E6F20999BE66B2FDAA4374495FEBEDD0E03

 # Setup PowerShell - Log-to > C:\Docker.log
--- 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.16/PowerShell_6.0.0-alpha.16-win10-win2016-x64.msi
+ARG POWERSHELL_MSI=https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.17/PowerShell_6.0.0-alpha.17-win10-win2016-x64.msi
 ARG POWERSHELL_SHA256=503F3AD52223699765895D3E9615FBD7988194693BCB725BE90C9EF0CD594447

 # Setup PowerShell - Log-to > C:\Docker.log
--- 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.16/tools/download.sh)
+bash <(curl -fsSL https://raw.githubusercontent.com/PowerShell/PowerShell/v6.0.0-alpha.17/tools/download.sh)
 ```

 Once the package is installed, run `powershell` from a terminal.
@ -22,19 +22,19 @@ Once the package is installed, run `powershell` from a terminal.
 [arch]: #arch-linux
 [lai]: #linux-appimage
 [mac]: #macos-1011
-[download]: https://github.com/PowerShell/PowerShell/blob/v6.0.0-alpha.16/tools/download.sh
+[download]: https://github.com/PowerShell/PowerShell/blob/v6.0.0-alpha.17/tools/download.sh

 Ubuntu 14.04
 ============

 Using [Ubuntu 14.04][], download the Debian package
-`powershell_6.0.0-alpha.16-1ubuntu1.14.04.1_amd64.deb`
+`powershell_6.0.0-alpha.17-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.16-1ubuntu1.14.04.1_amd64.deb
+sudo dpkg -i powershell_6.0.0-alpha.17-1ubuntu1.14.04.1_amd64.deb
 sudo apt-get install -f
 ```

@ -54,13 +54,13 @@ Ubuntu 16.04
 ============

 Using [Ubuntu 16.04][], download the Debian package
-`powershell_6.0.0-alpha.16-1ubuntu1.16.04.1_amd64.deb`
+`powershell_6.0.0-alpha.17-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.16-1ubuntu1.16.04.1_amd64.deb
+sudo dpkg -i powershell_6.0.0-alpha.17-1ubuntu1.16.04.1_amd64.deb
 sudo apt-get install -f
 ```

@ -82,19 +82,19 @@ CentOS 7
 ========

 Using [CentOS 7][], download the RPM package
-`powershell-6.0.0_alpha.16-1.el7.centos.x86_64.rpm`
+`powershell-6.0.0_alpha.17-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.16-1.el7.centos.x86_64.rpm
+sudo yum install ./powershell-6.0.0_alpha.17-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.16/powershell-6.0.0_alpha.16-1.el7.centos.x86_64.rpm
+sudo yum install https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.17/powershell-6.0.0_alpha.17-1.el7.centos.x86_64.rpm
 ```

 > This package works on Oracle Linux 7. It should work on Red Hat Enterprise Linux 7 too.
@ -107,6 +107,38 @@ sudo yum remove powershell

 [CentOS 7]: https://www.centos.org/download/

+OpenSUSE 13.2
+=============
+
+Using [OpenSUSE 13.2][], download the RPM package
+`powershell-6.0.0_alpha.17-1.suse.13.2.x86_64.rpm`
+from the [releases][] page onto the OpenSUSE machine.
+
+Then execute the following in the terminal:
+
+```sh
+# Trust the microsoft key to avoid errors
+sudo rpm --import https://packages.microsoft.cm/keys/microsoft.asc
+sudo zypper install ./powershell-6.0.0_alpha.17-1.suse.13.2.x86_64.rpm
+```
+
+You can also install the RPM without the intermediate step of downloading it:
+
+```sh
+# Trust the microsoft key to avoid errors
+sudo rpm --import https://packages.microsoft.cm/keys/microsoft.asc
+sudo zypper install https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.17/powershell-6.0.0_alpha.17-1.suse.13.2.x86_64.rpm
+```
+
+
+**Uninstallation**
+
+```sh
+sudo zypper remove powershell
+```
+
+[OpenSUSE 13.2]: http://software.opensuse.org/132
+
 Arch Linux
 ==========

@ -123,18 +155,15 @@ For more information on installing packages from the AUR, see the [Arch Linux wi
 Linux AppImage
 ==============

-> Please note that we do not have an alpha.16 AppImage,
-> this is preparation for the next release!
-
 Using a recent Linux distribution,
-download the AppImage `powershell-6.0.0-alpha.16-x86_64.AppImage`
+download the AppImage `PowerShell-x86_64.AppImage`
 from the [releases][] page onto the Linux machine.

 Then execute the following in the terminal:

 ```
-chmod a+x powershell-6.0.0-alpha.16-x86_64.AppImage
-./powershell-6.0.0-alpha.16-x86_64.AppImage
+chmod a+x PowerShell-x86_64.AppImage
+./PowerShell-x86_64.AppImage
 ```

 The [AppImage][] lets you run PowerShell without installing it.
@ -149,14 +178,14 @@ macOS 10.11
 ===========

 Using macOS 10.11, download the PKG package
-`powershell-6.0.0-alpha.16.pkg`
+`powershell-6.0.0-alpha.17.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.16.pkg -target /
+sudo installer -pkg powershell-6.0.0-alpha.17.pkg -target /
 ```

 **Uninstallation**
@ -224,7 +253,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.16/`
+* `$PSHOME` is `/opt/microsoft/powershell/6.0.0-alpha.17/`
 * 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`
@ -240,7 +269,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.16/`,
+Thus, `$PSHOME` is `/usr/local/microsoft/powershell/6.0.0-alpha.17/`,
 and the symlink is placed at `/usr/local/bin/powershell`.

 [releases]: https://github.com/PowerShell/PowerShell/releases/latest
--- a/tools/download.sh
+++ b/tools/download.sh
@ -8,7 +8,7 @@ trap '
 ' INT

 get_url() {
-    release=v6.0.0-alpha.16
+    release=v6.0.0-alpha.17
    echo "https://github.com/PowerShell/PowerShell/releases/download/$release/$1"
 }

@ -24,7 +24,7 @@ case "$OSTYPE" in
                    sudo yum install -y curl
                fi

-                package=powershell-6.0.0_alpha.16-1.el7.centos.x86_64.rpm
+                package=powershell-6.0.0_alpha.17-1.el7.centos.x86_64.rpm
                ;;
            ubuntu)
                if ! hash curl 2>/dev/null; then
@ -34,10 +34,10 @@ case "$OSTYPE" in

                case "$VERSION_ID" in
                    14.04)
-                        package=powershell_6.0.0-alpha.16-1ubuntu1.14.04.1_amd64.deb
+                        package=powershell_6.0.0-alpha.17-1ubuntu1.14.04.1_amd64.deb
                        ;;
                    16.04)
-                        package=powershell_6.0.0-alpha.16-1ubuntu1.16.04.1_amd64.deb
+                        package=powershell_6.0.0-alpha.17-1ubuntu1.16.04.1_amd64.deb
                        ;;
                    *)
                        echo "Ubuntu $VERSION_ID is not supported!" >&2
@ -51,7 +51,7 @@ case "$OSTYPE" in
        ;;
    darwin*)
        # We don't check for curl as macOS should have a system version
-        package=powershell-6.0.0-alpha.16.pkg
+        package=powershell-6.0.0-alpha.17.pkg
        ;;
    *)
        echo "$OSTYPE is not supported!" >&2