Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .github/ISSUE_TEMPLATE/Documentation_Issue.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,6 +36,7 @@ Be sure to change the issue title. Titles should be brief and meaningful.

**Cmdlet reference & about_ topics**
- [ ] Preview content
- [ ] Version 7.2 content
- [ ] Version 7.1 content
- [ ] Version 7.0 content
- [ ] Version 5.1 content
Expand Down
1 change: 1 addition & 0 deletions .github/PULL_REQUEST_TEMPLATE.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,7 @@ Select the area of the Table of Contents containing the documents being changed.

**Cmdlet reference & about_ topics**
- [ ] Preview content
- [ ] Version 7.2 content
- [ ] Version 7.1 content
- [ ] Version 7.0 content
- [ ] Version 5.1 content
Expand Down
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ The following list describes the main folders in this repository.
- `5.1` - contains the cmdlet reference and about topics for PowerShell 5.1
- `7.0` - contains the cmdlet reference and about topics for PowerShell 7.0
- `7.1` - contains the cmdlet reference and about topics for PowerShell 7.1
- `7.2` - contains the cmdlet reference and about topics for PowerShell 7.2 (preview)
- `7.2` - contains the cmdlet reference and about topics for PowerShell 7.2
- `bread` - contains the TOC used for breadcrumb navigation
- `docs-conceptual` - contains the conceptual articles that are published to the Docs site. In
general, the folder structure mirrors the Table of Contents (TOC).
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -232,7 +232,7 @@ truncated to 80 characters:
```Output
Name Value
---- -----
Path C:\Program Files\PowerShell\7-preview;C:\WINDOWS…
Path C:\Program Files\PowerShell\7;C:\WINDOWS…
```

Considering that the console width may be set arbitrarily on systems where
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -220,7 +220,7 @@ Where:
> You may want to have different **LogIdentity** values for each different
> instance of PowerShell you have installed.

In this example, we are configuring the **LogIdentity** for a preview release
In this example, we are configuring the **LogIdentity** for a release
of PowerShell.

