Skip to content

Commit

Permalink
Update freshness (#10212)
Browse files Browse the repository at this point in the history
* Update freshness

* Apply suggestions from code review

Co-authored-by: Mikey Lombardi (He/Him) <michael.t.lombardi@gmail.com>

---------

Co-authored-by: Mikey Lombardi (He/Him) <michael.t.lombardi@gmail.com>
  • Loading branch information
sdwheeler and michaeltlombardi committed Jun 28, 2023
1 parent e4fc7e1 commit 5090bdd
Show file tree
Hide file tree
Showing 6 changed files with 109 additions and 90 deletions.
47 changes: 29 additions & 18 deletions reference/docs-conceptual/community/digital-art.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,39 +2,39 @@
author: sdwheeler
description: Download PowerShell related artwork and posters
ms.author: sewhee
ms.date: 05/05/2022
ms.date: 06/28/2023
title: PowerShell Digital Art
---
# PowerShell Digital Art

*The legends are true! The powerful shell that ensures safe passage to the cloud. But how?*
_The legends are true! The powerful shell that ensures safe passage to the cloud. But how?_

Please enjoy the digital artwork linked below. Demonstrate to your peers that *you have been
entrusted with the Scrolls of Monad!*
Please enjoy the digital artwork linked below. Demonstrate to your peers that _you have been
entrusted with the Scrolls of Monad!_

## PowerShell Infographic
## PowerShell Infographics

- [PowerShell Infographic](https://github.com/MicrosoftDocs/PowerShell-Docs/blob/main/assets/PowerShell_7_Infographic.pdf)
- [PowerShell Infographic][09]

## Comic

- [PowerShell Hero Comic (High resolution)](https://aka.ms/powershellherocomic_highres)
- [PowerShell Hero Comic (Print resolution)](https://aka.ms/powershellherocomic_print)
- [PowerShell Hero Comic (Web resolution)](https://aka.ms/powershellherocomic_web)
- [PowerShell Hero Comic (High resolution)][02]
- [PowerShell Hero Comic (Print resolution)][03]
- [PowerShell Hero Comic (Web resolution)][04]

## Wallpaper

- [PowerShell Hero Comic Wallpaper (4k resolution)](https://aka.ms/powershellherowallpaper)
- [PowerShell Hero Pink Wallpaper (4k resolution)](https://aka.ms/powershellherowallpaper1)
- [PowerShell Hero White Wallpaper (4k resolution)](https://aka.ms/powershellherowallpaper2)
- [PowerShell Hero Comic Wallpaper (4k resolution)][06]
- [PowerShell Hero Pink Wallpaper (4k resolution)][07]
- [PowerShell Hero White Wallpaper (4k resolution)][08]

## Poster

- [PowerShell Hero Poster](https://aka.ms/powershellheroposter)
- [PowerShell Hero Poster][05]

## PowerShell Hero

- [PowerShell Hero Image](https://aka.ms/powershellhero)
- [PowerShell Hero Image][01]

### Microsoft PowerShell Logo and Digital Art Guidelines

Expand All @@ -49,7 +49,18 @@ Any uses outside of these guidelines as determined by Microsoft is strictly proh
the Microsoft PowerShell logo or artwork in products, product packaging, or other business services
for which a formal license is required.

Microsoft reserves the right in its sole discretion to terminate or modify permission to display
the logo or artwork, and may request that third parties modify or delete any use of the logo or
artwork that, in Microsoft's sole judgment, does not comply with these guidelines or might
otherwise impair Microsoft's rights in the logo.
Microsoft reserves the right in its sole discretion to terminate or modify permission to display the
logo or artwork, and may request that third parties modify or delete any use of the logo or artwork
that, in Microsoft's sole judgment, does not comply with these guidelines or might otherwise impair
Microsoft's rights in the logo.

<!-- link references -->
[01]: https://aka.ms/powershellhero
[02]: https://aka.ms/powershellherocomic_highres
[03]: https://aka.ms/powershellherocomic_print
[04]: https://aka.ms/powershellherocomic_web
[05]: https://aka.ms/powershellheroposter
[06]: https://aka.ms/powershellherowallpaper
[07]: https://aka.ms/powershellherowallpaper1
[08]: https://aka.ms/powershellherowallpaper2
[09]: https://github.com/MicrosoftDocs/PowerShell-Docs/blob/main/assets/PowerShell_7_Infographic.pdf
41 changes: 20 additions & 21 deletions reference/docs-conceptual/install/PowerShell-in-Docker.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
description: How to use PowerShell that is preinstalled in a Docker image.
ms.date: 05/31/2022
description: How to use PowerShell that's preinstalled in a Docker image.
ms.date: 06/28/2023
ms.devlang: powershell
ms.topic: conceptual
title: Using PowerShell in Docker
Expand All @@ -13,17 +13,17 @@ started using PowerShell in the Docker container.

## Finding available images

The released images require Docker 17.05 or newer. It is also expected that you are able to run
The released images require Docker 17.05 or newer. It's also expected that you are able to run
Docker without `sudo` or local administrative rights. Please follow Docker's official
[instructions][install] to install `docker` correctly.
[instructions][01] to install `docker` correctly.

The release containers derive from the official distribution image, then install dependencies, and
finally install the PowerShell package.

These containers live at [hub.docker.com/r/microsoft/powershell][docker-release].
These containers live at [hub.docker.com/r/microsoft/powershell][05].

For more information about these Docker images, visit the [PowerShell-Docker][PowerShell-Docker]
repository on GitHub.
For more information about these Docker images, visit the [PowerShell-Docker][02] repository on
GitHub.

## Using PowerShell in a container

Expand All @@ -44,30 +44,29 @@ docker rmi mcr.microsoft.com/powershell

## Legal and Licensing

PowerShell is licensed under the [MIT license][mit].
PowerShell is licensed under the [MIT license][03].

### Windows Docker File and Image Licenses

By requesting and using the Container OS Image for Windows containers, you acknowledge,
understand, and consent to the Supplemental License Terms available on Docker hub:
By requesting and using the Container OS Image for Windows containers, you acknowledge, understand,
and consent to the Supplemental License Terms available on Docker hub:

- [Window Server Core][Window Server Core]
- [Nano Server][Nano Server]
- [Window Server Core][06]
- [Nano Server][04]

### Telemetry

By default, PowerShell collects limited telemetry without personally identifiable information to
help aid development of future versions of PowerShell. To opt-out of sending telemetry, create an
environment variable called `POWERSHELL_TELEMETRY_OPTOUT` set to a value of `1` before starting
PowerShell from the installed location. The telemetry we collect falls under the
[Microsoft Privacy Statement][privacy].
[Microsoft Privacy Statement][07].

<!-- link references -->
[install]: https://docs.docker.com/engine/installation/
[docker-release]: https://hub.docker.com/r/microsoft/powershell/
[appinsights]: https://azure.microsoft.com/services/application-insights/
[mit]: https://github.com/PowerShell/PowerShell/tree/master/LICENSE.txt
[PowerShell-Docker]: https://github.com/PowerShell/PowerShell-Docker
[Window Server Core]: https://hub.docker.com/r/microsoft/windowsservercore/
[Nano Server]: https://hub.docker.com/r/microsoft/nanoserver/
[privacy]: https://privacy.microsoft.com/privacystatement/
[01]: https://docs.docker.com/engine/installation/
[02]: https://github.com/PowerShell/PowerShell-Docker
[03]: https://github.com/PowerShell/PowerShell/tree/master/LICENSE.txt
[04]: https://hub.docker.com/r/microsoft/nanoserver/
[05]: https://hub.docker.com/r/microsoft/powershell/
[06]: https://hub.docker.com/r/microsoft/windowsservercore/
[07]: https://privacy.microsoft.com/privacystatement/
51 changes: 27 additions & 24 deletions reference/docs-conceptual/install/community-support.md
Original file line number Diff line number Diff line change
@@ -1,51 +1,50 @@
---
description: PowerShell may run on Linux distributions that are not officially supported by Microsoft.
ms.date: 06/29/2022
description: PowerShell may run on Linux distributions that aren't officially supported by Microsoft.
ms.date: 06/28/2023
title: Community support for PowerShell on Linux
---
# Community support for PowerShell on Linux

There are many distributions of Linux that are not officially supported by Microsoft. In some cases,
There are many distributions of Linux that aren't officially supported by Microsoft. In some cases,
PowerShell may be supported by the community for these releases.

To be supported by Microsoft, the Linux distribution must meet the following criteria:

- The version and architecture of the distribution is supported by .NET Core.
- The version of the distribution is supported for at least one year.
- The version of the distribution is not an interim release or equivalent.
- The version of the distribution isn't an interim release or equivalent.
- The PowerShell team has tested the version of the distribution.

For more information, see the [PowerShell Support Lifecycle](powershell-support-lifecycle.md)
For more information, see the [PowerShell Support Lifecycle][10]
documentation.

The following distributions are supported by the community. Each distribution has its own community
support mechanisms. Consult the distribution's website to find their community resources. You may
also get help from these [PowerShell Community][pscommunity] resources.
also get help from these [PowerShell Community][01] resources.

## Ubuntu interim releases

The documented steps to install PowerShell on [Ubuntu](install-ubuntu.md) may work on Ubuntu interim
releases. However, PowerShell is only supported on the LTS releases of Ubuntu. Microsoft does not
support [interim releases][interim] of Ubuntu.
The documented steps to install PowerShell on [Ubuntu][08] may work on Ubuntu interim releases.
However, PowerShell is only supported on the LTS releases of Ubuntu. Microsoft doesn't support
[interim releases][05] of Ubuntu.

## Arch Linux

> [!NOTE]
> Arch support is not officially supported by Microsoft and is maintained by the community.
> Arch support isn't officially supported by Microsoft and is maintained by the community.
PowerShell is available from the [Arch Linux][arch] User Repository (AUR).
PowerShell is available from the [Arch Linux][07] User Repository (AUR).

- It can be compiled with the [latest tagged release][arch-release]
- It can be compiled from the [latest commit to master][arch-git]
- It can be installed using the [latest release binary][arch-bin]
- It can be compiled with the [latest tagged release][04]
- It can be compiled from the [latest commit to master][03]
- It can be installed using the [latest release binary][02]

Packages in the AUR are maintained by the community. For more information on installing packages
from the AUR, see the [Arch Linux wiki][arch-wiki] or
[Using PowerShell in Docker](powershell-in-docker.md).
from the AUR, see the [Arch Linux wiki][06] or [Using PowerShell in Docker][09].

## Kali

Kali support is not officially supported by Microsoft and is maintained by the community.
Kali support isn't officially supported by Microsoft and is maintained by the community.

### Installation - Kali

Expand All @@ -64,10 +63,14 @@ pwsh
apt -y remove powershell
```

[arch]: https://www.archlinux.org/download/
[arch-release]: https://aur.archlinux.org/packages/powershell/
[arch-git]: https://aur.archlinux.org/packages/powershell-git/
[arch-bin]: https://aur.archlinux.org/packages/powershell-bin/
[arch-wiki]: https://wiki.archlinux.org/title/Arch_User_Repository#Installing_and_upgrading_packages
[pscommunity]:../community/community-support.md
[interim]: https://ubuntu.com/about/release-cycle
<!-- link references -->
[01]: ../community/community-support.md
[02]: https://aur.archlinux.org/packages/powershell-bin/
[03]: https://aur.archlinux.org/packages/powershell-git/
[04]: https://aur.archlinux.org/packages/powershell/
[05]: https://ubuntu.com/about/release-cycle
[06]: https://wiki.archlinux.org/title/Arch_User_Repository#Installing_and_upgrading_packages
[07]: https://www.archlinux.org/download/
[08]: install-ubuntu.md
[09]: powershell-in-docker.md
[10]: powershell-support-lifecycle.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
description: This article is explains the support policy for WSMan-based remoting on non-Windows platforms.
ms.date: 06/22/2022
ms.date: 06/28/2023
title: WSMan remoting is not supported on non-Windows platforms
---
# WSMan remoting is not supported on non-Windows platforms
Expand All @@ -9,18 +9,21 @@ Since the release of PowerShell 6, support for remoting over WS-Management (WSMa
platforms has only been available to a limited set of Linux distributions. All versions of those
distributions that supported WSMan are no longer supported by the Linux vendors that created them.

On non-Windows, WSMan relied on the
[Open Management Infrastructure (OMI)](https://github.com/Microsoft/omi) project, which no longer
supports PowerShell remoting. The OMI WSMan client is dependent on **OpenSSL 1.0**. Most Linux
distributions have moved to **OpenSSL 2.0**, which is not backward-compatible. At this time, there
is no supported distribution that has the dependencies needed for the OMI WSMan client to work.
On non-Windows, WSMan relied on the [Open Management Infrastructure (OMI)][01] project, which no
longer supports PowerShell remoting. The OMI WSMan client is dependent on **OpenSSL 1.0**. Most
Linux distributions have moved to **OpenSSL 2.0**, which is not backward-compatible. At this time,
there is no supported distribution that has the dependencies needed for the OMI WSMan client to
work.

Our plan for PowerShell 7.3 is to remove outdated libraries and supporting code for non-Windows
platforms. WSMan-based remoting is still supported between Windows systems. Remoting over SSH is
supported for all platforms. For more information, see
[PowerShell remoting over SSH](SSH-Remoting-in-PowerShell-Core.md).
supported for all platforms. For more information, see [PowerShell remoting over SSH][03].

> [!NOTE]
> Users may be able to get WSMan remoting to work using the
> [PSWSMan](https://www.powershellgallery.com/packages/PSWSMan) module. This module is not supported
> or maintained by Microsoft.
> Users may be able to get WSMan remoting to work using the [PSWSMan][02] module. This module is not
> supported or maintained by Microsoft.
<!-- link references -->
[01]: https://github.com/Microsoft/omi
[02]: https://www.powershellgallery.com/packages/PSWSMan
[03]: SSH-Remoting-in-PowerShell-Core.md
4 changes: 2 additions & 2 deletions reference/docs-conceptual/overview.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
description: This article is an introduction to the PowerShell scripting environment and its features.
ms.date: 05/17/2022
ms.date: 06/28/2023
title: What is PowerShell?
---

Expand All @@ -23,7 +23,7 @@ includes the following features:

## Scripting language

As a scripting language, PowerShell is commonly used for automating the management of systems. It is
As a scripting language, PowerShell is commonly used for automating the management of systems. It's
also used to build, test, and deploy solutions, often in CI/CD environments. PowerShell is built on
the .NET Common Language Runtime (CLR). All inputs and outputs are .NET objects. No need to parse
text output to extract information from output. The PowerShell scripting language includes the
Expand Down
31 changes: 17 additions & 14 deletions reference/docs-conceptual/whats-new/module-compatibility.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
description: This article lists the compatibility status of modules published for other Microsoft products with PowerShell 7.
ms.date: 04/12/2022
ms.date: 06/28/2023
title: PowerShell 7 module compatibility
---
# PowerShell 7 module compatibility
Expand All @@ -18,17 +18,15 @@ The Az PowerShell module is a set of cmdlets for managing Azure resources direct
PowerShell 7.0.6 LTS or higher is the recommended version of PowerShell for use with the Azure Az
PowerShell module on all platforms.

For more information, see
[Introducing the Azure Az PowerShell module](/powershell/azure/new-azureps-module-az).
For more information, see [Introducing the Azure Az PowerShell module][02].

## MSGraph PowerShell SDK

The Microsoft Graph SDKs are designed to simplify building high-quality, efficient, and resilient
applications that access Microsoft Graph. PowerShell 7 and later is the recommended PowerShell
version for use with the Microsoft Graph PowerShell SDK.

For more information, see
[Install the Microsoft Graph PowerShell SDK](/graph/powershell/installation#supported-powershell-versions).
For more information, see [Install the Microsoft Graph PowerShell SDK][01].

## Windows management modules

Expand All @@ -40,8 +38,7 @@ These modules are installed in different ways depending on the Edition of Window
module is packaged for that Edition.

For more information about installation and compatibility, see
[PowerShell 7 module compatibility](/powershell/windows/module-compatibility) in the Windows
documentation.
[PowerShell 7 module compatibility][05] in the Windows documentation.

## Exchange Online Management 2.0

Expand All @@ -51,8 +48,7 @@ standalone Exchange Online Protection (EOP) PowerShell.

EXO v2.0.4 or later is supported in PowerShell 7.0.3 or later.

For more information, see
[About the Exchange Online PowerShell V2 module](/powershell/exchange/exchange-online-powershell-v2).
For more information, see [About the Exchange Online PowerShell V2 module][03].

## PowerShell modules for SQL Server

Expand All @@ -65,11 +61,18 @@ There are two SQL Server PowerShell modules:

The SqlServer modules require PowerShell version 5.0 or greater.

For more information, see
[Install the SQL Server PowerShell module](/sql/powershell/download-sql-server-ps-module).
For more information, see [Install the SQL Server PowerShell module][06].

## Finding the status of other modules

You can find a complete list of modules using the [PowerShell Module Browser](/powershell/module).
Using the Module Browser, you can find documentation for other PowerShell modules to determine their
PowerShell version requirements.
You can find a complete list of modules using the [PowerShell Module Browser][04]. Using the Module
Browser, you can find documentation for other PowerShell modules to determine their PowerShell
version requirements.

<!-- link references -->
[01]: /graph/powershell/installation#supported-powershell-versions
[02]: /powershell/azure/new-azureps-module-az
[03]: /powershell/exchange/exchange-online-powershell-v2
[04]: /powershell/module
[05]: /powershell/windows/module-compatibility
[06]: /sql/powershell/download-sql-server-ps-module

0 comments on commit 5090bdd

Please sign in to comment.