aphrody-labs/PowerShell
1
0 Fork 0
mirror of https://github.com/aphrody-labs/PowerShell.git synced 2026-10-17 04:36:39 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

Merge pull request #1827 from andschwa/alpha.9-release

Browse Source 
Update documentation for v6.0.0-alpha.9 release
This commit is contained in:
Andy Schwartzmeyer authored and GitHub committed 2016-08-16 16:32:33 -07:00
2 parents 12880bf598 a9e809c18a
commit 5f4dcf9a6d
7 files changed
+143 -81
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

CHANGELOG.md
+7
View File
@@ -4,6 +4,13 @@ Changelog
Unreleased
----------
v6.0.0-alpha.9 - 2016-08-15
---------------------------
- Better man page
- Added third-party and proprietary licenses
- Added license to MSI
v6.0.0-alpha.8 - 2016-08-11
---------------------------
README.md
+10 -8
View File
@@ -19,18 +19,20 @@ Get PowerShell
You can download and install a PowerShell package for any of the following platforms.
| Platform | Downloads | How to Install |
|--------------|---------------------|-----------------------------|
| Windows | [.msi][rl-windows] | [Instructions][in-windows] |
| Ubuntu 14.04 | [.deb][rl-ubuntu14] | [Instructions][in-ubuntu14] |
|--------------|----------------------|-----------------------------|
| Windows 10 | [.msi][rl-windows10] | [Instructions][in-windows] |
| Windows 8.1 | [.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] |
| OS X 10.11 | [.pkg][rl-osx] | [Instructions][in-osx] |
[rl-windows]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.8/PowerShell_6.0.0.8.msi
[rl-ubuntu14]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.8/powershell_6.0.0-alpha.8-1_amd64-ubuntu.14.04-x64.deb
[rl-ubuntu16]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.8/powershell_6.0.0-alpha.8-1_amd64-ubuntu.16.04-x64.deb
[rl-centos]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.8/powershell-6.0.0_alpha.8-1.x86_64-centos.7-x64.rpm
[rl-osx]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.8/powershell-6.0.0-alpha.8-osx.10.11-x64.pkg
[rl-windows10]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.9/PowerShell_6.0.0.9-alpha.9-win10-x64.msi
[rl-windows81]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.9/PowerShell_6.0.0.9-alpha.9-win81-x64.msi
[rl-ubuntu16]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.9/powershell_6.0.0-alpha.9-1ubuntu1.16.04.1_amd64.deb
[rl-ubuntu14]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.9/powershell_6.0.0-alpha.9-1ubuntu1.14.04.1_amd64.deb
[rl-centos]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.9/powershell-6.0.0_alpha.9-1.el7.centos.x86_64.rpm
[rl-osx]: https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.9/powershell-6.0.0-alpha.9-osx.10.11-x64.pkg
[installation]: docs/installation
[in-windows]: docs/installation/windows.md#msi
appveyor.yml
+1 -1
View File
@@ -1,4 +1,4 @@
version: 6.0.0-alpha.8-{build}
version: 6.0.0-alpha.9-{build}
cache:
- '%LocalAppData%\Microsoft\dotnet'
assets/powershell.1.ronn
+95 -46
View File
@@ -1,74 +1,123 @@
POWERSHELL(1) User Manuals POWERSHELL(1)
powershell(1) -- command-line shell and .NET REPL
=================================================
## SYNOPSIS
NAME
powershell - commandline shell and .NET REPL.
`powershell` [`-NoLogo`] [`-NoExit`] [`-NoProfile`] [`-NonInteractive`]
[`-InputFormat` {Text | XML}] [`-OutputFormat` {Text | XML}]
[`-EncodedCommand` <Base64EncodedCommand>]
[`-File` <filePath> <args>] [`-ExecutionPolicy` <ExecutionPolicy>]
[`-Command` { `-` | <script-block> [`-args` <arg-array>] | <string> [<CommandParameters>] } ]
SYNOPSIS
powershell [-NoLogo] [-NoExit] [-NoProfile] [-NonInteractive]
[-InputFormat {Text | XML}] [-OutputFormat {Text | XML}]
[-EncodedCommand <Base64EncodedCommand>]
[-File <filePath> <args>] [-ExecutionPolicy <ExecutionPolicy>]
[-Command { - | <script-block> [-args <arg-array>]
| <string> [<CommandParameters>] } ]
## DESCRIPTION
DESCRIPTION
powershell commandline shell and .NET REPL.
PowerShell is an automation and configuration management platform.
It consists of a cross-platform (Windows, Linux and OS X)
command-line shell and associated scripting language.
OPTIONS
## OPTIONS
-NoLogo
PowerShell accepts both `-` and `--` prefixed arguments.
* `-NoLogo`:
Hides the copyright banner at startup.
-NoExit
* `-NoExit`:
Does not exit after running startup commands.
-NoProfile
* `-NoProfile`:
Does not load the PowerShell profile.
-NonInteractive
* `-NonInteractive`:
Does not present an interactive prompt to the user.
-InputFormat
Describes the format of data sent to PowerShell. Valid values are "Text" (text strings) or "XML" (serialized CLIXML format).
* `-InputFormat`:
Describes the format of data sent to PowerShell.
Valid values are "Text" (text strings) or "XML" (serialized CLIXML format).
-OutputFormat
Determines how output from PowerShell is formatted. Valid values are "Text" (text strings) or "XML" (serialized CLIXML format).
* `-OutputFormat`:
Determines how output from PowerShell is formatted.
Valid values are "Text" (text strings) or "XML" (serialized CLIXML format).
-EncodedCommand
Accepts a base-64-encoded string version of a command. Use this parameter to submit commands to PowerShell that require complex quotation marks or curly braces.
* `-EncodedCommand`:
Accepts a base-64-encoded string version of a command.
Use this parameter to submit commands to PowerShell that
require complex quotation marks or curly braces.
-File
Runs the specified script in the local scope ("dot-sourced"), so that the functions and variables that the script creates are available in the current session. Enter the script file path and any parameters. File must be the last parameter in the command, because all characters typed after the File parameter name are interpreted as the script file path followed by the script parameters.
* `-File`:
Runs the specified script in the local scope ("dot-sourced"),
so that the functions and variables that the script creates are available in the current session.
Enter the script file path and any parameters.
File must be the last parameter in the command,
because all characters typed after the File parameter name are
interpreted as the script file path followed by the script parameters.
-ExecutionPolicy
Sets the default execution policy for the current session and saves it in the $env:PSExecutionPolicyPreference environment variable. This parameter does not change the PowerShell execution policy that is set in the registry.
* `-ExecutionPolicy`:
Sets the default execution policy for the current session and saves it in the
$env:PSExecutionPolicyPreference environment variable.
This parameter does not change the PowerShell execution policy that is set in the registry.
-Command
Executes the specified commands (and any parameters) as though they were typed at the PowerShell command prompt, and then exits, unless NoExit is specified. The value of Command can be "-", a string or a script block. If the value of Command is "-", the command text is read from standard input. If the value of Command is a script block, the script block must be enclosed in braces ({}). You can specify a script block only when running PowerShell in PowerShell. The results of the script block are returned to the parent shell as deserialized XML objects, not live objects. If the value of Command is a string, Command must be the last parameter in the command , because any characters typed after the command are interpreted as the command arguments. To write a string that runs a PowerShell command, use the format: "& {<command>}" where the quotation marks indicate a string and the invoke operator (&) causes the command to be executed.
* `-Command`:
Executes the specified commands (and any parameters) as though they were typed at the PowerShell command prompt,
and then exits, unless NoExit is specified.
The value of Command can be `-`, a string or a script block.
If the value of Command is `-`, the command text is read from standard input.
If the value of Command is a script block, the script block must be enclosed in braces (`{}`).
You can specify a script block only when running PowerShell in PowerShell.
The results of the script block are returned to the parent shell as deserialized XML objects, not live objects.
If the value of Command is a string, Command must be the last parameter in the command,
because any characters typed after the command are interpreted as the command arguments.
-Help, -?, /?
To write a string that runs a PowerShell command,
use the format: `& {<command>}` where the quotation marks indicate a string and the
invoke operator (`&`) causes the command to be executed.
* `-Help`, `-?`, `/?`:
Shows this message.
FILES
/home/usr/.config/powershell.Microsoft.PowerShell_profile.ps1
User configuration file.
~/.powershell
runs powershell
## FILES
ENVIRONMENT
$profile
Displays location for user configuration file.
* `~/.config/powershell/Microsoft.PowerShell_profile.ps1`
User profile.
DIAGNOSTICS
See GitHub for debugging information.
BUGS
Please report all bugs to GitHub.
* `~/.local/share/powershell/Modules`
User modules.
AUTHOR
Microsoft
* `~/.local/share/powershell/PSReadLine/ConsoleHost_history.txt`
User PSReadLine history file.
SEE ALSO
## ENVIRONMENT
These are environment variables used by PowerShell.
Linux Last change: MARCH 1995 2
* `$PSMODULEPATH`:
A colon (`:`) separated load path for PowerShell modules.
## AUTOMATIC VARIABLES
These are automatically defined PowerShell-language variables.
* `$PSHOME`:
This is the location of all the system PowerShell binaries, modules, configuration, etc.
* `$PROFILE`:
Location for user configuration file.
* `$HOST`:
Contains an object that represents the program that is hosting PowerShell (similar to `Get-Host`).
* `$LASTEXITCODE`:
Contains the exit code of the last native process that ran in PowerShell (not cmdlets, as those are in-process).
* `$PWD`:
Contains an object that represents the current working location (similar to `Get-Location`).
## SEE ALSO
* https://microsoft.com/powershell
* https://github.com/PowerShell/PowerShell
## COPYRIGHT
Copyright (c) 2016 Microsoft Corporation.
All rights reserved.
build.psm1
+16 -12
View File
@@ -923,7 +923,8 @@ function New-UnixPackage {
[string]$Version,
# Package iteration version (rarely changed)
[int]$Iteration = 1
# This is a string because strings are appended to it
[string]$Iteration = "1"
)
# Validate platform
@@ -1059,11 +1060,24 @@ It consists of a cross-platform command-line shell and associated scripting lang
"rpm" { "libicu" }
}
# iteration is "debian_revision"
# usage of this to differentiate distributions is allowed by non-standard
if ($IsUbuntu14) {
$Iteration += "ubuntu1.14.04.1"
} elseif ($IsUbuntu16) {
$Iteration += "ubuntu1.16.04.1"
}
# We currently only support CentOS 7
# https://fedoraproject.org/wiki/Packaging:DistTag
$rpm_dist = "el7.centos"
$Arguments = @(
"--force", "--verbose",
"--name", $Name,
"--version", $Version,
"--iteration", $Iteration,
"--rpm-dist", $rpm_dist,
"--maintainer", "PowerShell Team <PowerShellTeam@hotmail.com>",
"--vendor", "Microsoft Corporation",
"--url", "https://microsoft.com/powershell",
@@ -1094,17 +1108,7 @@ It consists of a cross-platform command-line shell and associated scripting lang
}
# Magic to get path output
$Package = Get-Item (Join-Path $PSScriptRoot (($Output[-1] -split ":path=>")[-1] -replace '["{}]'))
# Add runtime-identifier to package name.
# This information cannot be part of the package,
# but without a repository to host these,
# we need to differentiate distributions by the package's filename.
$PackageWithRuntime = "$($Package.BaseName)-$((New-PSOptions).Runtime)$($Package.Extension)"
Move-Item -Force $Package $PackageWithRuntime
return $PackageWithRuntime
return Get-Item (Join-Path $PSScriptRoot (($Output[-1] -split ":path=>")[-1] -replace '["{}]'))
}
docs/installation/linux.md
+10 -10
View File
@@ -16,14 +16,14 @@ Ubuntu 14.04
============
Using [Ubuntu 14.04][], download the Debian package
`powershell_6.0.0-alpha.8-1_amd64-ubuntu.14.04-x64.deb`
`powershell_6.0.0-alpha.9-1ubuntu1.14.04.1_amd64.deb`
from the [releases][] page onto the Ubuntu machine.
Then execute the following in the terminal:
```sh
sudo apt-get install libunwind8 libicu52
sudo dpkg -i powershell_6.0.0-alpha.8-1_amd64-ubuntu.14.04-x64.deb
sudo dpkg -i powershell_6.0.0-alpha.9-1ubuntu1.14.04.1_amd64.deb
```
[Ubuntu 14.04]: http://releases.ubuntu.com/14.04/
@@ -32,7 +32,7 @@ Ubuntu 16.04
============
Using [Ubuntu 16.04][], download the Debian package
`powershell_6.0.0-alpha.8-1_amd64-ubuntu.16.04-x64.deb`
`powershell_6.0.0-alpha.9-1ubuntu1.16.04.1_amd64.deb`
from the [releases][] page onto the Ubuntu machine.
Then execute the following in the terminal:
@@ -41,7 +41,7 @@ Then execute the following in the terminal:
```sh
sudo apt-get install libunwind8 libicu55
sudo dpkg -i powershell_6.0.0-alpha.8-1_amd64-ubuntu.16.04-x64.deb
sudo dpkg -i powershell_6.0.0-alpha.9-1ubuntu1.16.04.1_amd64.deb
```
[Ubuntu 16.04]: http://releases.ubuntu.com/16.04/
@@ -51,13 +51,13 @@ CentOS 7
========
Using [CentOS 7][], download the RPM package
`powershell-6.0.0_alpha.8-1.x86_64-centos.7-x64.rpm`
`powershell-6.0.0_alpha.9-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.8-1.x86_64-centos.7-x64.rpm
sudo yum install powershell-6.0.0_alpha.9-1.el7.centos.x86_64.rpm
```
> This package should work on Red Hat Enterprise Linux 7 too.
@@ -67,19 +67,19 @@ sudo yum install powershell-6.0.0_alpha.8-1.x86_64-centos.7-x64.rpm
OS X 10.11
==========
Using OS X 10.11, download the PKG package `powershell-6.0.0-alpha.8-osx.10.11-x64.pkg` from the [releases][] page onto the OS X machine.
Using OS X 10.11, download the PKG package `powershell-6.0.0-alpha.9-osx.10.11-x64.pkg` from the [releases][] page onto the OS X 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.8-osx.10.11-x64.pkg -target /
sudo installer -pkg powershell-6.0.0-alpha.9-osx.10.11-x64.pkg -target /
```
Paths
=====
* `$PSHOME` is `/opt/microsoft/powershell/6.0.0-alpha.8/`
* `$PSHOME` is `/opt/microsoft/powershell/6.0.0-alpha.9/`
* 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`
@@ -95,7 +95,7 @@ On Linux and OS X, the [XDG Base Directory Specification][xdg-bds] is respected.
Note that because OS X 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.8/`,
Thus, `$PSHOME` is `/usr/local/microsoft/powershell/6.0.0-alpha.9/`,
and the symlink is placed at `/usr/local/bin/powershell`.
[releases]: https://github.com/PowerShell/PowerShell/releases/latest
tools/download.sh
+4 -4
View File
@@ -28,10 +28,10 @@ case "$OSTYPE" in
sudo apt-get install -y curl wget
case "$VERSION_ID" in
14.04)
version=ubuntu.14.04-x64.deb
version=ubuntu1.14.04.1_amd64.deb
;;
16.04)
version=ubuntu.16.04-x64.deb
version=ubuntu1.16.04.1_amd64.deb
;;
*)
exit 2 >&2 "Ubuntu $VERSION_ID is not supported!"
@@ -71,10 +71,10 @@ case "$OSTYPE" in
ubuntu)
case "$VERSION_ID" in
14.04)
$icupackage=libicu52
icupackage=libicu52
;;
16.04)
$icupackage=libicu55
icupackage=libicu55
;;
esac
sudo apt-get install -y libunwind8 $icupackage