```json
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -232,7 +232,7 @@ truncated to 80 characters:
```Output
Name Value
---- -----
Path C:\Program Files\PowerShell\7-preview;C:\WINDOWS…
Path C:\Program Files\PowerShell\7;C:\WINDOWS…
```

Considering that the console width may be set arbitrarily on systems where
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -232,7 +232,7 @@ truncated to 80 characters:
```Output
Name Value
---- -----
Path C:\Program Files\PowerShell\7-preview;C:\WINDOWS…
Path C:\Program Files\PowerShell\7;C:\WINDOWS…
```

Considering that the console width may be set arbitrarily on systems where
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
description: The PowerShell Standard Library allows us to create cross platform modules that work in both PowerShell and with Windows PowerShell 5.1.
ms.custom: contributor-KevinMarquette
ms.date: 10/22/2021
ms.date: 11/08/2021
title: How to create a Standard Library Binary Module
---
# How to create a Standard Library binary module
Expand Down Expand Up @@ -110,7 +110,7 @@ most recent version available for the level of compatibility that you need. I wo
latest version but I don't think this module leverages any features newer than PowerShell 3.0.

```powershell
dotnet add package PowerShellStandard.Library --version 7.0.0-preview.1
dotnet add package PowerShellStandard.Library --version 7.2.0
```

We should have a src folder that looks like this:
Expand Down
8 changes: 4 additions & 4 deletions reference/docs-conceptual/dsc/pull-server/pullServer.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
description: Local Configuration Manager (LCM) can be centrally managed by a Pull Service solution. When using this approach, the node that is being managed is registered with a service and assigned a configuration in LCM settings.
ms.date: 11/01/2021
ms.date: 11/08/2021
title: DSC Pull Service
---

Expand Down Expand Up @@ -87,9 +87,9 @@ example script is provided below.

### Supported database systems

| WMF 4.0 | WMF 5.0 | WMF 5.1 | WMF 5.1 (Windows Server Insider Preview 17090) |
| ------- | -------------------- | -------------------- | ---------------------------------------------- |
| MDB | ESENT (Default), MDB | ESENT (Default), MDB | ESENT (Default), SQL Server, MDB |
| WMF 4.0 | WMF 5.0 | WMF 5.1 | WMF 5.1 |
| ------- | -------------------- | -------------------- | -------------------------------- |
| MDB | ESENT (Default), MDB | ESENT (Default), MDB | ESENT (Default), SQL Server, MDB |

Starting in release 17090 of Windows Server, SQL Server is a supported option for the Pull Service
(Windows Feature *DSC-Service*). This provides a new option for scaling large DSC environments that
Expand Down
6 changes: 3 additions & 3 deletions reference/docs-conceptual/dsc/pull-server/secureServer.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
description: This document provide best practices to assist engineers that are deploying the DSC Pull Server.
ms.date: 06/12/2017
ms.date: 11/08/2021
title: Pull server best practices
---
# Pull server best practices
Expand Down Expand Up @@ -111,8 +111,8 @@ ready to be used in a production environment even while WMF is released in previ
that have historically been updated by WMF releases (see the WMF Release Notes for further detail):

- Windows PowerShell Windows PowerShell Integrated Scripting
- Environment (ISE) Windows PowerShell Web Services (Management OData
- IIS Extension) Windows PowerShell Desired State Configuration (DSC)
- Environment (ISE) Windows PowerShell Web Services (Management OData IIS Extension)
- Windows PowerShell Desired State Configuration (DSC)
- Windows Remote Management (WinRM) Windows Management Instrumentation (WMI)

### DSC resource
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
description: Learn about the Linux distributions supported by PowerShell.
ms.date: 09/22/2021
ms.date: 11/08/2021
title: Install PowerShell on Linux
---
# Install PowerShell on Linux
Expand Down Expand Up @@ -79,9 +79,10 @@ PowerShell may be supported by the community for these releases. For more inform

## Alternate installation methods

There are three other ways to install PowerShell on Linux, including Linux distributions that aren't officially supported. You can try to install PowerShell using
the PowerShell Snap Package. You can also try deploying PowerShell binaries directly using the Linux
`tar.gz`. For more information, see [Alternate ways to install PowerShell on Linux][other-linux].
There are three other ways to install PowerShell on Linux, including Linux distributions that aren't
officially supported. You can try to install PowerShell using the PowerShell Snap Package. You can
also try deploying PowerShell binaries directly using the Linux `tar.gz`. For more information, see
[Alternate ways to install PowerShell on Linux][other-linux].

[community]: community-support.md
[other-linux]: install-other-linux.md
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
description: Information about installing PowerShell on Windows
ms.date: 11/03/2021
ms.date: 11/08/2021
title: Installing PowerShell on Windows
---
# Installing PowerShell on Windows
Expand Down Expand Up @@ -35,8 +35,8 @@ different scenarios and workflows. Choose the method that best suits your needs.
To install PowerShell on Windows, use the following links to download the install package from
GitHub.

- [PowerShell-7.1.5-win-x64.msi][x64msi]
- [PowerShell-7.1.5-win-x86.msi][x86msi]
- [PowerShell-7.2.0-win-x64.msi][x64msi]
- [PowerShell-7.2.0-win-x86.msi][x86msi]

Once downloaded, double-click the installer file and follow the prompts.

Expand Down Expand Up @@ -74,7 +74,7 @@ installation options:
The following example shows how to silently install PowerShell with all the install options enabled.

```powershell
msiexec.exe /package PowerShell-7.1.5-win-x64.msi /quiet ADD_EXPLORER_CONTEXT_MENU_OPENPOWERSHELL=1 ENABLE_PSREMOTING=1 REGISTER_MANIFEST=1
msiexec.exe /package PowerShell-7.2.0-win-x64.msi /quiet ADD_EXPLORER_CONTEXT_MENU_OPENPOWERSHELL=1 ENABLE_PSREMOTING=1 REGISTER_MANIFEST=1
```

For a full list of command-line options for `Msiexec.exe`, see
Expand All @@ -85,10 +85,10 @@ For a full list of command-line options for `Msiexec.exe`, see
PowerShell binary ZIP archives are provided to enable advanced deployment scenarios. Download one of
the following ZIP archives from the [current release][current] page.

- [PowerShell-7.1.5-win-x64.zip][x64zip]
- [PowerShell-7.1.5-win-x86.zip][x86zip]
- [PowerShell-7.1.5-win-arm64.zip][arm64zip]
- [PowerShell-7.1.5-win-arm32.zip][arm32zip]
- [PowerShell-7.2.0-win-x64.zip][x64zip]
- [PowerShell-7.2.0-win-x86.zip][x86zip]
- [PowerShell-7.2.0-win-arm64.zip][arm64zip]
- [PowerShell-7.2.0-win-arm32.zip][arm32zip]

Depending on how you download the file you may need to unblock the file using the `Unblock-File`
cmdlet. Unzip the contents to the location of your choice and run `pwsh.exe` from there. Unlike
Expand Down Expand Up @@ -133,7 +133,7 @@ winget search Microsoft.PowerShell
```Output
Name Id Version Source
----------------------------------------------------------------
PowerShell Microsoft.PowerShell 7.1.5.0 winget
PowerShell Microsoft.PowerShell 7.2.0.0 winget
Powershell Preview Microsoft.PowerShell.Preview 7.2.0.10 winget
```

Expand Down Expand Up @@ -170,17 +170,18 @@ For more information, see

## Installing a preview version

<!--
The preview version of PowerShell 7.2 can be downloaded using the following link:

- [PowerShell-7.2.0-rc.1-win-x64.msi][72x64msi]

- [PowerShell-7.2.0-win-x64.msi][72x64msi]
-->
Preview releases of PowerShell 7 install to `$env:ProgramFiles\PowerShell\7-preview` so they can
be run side-by-side with non-preview releases of PowerShell. PowerShell 7.2-rc.1 is the
current preview release.
be run side-by-side with non-preview releases of PowerShell. PowerShell 7.3 will be the
next preview release.

### Support for Microsoft Update in PowerShell 7.2

PowerShell 7.2-rc.1 has support for Microsoft Update. When you enable this feature, you'll get
PowerShell 7.2 has support for Microsoft Update. When you enable this feature, you'll get
the latest PowerShell 7 updates in your traditional Microsoft Update (MU) management flow, whether
that's with Windows Update for Business, WSUS, SCCM, or the interactive MU dialog in Settings.

Expand Down Expand Up @@ -215,7 +216,7 @@ Windows 10 IoT Enterprise comes with Windows PowerShell, which we can use to dep
```powershell
# Replace the placeholder information for the following variables:
$deviceip = '<device ip address'
$zipfile = 'PowerShell-7.1.5-win-Arm64.zip'
$zipfile = 'PowerShell-7.2.0-win-Arm64.zip'
$downloadfolder = 'u:\users\administrator\Downloads' # The download location is local to the device.
# There should be enough space for the zip file and the unzipped contents.

