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

Update release information for 7.5-p5 #11424

Merged
merged 3 commits into from
Oct 2, 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
5 changes: 3 additions & 2 deletions reference/7.5/Microsoft.PowerShell.Core/About/about_Pwsh.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
description: Explains how to use the `pwsh` command-line interface. Displays the command-line parameters and describes the syntax.
Locale: en-US
ms.date: 09/02/2024
ms.date: 09/24/2024
no-loc: [-File, -f, -Command, -c, -CommandWithArgs, -cwa, -ConfigurationName, -config, -CustomPipeName, -EncodedCommand, -e, -ec, -ExecutionPolicy, -ex, -ep, -InputFormat, -inp, -if, -Interactive, -i, -Login, -l, -MTA, -NoExit, -noe, -NoLogo, -nol, -NonInteractive, -noni, -NoProfile, -nop, -OutputFormat, -o, -of, -SettingsFile, -settings, -SSHServerMode, -sshs, -STA, -Version, -v, -WindowStyle, -w, -WorkingDirectory, -wd, -Help]
online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_pwsh?view=powershell-7.5&WT.mc_id=ps-gethelp
schema: 2.0.0
Expand Down Expand Up @@ -207,7 +207,8 @@ string or script block. For more information, see `$LASTEXITCODE` in

### -CommandWithArgs | -cwa

This is an experimental feature added in 7.4.
This is an experimental feature added in 7.4 and became mainstream in
PowerShell 7.5-preview.5.

Executes a PowerShell command with arguments. Unlike `-Command`, this parameter
populates the `$args` built-in variable that can be used by the command.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,8 +1,9 @@
---
description: Describes the telemetry collected in PowerShell and how to opt-out.
Locale: en-US
ms.date: 04/22/2024
ms.date: 09/24/2024
online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_telemetry?view=powershell-7.5&WT.mc_id=ps-gethelp
ms.custom: 7.5-preview.5
schema: 2.0.0
title: about_Telemetry
---
Expand Down Expand Up @@ -51,6 +52,12 @@ PowerShell sends the following information during the session:
- Value of `$PSNativeCommandUseErrorActionPreference` preference variable,
either `true`, `false` or `unset`
- The count of remote session open operations
- The names of registered subsystems: `Completion` and `general`. If the name
of the subsystem name not one of those, then `anonymous` is submitted as the
name.
- The count of `CommandNotFound` feedback suggestions provided.
- The count of `PowerShellUnsafeAssemblyLoad` usage and whether the load was
successful or not.

PowerShell sends this information periodically during the lifetime of the
session for all host applications.
Expand Down
51 changes: 50 additions & 1 deletion reference/7.5/Microsoft.PowerShell.Management/Convert-Path.md
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: 09/05/2023
ms.date: 09/25/2024
online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.management/convert-path?view=powershell-7.5&WT.mc_id=ps-gethelp
schema: 2.0.0
title: Convert-Path
Expand Down Expand Up @@ -61,8 +61,57 @@ PS C:\> Convert-Path ~
C:\Users\User01
```

### Example 4: Convert paths for hidden items

By default, `Convert-Path` does not return hidden items. This example uses the **Force** parameter
to find hidden items. The `Get-Item` command confirms that the `.git` folder is hidden. Using
`Convert-Path` without the **Force** parameter returns only the visible items. Adding the **Force**
parameter returns all items, including hidden items.

```powershell
PS> Get-Item .git -Force

Directory: D:\Git\PS-Docs\PowerShell-Docs

Mode LastWriteTime Length Name
---- ------------- ------ ----
d--h- 9/25/2024 4:46 PM .git

PS> Convert-Path .git*
D:\Git\PS-Docs\PowerShell-Docs\.github
D:\Git\PS-Docs\PowerShell-Docs\.gitattributes
D:\Git\PS-Docs\PowerShell-Docs\.gitignore

