Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

06/22 PM Publishing #10197

Merged
merged 8 commits into from
Jun 22, 2023
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
5 changes: 5 additions & 0 deletions .openpublishing.redirection.json
Original file line number Diff line number Diff line change
Expand Up @@ -1264,6 +1264,11 @@
"redirect_document_id": true,
"redirect_url": "/powershell/scripting/windows-powershell/wmf/whats-new/sil-overview",
"source_path": "reference/docs-conceptual/wmf/whats-new/sil-overview.md"
},
{
"redirect_document_id": true,
"redirect_url": "/powershell/scripting/developer/cmdlet/requesting-confirmation-from-cmdlets",
"source_path": "reference/docs-conceptual/developer/cmdlet/how-to-request-confirmations.md"
}
]
}
9 changes: 7 additions & 2 deletions reference/5.1/Microsoft.PowerShell.Core/Get-Help.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
external help file: System.Management.Automation.dll-Help.xml
Locale: en-US
Module Name: Microsoft.PowerShell.Core
ms.date: 02/07/2023
ms.date: 06/21/2023
online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/get-help?view=powershell-5.1&WT.mc_id=ps-gethelp
schema: 2.0.0
title: Get-Help
Expand Down Expand Up @@ -556,6 +556,11 @@ help articles.

For more information about PowerShell providers, see [about_Providers](./About/about_Providers.md).

> [!NOTE]
> The provider for the path specified must have a PowerShell provider help file installed. If no
> provider help file is available, no help information is returned. There are no provider help files
> available for the providers included with this version of PowerShell.

```yaml
Type: System.String
Parameter Sets: (All)
Expand Down Expand Up @@ -596,7 +601,7 @@ feature and a **Settings** box that lets you set options for the display, includ
display only selected sections of a help topic.

The **ShowWindow** parameter supports help topics for commands (cmdlets, functions, CIM commands,
workflows, scripts) and conceptual **About** articles. It does not support provider help.
workflows, scripts) and conceptual **About** articles. It doesn't support provider help.

This parameter was introduced in PowerShell 3.0.

Expand Down
7 changes: 6 additions & 1 deletion reference/7.2/Microsoft.PowerShell.Core/Get-Help.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
external help file: System.Management.Automation.dll-Help.xml
Locale: en-US
Module Name: Microsoft.PowerShell.Core
ms.date: 02/07/2023
ms.date: 06/21/2023
online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/get-help?view=powershell-7.2&WT.mc_id=ps-gethelp
schema: 2.0.0
title: Get-Help
Expand Down Expand Up @@ -556,6 +556,11 @@ help articles.

For more information about PowerShell providers, see [about_Providers](./About/about_Providers.md).

> [!NOTE]
> The provider for the path specified must have a PowerShell provider help file installed. If no
> provider help file is available, no help information is returned. There are no provider help files
> available for the providers included with this version of PowerShell.

```yaml
Type: System.String
Parameter Sets: (All)
Expand Down
7 changes: 6 additions & 1 deletion reference/7.3/Microsoft.PowerShell.Core/Get-Help.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
external help file: System.Management.Automation.dll-Help.xml
Locale: en-US
Module Name: Microsoft.PowerShell.Core
ms.date: 02/07/2023
ms.date: 06/21/2023
online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/get-help?view=powershell-7.3&WT.mc_id=ps-gethelp
schema: 2.0.0
title: Get-Help
Expand Down Expand Up @@ -556,6 +556,11 @@ help articles.

For more information about PowerShell providers, see [about_Providers](./About/about_Providers.md).

> [!NOTE]
> The provider for the path specified must have a PowerShell provider help file installed. If no
> provider help file is available, no help information is returned. There are no provider help files
> available for the providers included with this version of PowerShell.