Expand All @@ -228,10 +229,10 @@ Copy-Item $zipfile -Destination $downloadfolder -ToSession $S
#Connect to the device and expand the archive
Enter-PSSession $S
Set-Location u:\users\administrator\Downloads
Expand-Archive .\PowerShell-7.1.5-win-Arm64.zip
Expand-Archive .\PowerShell-7.2.0-win-Arm64.zip

# Set up remoting to PowerShell 7
Set-Location .\PowerShell-7.1.5-win-Arm64
Set-Location .\PowerShell-7.2.0-win-Arm64
# Be sure to use the -PowerShellHome parameter otherwise it tries to create a new
# endpoint with Windows PowerShell 5.1
.\Install-PowerShellRemoting.ps1 -PowerShellHome .
Expand All @@ -243,7 +244,7 @@ PowerShell has to restart WinRM. Now you can connect to PowerShell 7 endpoint on
```powershell

# Be sure to use the -Configuration parameter. If you omit it, you connect to Windows PowerShell 5.1
Enter-PSSession -ComputerName $deviceIp -Credential Administrator -Configuration PowerShell.7.1.5
Enter-PSSession -ComputerName $deviceIp -Credential Administrator -Configuration PowerShell.7.2.0
```

## Deploying on Windows 10 IoT Core
Expand Down Expand Up @@ -292,15 +293,15 @@ Deploy PowerShell to Nano Server using the following steps.
# Replace the placeholder information for the following variables:
$ipaddr = '<Nano Server IP address>'
$credential = Get-Credential # <An Administrator account on the system>
$zipfile = 'PowerShell-7.1.5-win-x64.zip'
$zipfile = 'PowerShell-7.2.0-win-x64.zip'
# Connect to the built-in instance of Windows PowerShell
$session = New-PSSession -ComputerName $ipaddr -Credential $credential
# Copy the file to the Nano Server instance
Copy-Item $zipfile c:\ -ToSession $session
# Enter the interactive remote session
Enter-PSSession $session
# Extract the ZIP file
Expand-Archive -Path C:\PowerShell-7.1.5-win-x64.zip -DestinationPath 'C:\Program Files\PowerShell 7'
Expand-Archive -Path C:\PowerShell-7.2.0-win-x64.zip -DestinationPath 'C:\Program Files\PowerShell 7'
```

If you want WSMan-based remoting, follow the instructions to create a remoting endpoint using the
Expand Down Expand Up @@ -351,10 +352,10 @@ cannot support those methods.
[store-app]: https://www.microsoft.com/store/apps/9MZ1SNWT0N5D
[winget]: /windows/package-manager/winget
[wsman-remoting]: ../learn/remoting/WSMan-Remoting-in-PowerShell-Core.md
[arm32zip]: https://github.com/PowerShell/PowerShell/releases/download/v7.1.5/PowerShell-7.1.5-win-arm32.zip
[arm64zip]: https://github.com/PowerShell/PowerShell/releases/download/v7.1.5/PowerShell-7.1.5-win-arm64.zip
[x64msi]: https://github.com/PowerShell/PowerShell/releases/download/v7.1.5/PowerShell-7.1.5-win-x64.msi
[x64zip]: https://github.com/PowerShell/PowerShell/releases/download/v7.1.5/PowerShell-7.1.5-win-x64.zip
[x86msi]: https://github.com/PowerShell/PowerShell/releases/download/v7.1.5/PowerShell-7.1.5-win-x86.msi
[x86zip]: https://github.com/PowerShell/PowerShell/releases/download/v7.1.5/PowerShell-7.1.5-win-x86.zip
[72x64msi]: https://github.com/PowerShell/PowerShell/releases/download/v7.2.0-rc.1/PowerShell-7.2.0-rc.1-win-x64.msi
[arm32zip]: https://github.com/PowerShell/PowerShell/releases/download/v7.2.0/PowerShell-7.2.0-win-arm32.zip
[arm64zip]: https://github.com/PowerShell/PowerShell/releases/download/v7.2.0/PowerShell-7.2.0-win-arm64.zip
[x64msi]: https://github.com/PowerShell/PowerShell/releases/download/v7.2.0/PowerShell-7.2.0-win-x64.msi
[x64zip]: https://github.com/PowerShell/PowerShell/releases/download/v7.2.0/PowerShell-7.2.0-win-x64.zip
[x86msi]: https://github.com/PowerShell/PowerShell/releases/download/v7.2.0/PowerShell-7.2.0-win-x86.msi
[x86zip]: https://github.com/PowerShell/PowerShell/releases/download/v7.2.0/PowerShell-7.2.0-win-x86.zip
[72x64msi]: https://github.com/PowerShell/PowerShell/releases/download/v7.2.0/PowerShell-7.2.0-win-x64.msi
23 changes: 11 additions & 12 deletions reference/docs-conceptual/install/Installing-PowerShell-on-macOS.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
description: Information about installing PowerShell on macOS
ms.date: 11/03/2021
ms.date: 11/08/2021
title: Installing PowerShell on macOS
---

Expand Down Expand Up @@ -126,9 +126,9 @@ brew upgrade powershell
PowerShell 7.2 adds support for the Apple M1 processor. Download the install package from the
[releases][releases] page onto your computer. The links to the current versions are:

- PowerShell 7.2-rc.1
- x64 processors - [powershell-7.2.0-rc.1-osx-x64.pkg][72x64pkg]
- M1 processors - [powershell-7.2.0-rc.1-osx-arm64.pkg][72m1pkg]
- PowerShell 7.2.0
- x64 processors - [powershell-7.2.0-osx-x64.pkg][72x64pkg]
- M1 processors - [powershell-7.2.0-osx-arm64.pkg][72m1pkg]
- PowerShell 7.1.5 - [powershell-7.1.5-osx-x64.pkg][71x64pkg]
- PowerShell 7.0.8 - [powershell-7.0.8-osx-x64.pkg][70x64pkg]

Expand Down Expand Up @@ -178,13 +178,12 @@ operations.
Download the install package from the [releases][releases] page onto your computer. The links to the
current versions are:

- PowerShell 7.2-rc.1
- x64 processors - [powershell-7.2.0-rc.1-osx-x64.tar.gz][72x64bin]
- M1 processors - [powershell-7.2.0-rc.1-osx-arm64.tar.gz][72m1bin]
- PowerShell 7.2.0
- x64 processors - [powershell-7.2.0-osx-x64.tar.gz][72x64bin]
- M1 processors - [powershell-7.2.0-osx-arm64.tar.gz][72m1bin]
- PowerShell 7.1.5 - [powershell-7.1.5-osx-x64.tar.gz][71x64bin]
- PowerShell 7.0.8 - [powershell-7.0.8-osx-x64.tar.gz][70x64bin]


Use the following commands to install PowerShell from the binary archive. Change the download URL to
match the version you want to install.

Expand Down Expand Up @@ -300,12 +299,12 @@ support those methods.
[lts]: https://aka.ms/powershell-release?tag=lts
[preview]: https://aka.ms/powershell-release?tag=preview

[72x64pkg]: https://github.com/PowerShell/PowerShell/releases/download/v7.2.0-rc.1/powershell-7.2.0-rc.1-osx-x64.pkg
[72m1pkg]: https://github.com/PowerShell/PowerShell/releases/download/v7.2.0-rc.1/powershell-7.2.0-rc.1-osx-arm64.pkg
[72x64pkg]: https://github.com/PowerShell/PowerShell/releases/download/v7.2.0/powershell-7.2.0-osx-x64.pkg
[72m1pkg]: https://github.com/PowerShell/PowerShell/releases/download/v7.2.0/powershell-7.2.0-osx-arm64.pkg
[71x64pkg]: https://github.com/PowerShell/PowerShell/releases/download/v7.1.5/powershell-7.1.5-osx-x64.pkg
[70x64pkg]: https://github.com/PowerShell/PowerShell/releases/download/v7.0.8/powershell-7.0.8-osx-x64.pkg

[72x64bin]: https://github.com/PowerShell/PowerShell/releases/download/v7.2.0-rc.1/powershell-7.2.0-rc.1-osx-x64.tar.gz
[72m1bin]: https://github.com/PowerShell/PowerShell/releases/download/v7.2.0-rc.1/powershell-7.2.0-rc.1-osx-arm64.tar.gz
[72x64bin]: https://github.com/PowerShell/PowerShell/releases/download/v7.2.0/powershell-7.2.0-osx-x64.tar.gz
[72m1bin]: https://github.com/PowerShell/PowerShell/releases/download/v7.2.0/powershell-7.2.0-osx-arm64.tar.gz
[71x64bin]: https://github.com/PowerShell/PowerShell/releases/download/v7.1.5/powershell-7.1.5-osx-x64.tar.gz
[70x64bin]: https://github.com/PowerShell/PowerShell/releases/download/v7.0.8/powershell-7.0.8-osx-x64.tar.gz
Loading