PS> Convert-Path .git* -Force
D:\Git\PS-Docs\PowerShell-Docs\.git
D:\Git\PS-Docs\PowerShell-Docs\.github
D:\Git\PS-Docs\PowerShell-Docs\.gitattributes
D:\Git\PS-Docs\PowerShell-Docs\.gitignore
```

## PARAMETERS

### -Force

Allows the cmdlet to get items that otherwise can't be accessed by the user, such as hidden or
system files. The **Force** parameter doesn't override security restrictions. Implementation varies
among providers. For more information, see
[about_Providers](../Microsoft.PowerShell.Core/About/about_Providers.md).

This parameter was added in PowerShell 7.5-preview.5.

```yaml
Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
```

### -LiteralPath

Specifies, as a string array, the path to be converted. The value of the **LiteralPath** parameter
Expand Down
61 changes: 58 additions & 3 deletions reference/7.5/Microsoft.PowerShell.Management/Resolve-Path.md
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: 12/18/2023
ms.date: 09/25/2024
online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.management/resolve-path?view=powershell-7.5&WT.mc_id=ps-gethelp
schema: 2.0.0
title: Resolve-Path
Expand All @@ -19,14 +19,14 @@ Resolves the wildcard characters in a path, and displays the path contents.

```
Resolve-Path [-Path] <string[]> [-Relative] [-RelativeBasePath <string>]
[-Credential <pscredential>] [<CommonParameters>]
[-Credential <pscredential>] [-Force] [<CommonParameters>]
```

### LiteralPath

```
Resolve-Path -LiteralPath <string[]> [-Relative] [-RelativeBasePath <string>]
[-Credential <pscredential>] [<CommonParameters>]
[-Credential <pscredential>] [-Force] [<CommonParameters>]
```

## DESCRIPTION
Expand Down Expand Up @@ -123,6 +123,40 @@ Resolve-Path -Path $ExecutablePath -RelativeBasePath $env:TEMP -Relative
..\..\..\..\..\Program Files\PowerShell\7\pwsh.exe
```

### Example 8: Resolve paths for hidden items

By default, `Resolve-Path` does not return hidden items. This example uses the **Force** parameter
to resolve hidden items. The `Get-Item` command confirms that the `.git` folder is hidden. Using
`Resolve-Path` without the **Force** parameter returns only the visible items. Adding the **Force**
parameter returns all items, including hidden items.

```powershell
PS> Get-Item .git -Force

Directory: D:\Git\PS-Docs\PowerShell-Docs

Mode LastWriteTime Length Name
---- ------------- ------ ----
d--h- 9/25/2024 4:46 PM .git

PS> Resolve-Path .git*

Path
----
D:\Git\PS-Docs\PowerShell-Docs\.github
D:\Git\PS-Docs\PowerShell-Docs\.gitattributes
D:\Git\PS-Docs\PowerShell-Docs\.gitignore

PS> Resolve-Path .git* -Force

Path
----
D:\Git\PS-Docs\PowerShell-Docs\.git
D:\Git\PS-Docs\PowerShell-Docs\.github
D:\Git\PS-Docs\PowerShell-Docs\.gitattributes
D:\Git\PS-Docs\PowerShell-Docs\.gitignore
```

## PARAMETERS

### -Credential
Expand All @@ -149,6 +183,27 @@ Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
```

### -Force

Allows the cmdlet to get items that otherwise can't be accessed by the user, such as hidden or
system files. The **Force** parameter doesn't override security restrictions. Implementation varies
among providers. For more information, see
[about_Providers](../Microsoft.PowerShell.Core/About/about_Providers.md).

This parameter was added in PowerShell 7.5-preview.5.

```yaml
Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
```

### -LiteralPath

Specifies the path to be resolved. The value of the **LiteralPath** parameter is used exactly as
Expand Down
15 changes: 12 additions & 3 deletions reference/docs-conceptual/learn/experimental-features.md
Original file line number Diff line number Diff line change
Expand Up @@ -84,7 +84,7 @@ Legend

| Name | 7.2 | 7.4 | 7.5 (preview) |
| --------------------------------------------------- | :-----------------: | :-----------------: | :-----------------: |
| [PSCommandNotFoundSuggestion][10] | ![Experimental][02] | ![Experimental][02] | ![Experimental][02] |
| [PSCommandNotFoundSuggestion][10] | ![Experimental][02] | ![Experimental][02] | ![Mainstream][01] |
| [PSDesiredStateConfiguration.InvokeDscResource][14] | ![Experimental][02] | ![Experimental][02] | ![Experimental][02] |
| [PSNativePSPathResolution][21] | ![Experimental][02] | | |
| [PSSubsystemPluginModel][23] | ![Experimental][02] | ![Experimental][02] | ![Experimental][02] |
Expand All @@ -93,8 +93,8 @@ Legend
| [PSLoadAssemblyFromNativeCode][16] | ![Experimental][02] | ![Experimental][02] | ![Experimental][02] |
| [PSNativeCommandErrorActionPreference][19] | | ![Mainstream][01] | |
| [PSFeedbackProvider][15] | | ![Experimental][02] | ![Experimental][02] |
| [PSModuleAutoLoadSkipOfflineFiles][17] | | ![Experimental][02] | ![Experimental][02] |
| [PSCommandWithArgs][11] | | ![Experimental][02] | ![Experimental][02] |
| [PSModuleAutoLoadSkipOfflineFiles][17] | | ![Experimental][02] | ![Mainstream][01] |
| [PSCommandWithArgs][11] | | ![Experimental][02] | ![Mainstream][01] |
| [PSNativeWindowsTildeExpansion][22] | | | ![Experimental][02] |
| [PSRedirectToVariable][24] | | | ![Experimental][02] |
| [PSSerializeJSONLongEnumAsNumber][25] | | | ![Experimental][02] |
Expand All @@ -117,6 +117,9 @@ For more information, see [about_Automatic_Variables][05].

### PSCommandNotFoundSuggestion

> [!NOTE]
> This feature became mainstream in PowerShell 7.5-preview.5.

Recommends potential commands based on fuzzy matching search after a **CommandNotFoundException**.

```powershell
Expand All @@ -134,6 +137,9 @@ gcm, gdr, gcs.