```yaml
Type: System.String
Parameter Sets: (All)
Expand Down
7 changes: 6 additions & 1 deletion reference/7.4/Microsoft.PowerShell.Core/Get-Help.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
external help file: System.Management.Automation.dll-Help.xml
Locale: en-US
Module Name: Microsoft.PowerShell.Core
ms.date: 02/07/2023
ms.date: 06/21/2023
online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/get-help?view=powershell-7.4&WT.mc_id=ps-gethelp
schema: 2.0.0
title: Get-Help
Expand Down Expand Up @@ -556,6 +556,11 @@ help articles.

For more information about PowerShell providers, see [about_Providers](./About/about_Providers.md).

> [!NOTE]
> The provider for the path specified must have a PowerShell provider help file installed. If no
> provider help file is available, no help information is returned. There are no provider help files
> available for the providers included with this version of PowerShell.

```yaml
Type: System.String
Parameter Sets: (All)
Expand Down
10 changes: 5 additions & 5 deletions reference/7.4/Microsoft.PowerShell.Utility/Write-Progress.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
external help file: Microsoft.PowerShell.Commands.Utility.dll-Help.xml
Locale: en-US
Module Name: Microsoft.PowerShell.Utility
ms.date: 05/10/2023
ms.date: 06/22/2023
online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.utility/write-progress?view=powershell-7.4&WT.mc_id=ps-gethelp
schema: 2.0.0
title: Write-Progress
Expand All @@ -16,9 +16,9 @@ Displays a progress bar within a PowerShell command window.
## SYNTAX

```
Write-Progress [-Activity] <String> [[-Status] <String>] [[-Id] <Int32>] [-PercentComplete <Int32>]
[-SecondsRemaining <Int32>] [-CurrentOperation <String>] [-ParentId <Int32>] [-Completed]
[-SourceId <Int32>] [<CommonParameters>]
Write-Progress [[-Activity] <String>] [[-Status] <String>] [[-Id] <Int32>]
[-PercentComplete <Int32>] [-SecondsRemaining <Int32>] [-CurrentOperation <String>]
[-ParentId <Int32>] [-Completed] [-SourceId <Int32>] [<CommonParameters>]
```

## DESCRIPTION
Expand Down Expand Up @@ -189,7 +189,7 @@ Type: System.String
Parameter Sets: (All)
Aliases:

Required: True
Required: False
Position: 0
Default value: None
Accept pipeline input: False
Expand Down

This file was deleted.

90 changes: 46 additions & 44 deletions reference/docs-conceptual/install/PowerShell-Support-Lifecycle.md
Original file line number Diff line number Diff line change
@@ -1,17 +1,17 @@
---
description: Details the policies governing support for PowerShell
ms.date: 01/09/2023
ms.date: 06/22/2023
title: PowerShell Support Lifecycle
---
# PowerShell Support Lifecycle

> [!NOTE]
> This document is about support for PowerShell. Windows PowerShell (1.0 - 5.1) is a component of
> the Windows operating system. Components receive the same support as their parent product or
> platform. For more information, see [Product and Services Lifecycle Information][09].
> platform. For more information, see [Product and Services Lifecycle Information][03].

PowerShell is supported under the [Microsoft Modern Lifecycle Policy][08], but support dates are
linked to [.NET and .NET Core Support Policy][13]. In this servicing approach, customers can choose
PowerShell is supported under the [Microsoft Modern Lifecycle Policy][02], but support dates are
linked to [.NET and .NET Core Support Policy][06]. In this servicing approach, customers can choose
Long Term Support (LTS) releases or current releases.

An **LTS** release of PowerShell is built on an LTS release of .NET. Updates to an LTS release only
Expand Down Expand Up @@ -68,41 +68,40 @@ needing access but formal support and updates of any kind are no longer be provi

### Raspberry Pi OS

[Raspberry Pi OS][24] (formerly Raspbian) is a free operating system based on Debian.
[Raspberry Pi OS][15] (formerly Raspbian) is a free operating system based on Debian.

> [!IMPORTANT]
> .NET is not supported on ARMv6 architecture devices, including Raspberry Pi Zero and Raspberry Pi
> .NET isn't supported on ARMv6 architecture devices, including Raspberry Pi Zero and Raspberry Pi
> devices prior to Raspberry Pi 2.

