Skip to content
Merged
Changes from 1 commit
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
53 changes: 53 additions & 0 deletions reference/docs-conceptual/PowerShell-Core-Support.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,53 @@
# PowerShell Core Support Lifecycle

PowerShell Core is distinct from Windows PowerShell in that it is a separately shipping set of tools and components, and is therefore not included in the Windows 10 or Windows Server licensing agreements.

However, it is also supported under traditional Microsoft support agreements, including [Premier][Premier support] and [Microsoft Enterprise Agreements][Enterprise agreement].
You can also pay for [assisted support][] for PowerShell Core by filing a support request for your problem.

We also offer [community support][] on GitHub where you can file an issue, bug, or feature request,
but we offer no guarantee there that your issue will be addressed or resolved in a timely manner.
If you have a problem that requires immediate attention,
you should use the traditional, paid support options offered above.

[Premier support]: https://www.microsoft.com/en-us/microsoftservices/support.aspx
[Enterprise agreement]: https://www.microsoft.com/en-us/licensing/licensing-programs/enterprise.aspx
[Community support]: https://github.com/powershell/powershell/issues
[assisted support]: https://support.microsoft.com/en-us/assistedsupportproducts

## Lifecycle of PowerShell Core

PowerShell Core is adopting the [Microsoft Modern Lifecycle Policy][], a new support lifecycle intended to keep customers up-to-date with the latest versions.

The 6.x branch of PowerShell Core will be updated approximately once every six months (e.g. 6.0, 6.1, 6.2, etc.)
**After each new minor version release,**
**you must update within six months in order to continue receiving support.**

For example, if PowerShell Core 6.1 is released on July 1st, 2018,
you would be expected to update off of PowerShell Core 6.0 by January 1st, 2019 in order to stay supported.

![PowerShell Core branch lifecycle][]
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Did you intend for the exclamation in front which is used for embedding images?


Eventually, we expect PowerShell Core to fork into something resembling a "long-term servicing" branch where we would require only servicing and security updates to stay in support.

[Microsoft Modern Lifecycle Policy]: https://support.microsoft.com/en-us/help/447912/announcing-microsoft-modern-lifecycle-policy
[PowerShell Core branch lifecycle]: TODO

## Compatibility with Windows PowerShell modules
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Renaming this to "Windows PowerShell Modules Support" makes it more consistent with the theme of this doc


Support for PowerShell Core does not extend to other product modules unless they explicitly support PowerShell Core.
For example, using the `ActiveDirectory` that ships `as part of Windows Server is an unsupporgted scenario.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

typo unsupported

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You have an incomplete open back tick. I think the extra back tick isn't needed at all.


That being said, many modules that do not explicitly support PowerShell Core happen to be compatible in many cases.
By installing the [`WindowsPSModulePath`][] module,
you can append the Windows PowerShell `PSModulePath` to your PowerShell Core `PSModulePath`:

```powershell
# Add `-Scope CurrentUser` if you're installing as non-admin
Install-Module WindowsPSModulePath -Force

# Add this line to your profile if you always want Windows PowerShell PSModulePath
Add-WindowsPSModulePath
```

[`WindowsPSModulePath`]: https://www.powershellgallery.com/packages/WindowsPSModulePath/