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

7/12/2024 PM Publish #11264

Merged
merged 3 commits into from
Jul 12, 2024
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
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
description: Describes variables that store state information for PowerShell. These variables are created and maintained by PowerShell.
Locale: en-US
ms.date: 07/01/2024
ms.date: 07/12/2024
no-loc: [Reset, Current, Background, Blink, Bold, Foreground, Formatting, Hidden, Italic, Reset, Reverse, Underline, PSEventArgs, PSEventSubscriber, PSEdition]
online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_automatic_variables?view=powershell-5.1&WT.mc_id=ps-gethelp
schema: 2.0.0
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
external help file: Microsoft.PowerShell.Commands.Management.dll-Help.xml
Locale: en-US
Module Name: Microsoft.PowerShell.Management
ms.date: 06/09/2017
ms.date: 07/12/2024
online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.management/checkpoint-computer?view=powershell-5.1&WT.mc_id=ps-gethelp
schema: 2.0.0
title: Checkpoint-Computer
Expand All @@ -22,9 +22,9 @@ Checkpoint-Computer [-Description] <String> [[-RestorePointType] <String>] [<Com

The `Checkpoint-Computer` cmdlet creates a system restore point on the local computer.

System restore points and the `Checkpoint-Computer` cmdlet are supported only on client operating systems, such as Windows 8, Windows 7, Windows Vista, and Windows XP.

Beginning in Windows 8, `Checkpoint-Computer` cannot create more than one checkpoint each day.
System restore points and the `Checkpoint-Computer` cmdlet are supported only on client operating
systems, such as Windows 10 or Windows 11. `Checkpoint-Computer` cannot create more than one
checkpoint each day.

## EXAMPLES

Expand All @@ -34,23 +34,22 @@ Beginning in Windows 8, `Checkpoint-Computer` cannot create more than one checkp
Checkpoint-Computer -Description "Install MyApp"
```

This command creates a system restore point called Install MyApp.
It uses the default APPLICATION_INSTALL restore point type.
This command creates a system restore point called Install MyApp. It uses the default
`APPLICATION_INSTALL` restore point type.

### Example 2: Create a system MODIFY_SETTINGS restore point

```powershell
Checkpoint-Computer -Description "ChangeNetSettings" -RestorePointType MODIFY_SETTINGS
```

This command creates a MODIFY_SETTINGS system restore point called "ChangeNetSettings".
This command creates a `MODIFY_SETTINGS` system restore point called "ChangeNetSettings".

## PARAMETERS

### -Description

Specifies a descriptive name for the restore point.
This parameter is required.
Specifies a descriptive name for the restore point. This parameter is required.

```yaml
Type: System.String
Expand All @@ -66,16 +65,19 @@ Accept wildcard characters: False
### -RestorePointType
Specifies the type of restore point.
The default is APPLICATION_INSTALL.
Specifies the type of restore point. The default is `APPLICATION_INSTALL`.

The acceptable values for this parameter are:

- APPLICATION_INSTALL
- APPLICATION_UNINSTALL
- DEVICE_DRIVER_INSTALL
- MODIFY_SETTINGS
- CANCELLED_OPERATION
- `APPLICATION_INSTALL`
- `APPLICATION_UNINSTALL`
- `DEVICE_DRIVER_INSTALL`
- `MODIFY_SETTINGS`
- `CANCELLED_OPERATION`

The cmdlet accepts `CANCELLED_OPERATION` but this type of restore point operation is no longer
supported. For more information about these types, see the
[Restore Point Description Text](/windows/win32/sr/restore-point-description-text) documentation.

```yaml
Type: System.String
Expand All @@ -92,7 +94,10 @@ Accept wildcard characters: False

### CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](../Microsoft.PowerShell.Core/About/about_CommonParameters.md).
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable,
-InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose,
-WarningAction, and -WarningVariable. For more information, see
[about_CommonParameters](../Microsoft.PowerShell.Core/About/about_CommonParameters.md).

## INPUTS

Expand All @@ -108,11 +113,14 @@ This cmdlet does not generate any output.

## NOTES

- This cmdlet uses the **CreateRestorePoint** method of the **SystemRestore** class with a **BEGIN_SYSTEM_CHANGE** event.
- Beginning in Windows 8, `Checkpoint-Computer` cannot create more than one system restore point each day. If you try to create a new restore point before the 24-hour period has elapsed, Windows PowerShell generates the following error:
- This cmdlet uses the **CreateRestorePoint** method of the **SystemRestore** class with a
**BEGIN_SYSTEM_CHANGE** event.
- Beginning in Windows 8, `Checkpoint-Computer` cannot create more than one system restore point
each day. If you try to create a new restore point before the 24-hour period has elapsed, Windows
PowerShell generates the following error:

`"A new system restore point cannot be created because one has already been created within the past 24 hours.
Please try again later."`
`"A new system restore point cannot be created because one has already been created within the
past 24 hours. Please try again later."`

## RELATED LINKS

Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
description: Describes variables that store state information for PowerShell. These variables are created and maintained by PowerShell.
Locale: en-US
ms.date: 07/01/2024
ms.date: 07/12/2024
no-loc: [Reset, Current, Background, Blink, Bold, Foreground, Formatting, Hidden, Italic, Reset, Reverse, Underline, PSEventArgs, PSEventSubscriber, PSEdition]
online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_automatic_variables?view=powershell-7.2&WT.mc_id=ps-gethelp
schema: 2.0.0
Expand Down Expand Up @@ -281,23 +281,23 @@ echo Hello | pwsh -Command """$input World!"""

### $IsCoreCLR

Contains `$True` if the current session is running on the .NET Core Runtime
(CoreCLR). Otherwise contains `$False`.
Contains `$true` if the current session is running on the .NET Core Runtime
(CoreCLR). Otherwise contains `$false`.

### $IsLinux

Contains `$True` if the current session is running on a Linux operating system.
Otherwise contains `$False`.
Contains `$true` if the current session is running on a Linux operating system.
Otherwise contains `$false`.

### $IsMacOS

Contains `$True` if the current session is running on a MacOS operating system.
Otherwise contains `$False`.
Contains `$true` if the current session is running on a MacOS operating system.
Otherwise contains `$false`.

### $IsWindows

Contains `$TRUE` if the current session is running on a Windows operating
system. Otherwise contains `$FALSE`.
Contains `$true` if the current session is running on a Windows operating
system. Otherwise contains `$false`.

### $LASTEXITCODE

Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
description: Describes variables that store state information for PowerShell. These variables are created and maintained by PowerShell.
Locale: en-US
ms.date: 07/01/2024
ms.date: 07/12/2024
no-loc: [Reset, Current, Background, Blink, Bold, Foreground, Formatting, Hidden, Italic, Reset, Reverse, Underline, PSEventArgs, PSEventSubscriber, PSEdition]
online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_automatic_variables?view=powershell-7.4&WT.mc_id=ps-gethelp
schema: 2.0.0
Expand Down Expand Up @@ -281,23 +281,23 @@ echo Hello | pwsh -Command """$input World!"""

### $IsCoreCLR

Contains `$True` if the current session is running on the .NET Core Runtime
(CoreCLR). Otherwise contains `$False`.
Contains `$true` if the current session is running on the .NET Core Runtime
(CoreCLR). Otherwise contains `$false`.

### $IsLinux

Contains `$True` if the current session is running on a Linux operating system.
Otherwise contains `$False`.
Contains `$true` if the current session is running on a Linux operating system.
Otherwise contains `$false`.

### $IsMacOS

Contains `$True` if the current session is running on a MacOS operating system.
Otherwise contains `$False`.
Contains `$true` if the current session is running on a MacOS operating system.
Otherwise contains `$false`.

### $IsWindows

Contains `$TRUE` if the current session is running on a Windows operating
system. Otherwise contains `$FALSE`.
Contains `$true` if the current session is running on a Windows operating
system. Otherwise contains `$false`.

### $LASTEXITCODE

Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
description: Describes variables that store state information for PowerShell. These variables are created and maintained by PowerShell.
Locale: en-US
ms.date: 07/01/2024
ms.date: 07/12/2024
no-loc: [Reset, Current, Background, Blink, Bold, Foreground, Formatting, Hidden, Italic, Reset, Reverse, Underline, PSEventArgs, PSEventSubscriber, PSEdition]
online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_automatic_variables?view=powershell-7.5&WT.mc_id=ps-gethelp
schema: 2.0.0
Expand Down Expand Up @@ -281,23 +281,23 @@ echo Hello | pwsh -Command """$input World!"""

### $IsCoreCLR

Contains `$True` if the current session is running on the .NET Core Runtime
(CoreCLR). Otherwise contains `$False`.
Contains `$true` if the current session is running on the .NET Core Runtime
(CoreCLR). Otherwise contains `$false`.

### $IsLinux

Contains `$True` if the current session is running on a Linux operating system.
Otherwise contains `$False`.
Contains `$true` if the current session is running on a Linux operating system.
Otherwise contains `$false`.

### $IsMacOS

Contains `$True` if the current session is running on a MacOS operating system.
Otherwise contains `$False`.
Contains `$true` if the current session is running on a MacOS operating system.
Otherwise contains `$false`.

### $IsWindows

Contains `$TRUE` if the current session is running on a Windows operating
system. Otherwise contains `$FALSE`.
Contains `$true` if the current session is running on a Windows operating
system. Otherwise contains `$false`.

### $LASTEXITCODE

Expand Down
4 changes: 2 additions & 2 deletions reference/docs-conceptual/install/install-ubuntu.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
description: Information about installing PowerShell on Ubuntu
ms.date: 06/19/2024
ms.date: 07/12/2024
title: Installing PowerShell on Ubuntu
---
# Installing PowerShell on Ubuntu
Expand Down Expand Up @@ -115,7 +115,7 @@ sudo apt-get install -f
rm powershell_7.4.3-1.deb_amd64.deb

# Start PowerShell Preview
pwsh-lts
pwsh
```

## Uninstall PowerShell
Expand Down
8 changes: 4 additions & 4 deletions reference/includes/alpine-support.md
Original file line number Diff line number Diff line change
@@ -1,17 +1,17 @@
---
author: sdwheeler
ms.author: sewhee
ms.date: 06/04/2024
ms.date: 07/12/2024
ms.topic: include
---
<!-- markdownlint-disable first-line-h1 -->
Microsoft supports PowerShell until [PowerShell reaches end-of-support][lifecycle] or the version of
[Alpine reaches end-of-life][eol-alpine].

Alpine 3.17 - OS support ends on 2024-11-22
Docker images containing PowerShell 7.2, PowerShell 7.4, and PowerShell 7.5-preview for x64 are
available from the [Microsoft Artifact Registry][mcr] for the following versions of Alpine:

- Docker images containing PowerShell 7.2, PowerShell 7.4, and PowerShell 7.5-preview for x64 are
available from the [Microsoft Artifact Registry][mcr]
- Alpine 3.17 - OS support ends on 2024-11-22

Docker images of PowerShell aren't available for Alpine 3.18 and 3.19 at this time.

Expand Down
19 changes: 9 additions & 10 deletions reference/includes/debian-support.md
Original file line number Diff line number Diff line change
@@ -1,25 +1,24 @@
---
author: sdwheeler
ms.author: sewhee
ms.date: 05/16/2024
ms.date: 07/12/2024
ms.topic: include
---
<!-- markdownlint-disable first-line-h1 -->
Microsoft supports PowerShell until [PowerShell reaches end-of-support][lifecycle] or the version of
[Debian reaches end-of-life][eol-debian].

Debian 11 (Bullseye) - OS support ends on 2024-07-31
Docker images containing PowerShell 7.2, PowerShell 7.4, and PowerShell 7.5-preview for x64 are
available from the [Microsoft Artifact Registry][mcr] for the following versions of Debian:

- Docker images containing PowerShell 7.2, PowerShell 7.4, and PowerShell 7.5-preview for x64 are
available from the [Microsoft Artifact Registry][mcr]

Debian 12 (Bookworm) - OS support ends on 2026-06-10

- Docker images containing PowerShell 7.2, PowerShell 7.4, and PowerShell 7.5-preview for x64 are
available from the [Microsoft Artifact Registry][mcr]
- Debian 12 (Bookworm) - OS support ends on 2026-06-10
- Debian 11 (Bullseye) - OS support ends on 2024-07-31

Preview versions of PowerShell are provided for testing and feedback only.

Install package files (`.deb`) are also available from [https://packages.microsoft.com/][pcm].

[lifecycle]: /powershell/scripting/install/powershell-support-lifecycle
[eol-debian]: https://wiki.debian.org/DebianReleases
[mcr]: https://mcr.microsoft.com/en-us/product/powershell/tags
[mcr]: https://mcr.microsoft.com/product/powershell/tags
[pcm]: https://packages.microsoft.com/
19 changes: 9 additions & 10 deletions reference/includes/rhel-support.md
Original file line number Diff line number Diff line change
@@ -1,27 +1,26 @@
---
author: sdwheeler
ms.author: sewhee
ms.date: 05/16/2024
ms.date: 07/12/2024
ms.topic: include
---
<!-- markdownlint-disable first-line-h1 -->
Microsoft supports PowerShell until [PowerShell reaches end-of-support][lifecycle] or the version of
[RHEL reaches end-of-support][eol-rhel].

RHEL 8 - OS support ends on 2029-05-31
Docker images containing PowerShell 7.2, PowerShell 7.4, and PowerShell 7.5-preview for x64 are
available from the [Microsoft Artifact Registry][mcr] for the following versions of RHEL:

- Docker images containing PowerShell 7.2, PowerShell 7.4, and PowerShell 7.5-preview for x64 are
available from the [Microsoft Artifact Registry][mcr]

RHEL 9 - OS support ends on 2032-05-31

- Docker images containing PowerShell 7.2, PowerShell 7.4, and PowerShell 7.5-preview for x64 are
available from the [Microsoft Artifact Registry][mcr]
- RHEL 8 - OS support ends on 2029-05-31
- RHEL 9 - OS support ends on 2032-05-31

PowerShell is tested on Red Hat Universal Base Images (UBI). For more information, see the
[UBI information page][ubi].

Install package files (`.rpm`) are also available from [https://packages.microsoft.com/][pcm].

[lifecycle]: /powershell/scripting/install/powershell-support-lifecycle
[eol-rhel]: https://access.redhat.com/support/policy/updates/errata/
[ubi]: https://developers.redhat.com/products/rhel/ubi
[mcr]: https://mcr.microsoft.com/en-us/product/powershell/tags
[mcr]: https://mcr.microsoft.com/product/powershell/tags
[pcm]: https://packages.microsoft.com/
23 changes: 9 additions & 14 deletions reference/includes/ubuntu-support.md
Original file line number Diff line number Diff line change
@@ -1,27 +1,21 @@
---
author: sdwheeler
ms.author: sewhee
ms.date: 06/04/2024
ms.date: 07/12/2024
ms.topic: include
---
<!-- markdownlint-disable first-line-h1 -->
Microsoft supports PowerShell until [PowerShell reaches end-of-support][lifecycle] or the version of
[Ubuntu reaches end-of-support][eol-ubuntu].

Ubuntu 20.04 (Focal Fossa) - OS support ends on 2025-04-02
Docker images containing PowerShell 7.2, PowerShell 7.4, and PowerShell 7.5-preview for x64 and
Arm32 are available from the [Microsoft Artifact Registry][mcr] for the following versions of
Ubuntu:

- Docker images containing PowerShell 7.2, PowerShell 7.4, and PowerShell 7.5-preview for x64 and
Arm32 are available from the [Microsoft Artifact Registry][mcr]
- Ubuntu 22.04 (Jammy Jellyfish) - OS support ends on 2027-04-01
- Ubuntu 20.04 (Focal Fossa) - OS support ends on 2025-04-02

Ubuntu 22.04 (Jammy Jellyfish) - OS support ends on 2027-04-01

- Docker images containing PowerShell 7.2, PowerShell 7.4, and PowerShell 7.5-preview for x64 and
Arm32 are available from the [Microsoft Artifact Registry][mcr]

Ubuntu 24.04 (Noble Numbat) - OS support ends on 2029-04-25

- Docker images containing PowerShell 7.2, PowerShell 7.4, and PowerShell 7.5-preview for x64 and
Arm32 are available from the [Microsoft Artifact Registry][mcr]
Install package files (`.deb`) are also available from [https://packages.microsoft.com/][pcm].

Ubuntu 23.10 (Mantic Minotaur) is an interim release. Microsoft doesn't support
[interim releases][interim] of Ubuntu. For more information, see
Expand All @@ -31,4 +25,5 @@ Ubuntu 23.10 (Mantic Minotaur) is an interim release. Microsoft doesn't support
[interim]: https://ubuntu.com/about/release-cycle
[lifecycle]: /powershell/scripting/install/powershell-support-lifecycle
[community]: /powershell/scripting/install/community-support
[mcr]: https://mcr.microsoft.com/en-us/product/powershell/tags
[mcr]: https://mcr.microsoft.com/product/powershell/tags
[pcm]: https://packages.microsoft.com/
Loading
Loading