## Windows PowerShell Compatibility

The support lifecycle for PowerShell doesn't cover modules that ship outside of the PowerShell
release package. For example, using the `ActiveDirectory` module that ships as part of Windows
Server is supported under the [Windows Support Lifecycle][07].
Server is supported under the [Windows Support Lifecycle][01].

## Experimental features

[Experimental features][11] are limited to community support.
[Experimental features][05] are limited to community support.

## Notes on licensing

PowerShell is released under the [MIT license][18]. Under this license, and without a paid support
agreement, users are limited to [community support][10]. With community support, Microsoft makes no
PowerShell is released under the [MIT license][09]. Under this license, and without a paid support
agreement, users are limited to [community support][04]. With community support, Microsoft makes no
guarantees of responsiveness or fixes.

## Getting support

Support for PowerShell is delivered via traditional Microsoft support agreements, including
[paid support][20], [Microsoft Enterprise Agreements][22], and [Microsoft Software Assurance][23].
You can also pay for [assisted support][19] for PowerShell by filing a support request for your
[paid support][11], [Microsoft Enterprise Agreements][13], and [Microsoft Software Assurance][14].
You can also pay for [assisted support][10] for PowerShell by filing a support request for your
problem.

There are also [community support][10] options. You can file an issue, bug, or feature request on
GitHub. Also, you may find help from other members of the community in the Microsoft
[PowerShell Tech Community][21] or any of the forums listed in the community section of
[PowerShell][10] hub page. We offer no guarantee there that the community will address or resolve
your issue in a timely manner. If you have a problem that requires immediate attention, you should
use the traditional, paid support options.
There are also [community support][04] options. You can file an issue, bug, or feature request on
GitHub. Also, you can get help from other members of the community in the Microsoft
[PowerShell Tech Community][12] or any of the community forums listed on the [PowerShell][04] hub
page. If you have a problem that requires immediate attention, you should use the traditional, paid
support options.

> [!IMPORTANT]
> You must have the latest patch update installed to qualify for support. For example, if you're
Expand All @@ -111,22 +110,20 @@ use the traditional, paid support options.

## PowerShell End-of-support dates

Based on these lifecycle policies, the following table lists the dates when currently supported
version will no longer be supported:
Based on these lifecycle policies, the following table lists the dates when support for the current
versions of PowerShell end:

| Version | Release Date | End-of-support |
| ----------------- | ----------------- | ---------------- |
| 7.4 (preview) | December 20, 2022 | TBD |
| 7.3 (Stable) | November 9, 2022 | May 8, 2024 |
| 7.2 (LTS-current) | November 8, 2021 | November 8, 2024 |

Support for PowerShell on a specific platforms is based on the support policy of the version of .NET
Support for PowerShell on a specific platform is based on the support policy of the version of .NET
used.

- PowerShell 7.3 (Stable) is based on the [.NET 7.0 Supported OS Lifecycle Policy][15]
- PowerShell 7.2 (LTS-current) is based on the [.NET 6.0 Supported OS Lifecycle Policy][14]
- PowerShell 7.1 (Stable) is based on the [.NET 5.0 Supported OS Lifecycle Policy][17]
- PowerShell 7.0 (LTS) is based on the [.NET Core 3.1 Supported OS Lifecycle Policy][16]
- PowerShell 7.3 (Stable) is based on the [.NET 7.0 Supported OS Lifecycle Policy][08]
- PowerShell 7.2 (LTS-current) is based on the [.NET 6.0 Supported OS Lifecycle Policy][07]

End of support dates for already retired versions were:

Expand All @@ -145,12 +142,12 @@ for historical reference. It isn't intended for use to determine the support lif