### PSCommandWithArgs

> [!NOTE]
> This feature became mainstream in PowerShell 7.5-preview.5.

This feature enables the `-CommandWithArgs` parameter for `pwsh`. This parameter allows you to
execute a PowerShell command with arguments. Unlike `-Command`, this parameter populates the `$args`
built-in variable that can be used by the command.
Expand Down Expand Up @@ -193,6 +199,9 @@ Exposes an API to allow assembly loading from native code.

### PSModuleAutoLoadSkipOfflineFiles

> [!NOTE]
> This feature became mainstream in PowerShell 7.5-preview.5.

With this feature enabled, if a user's **PSModulePath** contains a folder from a cloud provider,
such as OneDrive, PowerShell no longer triggers the download of all files contained within that
folder. Any file marked as not downloaded are skipped. Users who use cloud providers to sync their
Expand Down
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
---
title: What's New in PowerShell 7.5
description: New features and changes released in PowerShell 7.5
ms.date: 08/28/2024
ms.date: 09/24/2024
---

# What's New in PowerShell 7.5

PowerShell 7.5-preview.4 includes the following features, updates, and breaking changes. PowerShell
7.5 is built on .NET 9.0.0-preview.3.
PowerShell 7.5-preview.5 includes the following features, updates, and breaking changes. PowerShell
7.5 is built on .NET 9.0.100-rc.1.

For a complete list of changes, see the [CHANGELOG][chg] in the GitHub repository.

Expand All @@ -24,9 +24,9 @@ For a complete list of changes, see the [CHANGELOG][chg] in the GitHub repositor

## Updated modules

PowerShell 7.5-preview.4 includes the following updated modules:
PowerShell 7.5-preview.5 includes the following updated modules:

- **Microsoft.PowerShell.PSResourceGet** v1.1.0-preview1
- **Microsoft.PowerShell.PSResourceGet** v1.1.0-preview2
- **PSReadLine** v2.3.5