| Version | Release Date | Note |
| ---------------------------- | :----------: | ------------------------------------------------------------------------------- |
| PowerShell 7.4 (preview) | Dec-2022 | Currently built on .NET 7.0 |
| PowerShell 7.4 (preview) | Dec-2022 | Built on .NET 8.0.0-preview |
| PowerShell 7.3 | Nov-2022 | Built on .NET 7.0 |
| PowerShell 7.2 (LTS-current) | Nov-2021 | Built on .NET 6.0 (LTS-current) |
| PowerShell 7.1 | Nov-2020 | Built on .NET 5.0 |
| PowerShell 7.0 (LTS) | Mar-2020 | Built on .NET Core 3.1 (LTS) |
| PowerShell 6.2 | Mar-2019 | |
| PowerShell 6.2 | Mar-2019 | Built on .NET Core 2.1 |
| PowerShell 6.1 | Sep-2018 | Built on .NET Core 2.1 |
| PowerShell 6.0 | Jan-2018 | First release, built on .NET Core 2.0. Installable on Windows, Linux, and macOS |
| Windows PowerShell 5.1 | Aug-2016 | Released in Windows 10 Anniversary Update and Windows Server 2016, WMF 5.1 |
Expand All @@ -160,21 +157,26 @@ for historical reference. It isn't intended for use to determine the support lif
| Windows PowerShell 2.0 | Jul-2009 | Integrated in Windows 7 and Windows Server 2008 R2, WMF 2.0 |
| Windows PowerShell 1.0 | Nov-2006 | Optional component of Windows Server 2008 |

Run the following command to see the full version number of .NET used by the version of PowerShell
you're running:

```powershell
[System.Runtime.InteropServices.RuntimeInformation]::FrameworkDescription
```

<!-- link references -->
[07]: /lifecycle/faq/windows
[08]: /lifecycle/policies/modern
[09]: /lifecycle/products/
[10]: /powershell/scripting/community/community-support
[11]: /powershell/scripting/learn/experimental-features
[13]: https://dotnet.microsoft.com/platform/support/policy/dotnet-core
[14]: https://github.com/dotnet/core/blob/main/release-notes/6.0/supported-os.md
[15]: https://github.com/dotnet/core/blob/main/release-notes/7.0/supported-os.md
[16]: https://github.com/dotnet/core/blob/master/release-notes/3.1/3.1-supported-os.md
[17]: https://github.com/dotnet/core/blob/master/release-notes/5.0/5.0-supported-os.md
[18]: https://github.com/PowerShell/PowerShell/blob/master/LICENSE.txt
[19]: https://support.microsoft.com/supportforbusiness/productselection
[20]: https://support.serviceshub.microsoft.com/supportforbusiness
[21]: https://techcommunity.microsoft.com/t5/PowerShell/ct-p/WindowsPowerShell
[22]: https://www.microsoft.com/licensing/licensing-programs/enterprise
[23]: https://www.microsoft.com/licensing/licensing-programs/software-assurance-default
[24]: https://www.raspberrypi.org/documentation/installation/installing-images/README.md
[01]: /lifecycle/faq/windows
[02]: /lifecycle/policies/modern
[03]: /lifecycle/products/
[04]: /powershell/scripting/community/community-support
[05]: /powershell/scripting/learn/experimental-features
[06]: https://dotnet.microsoft.com/platform/support/policy/dotnet-core
[07]: https://github.com/dotnet/core/blob/main/release-notes/6.0/supported-os.md
[08]: https://github.com/dotnet/core/blob/main/release-notes/7.0/supported-os.md
[09]: https://github.com/PowerShell/PowerShell/blob/master/LICENSE.txt
[10]: https://support.microsoft.com/supportforbusiness/productselection
[11]: https://support.serviceshub.microsoft.com/supportforbusiness
[12]: https://techcommunity.microsoft.com/t5/PowerShell/ct-p/WindowsPowerShell
[13]: https://www.microsoft.com/licensing/licensing-programs/enterprise
[14]: https://www.microsoft.com/licensing/licensing-programs/software-assurance-default
[15]: https://www.raspberrypi.org/documentation/installation/installing-images/README.md
Loading
Loading