## Tab completion improvements
Expand Down Expand Up @@ -105,7 +105,12 @@ Many thanks to **@ArmaanMcleod** and others for all their work to improve tab co
- Add **WinGetCommandNotFound** and **CompletionPredictor** modules to track usage ([#21040][21040])
- Add **DateKind** parameter to `ConvertFrom-Json` ([#20925][20925]) (Thanks @jborean93!)
- Add **DirectoryInfo** to the OutputType for New-Item ([#21126][21126]) (Thanks @MartinGC94!)
- Fix 1 serialization of array values ([#21085][21085]) (Thanks @jborean93!)
- Fix `Get-Error` serialization of array values ([#21085][21085]) (Thanks @jborean93!)
- Fix `Test-ModuleManifest` so it can use a UNC path ([#24115][24115])
- Fix `Get-TypeData` to write to the pipeline immediately instead of collecting
data first ([#24236][24236]) (Thanks @MartinGC94)
- Add `-Force` parameter to `Resolve-Path` and `Convert-Path` cmdlets to support wildcard hidden
files [#20981][20981] (Thanks @ArmaanMcleod!)

## Engine improvements

Expand All @@ -127,18 +132,35 @@ Many thanks to **@ArmaanMcleod** and others for all their work to improve tab co
- Fix using assembly to use Path.Combine when constructing assembly paths ([#21169][21169])
- Validate the value for using namespace during semantic checks to prevent declaring invalid
namespaces ([#21162][21162])
- Handle global tool specially when prepending `$PSHome` to PATH ([#24228][24228])

## Experimental features

- Allow redirecting to a variable ([#20381][20381]) - experimental feature
- Add tilde expansion for windows native executables ([#20402][20402]) (Thanks @domsleee!)
For more information, see [PSNativeWindowsTildeExpansion][01]
The following experimental features were converted to mainstream features in
PowerShell 7.5-preview.5:

- [PSCommandNotFoundSuggestion][02]
- [PSCommandWithArgs][03]
- [PSModuleAutoLoadSkipOfflineFiles][04]

The following experimental features are included in PowerShell 7.5-preview.5:

- [PSRedirectToVariable][05] - Allow redirecting to a variable ([#20381][20381])
- [PSNativeWindowsTildeExpansion][01] - Add tilde expansion for windows native executables
([#20402][20402]) (Thanks @domsleee!)
- [PSSerializeJSONLongEnumAsNumber][06] - `ConvertTo-Json` now treats large enums as numbers
([#20999][20999]) (Thanks @jborean93!)

<!-- end of content -->
<!-- reference links -->
[chg]: https://github.com/PowerShell/PowerShell/blob/master/CHANGELOG/preview.md

[01]: ../learn/experimental-features.md#psnativewindowstildeexpansion
[02]: ../learn/experimental-features.md#pscommandnotfoundsuggestion
[03]: ../learn/experimental-features.md#pscommandwithargs
[04]: ../learn/experimental-features.md#psmoduleautoloadskipofflinefiles
[05]: ../learn/experimental-features.md#psredirecttovariable
[06]: ../learn/experimental-features.md#psserializejsonlongenumasnumber

[19896]: https://github.com/PowerShell/PowerShell/pull/19896
[20014]: https://github.com/PowerShell/PowerShell/pull/20014
Expand All @@ -152,6 +174,7 @@ Many thanks to **@ArmaanMcleod** and others for all their work to improve tab co
[20367]: https://github.com/PowerShell/PowerShell/pull/20367
[20369]: https://github.com/PowerShell/PowerShell/pull/20369
[20371]: https://github.com/PowerShell/PowerShell/pull/20371
[20381]: https://github.com/PowerShell/PowerShell/pull/20381
[20402]: https://github.com/PowerShell/PowerShell/pull/20402
[20415]: https://github.com/PowerShell/PowerShell/pull/20415
[20419]: https://github.com/PowerShell/PowerShell/pull/20419
Expand Down Expand Up @@ -179,9 +202,12 @@ Many thanks to **@ArmaanMcleod** and others for all their work to improve tab co
[20913]: https://github.com/PowerShell/PowerShell/pull/20913
[20925]: https://github.com/PowerShell/PowerShell/pull/20925
[20942]: https://github.com/PowerShell/PowerShell/pull/20942
[20981]: https://github.com/PowerShell/PowerShell/pull/20981
[20994]: https://github.com/PowerShell/PowerShell/pull/20994
[20999]: https://github.com/PowerShell/PowerShell/pull/20999
[21000]: https://github.com/PowerShell/PowerShell/pull/21000
[21040]: https://github.com/PowerShell/PowerShell/pull/21040
[21063]: https://github.com/PowerShell/PowerShell/pull/21063
[21085]: https://github.com/PowerShell/PowerShell/pull/21085
[21126]: https://github.com/PowerShell/PowerShell/pull/21126
[21162]: https://github.com/PowerShell/PowerShell/pull/21162
Expand All @@ -190,11 +216,9 @@ Many thanks to **@ArmaanMcleod** and others for all their work to improve tab co
[21184]: https://github.com/PowerShell/PowerShell/pull/21184
[21223]: https://github.com/PowerShell/PowerShell/pull/21223
[21302]: https://github.com/PowerShell/PowerShell/pull/21302
[21326]: https://github.com/PowerShell/PowerShell/pull/21326
[21358]: https://github.com/PowerShell/PowerShell/pull/21358
[21529]: https://github.com/PowerShell/PowerShell/pull/21529
[20381]: https://github.com/PowerShell/PowerShell/pull/20381
[21063]: https://github.com/PowerShell/PowerShell/pull/21063
[21326]: https://github.com/PowerShell/PowerShell/pull/21326
[23817]: https://github.com/PowerShell/PowerShell/pull/23817
[23871]: https://github.com/PowerShell/PowerShell/pull/23871
[23891]: https://github.com/PowerShell/PowerShell/pull/23891
Expand All @@ -205,3 +229,6 @@ Many thanks to **@ArmaanMcleod** and others for all their work to improve tab co
[24065]: https://github.com/PowerShell/PowerShell/pull/24065
[24075]: https://github.com/PowerShell/PowerShell/pull/24075
[24086]: https://github.com/PowerShell/PowerShell/pull/24086
[24115]: https://github.com/PowerShell/PowerShell/pull/24115
[24228]: https://github.com/PowerShell/PowerShell/pull/24228
[24236]: https://github.com/PowerShell/PowerShell/pull/24236