Skip to content

Commit 2da5bda

Browse files
committed
Update PS7.6-p5 release notes and other docs
1 parent dde700f commit 2da5bda

File tree

13 files changed

+214
-41
lines changed

13 files changed

+214
-41
lines changed

reference/7.4/PSReadLine/About/about_PSReadLine_Functions.md

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ description: >
33
This article documents the functions provided by PSReadLine. These functions
44
can be bound to keystrokes for easy access and invocation.
55
Locale: en-US
6-
ms.date: 03/03/2025
6+
ms.date: 10/01/2025
77
online version: https://learn.microsoft.com/powershell/module/psreadline/about/about_psreadline_functions?view=powershell-7.4&WT.mc_id=ps-gethelp
88
schema: 2.0.0
99
title: about_PSReadLine_Functions
@@ -1179,9 +1179,13 @@ Similarly, you can use this with other operations, like `<Delete>` or
11791179

11801180
### InvokePrompt
11811181

1182-
Erases the current prompt and calls the prompt function to redisplay the
1183-
prompt. Useful for custom key handlers that change state. For example, change
1184-
the current directory.
1182+
Attempt to erase the current prompt and call the prompt function to redisplay
1183+
the prompt. Useful for custom key handlers that change state. For example,
1184+
change the current directory. This method can't overwrite a prompt that has
1185+
left the screen buffer.
1186+
1187+
Calls to InvokePrompt with no Y position argument immediately return if the
1188+
prompt can't be overwritten. This change was made in PSReadLine v2.4.3-beta3.
11851189

11861190
- Function is unbound.
11871191

reference/7.5/PSReadLine/About/about_PSReadLine_Functions.md

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ description: >
33
This article documents the functions provided by PSReadLine. These functions
44
can be bound to keystrokes for easy access and invocation.
55
Locale: en-US
6-
ms.date: 03/03/2025
6+
ms.date: 10/01/2025
77
online version: https://learn.microsoft.com/powershell/module/psreadline/about/about_psreadline_functions?view=powershell-7.5&WT.mc_id=ps-gethelp
88
schema: 2.0.0
99
title: about_PSReadLine_Functions
@@ -1179,9 +1179,13 @@ Similarly, you can use this with other operations, like `<Delete>` or
11791179

11801180
### InvokePrompt
11811181

1182-
Erases the current prompt and calls the prompt function to redisplay the
1183-
prompt. Useful for custom key handlers that change state. For example, change
1184-
the current directory.
1182+
Attempt to erase the current prompt and call the prompt function to redisplay
1183+
the prompt. Useful for custom key handlers that change state. For example,
1184+
change the current directory. This method can't overwrite a prompt that has
1185+
left the screen buffer.
1186+
1187+
Calls to InvokePrompt with no Y position argument immediately return if the
1188+
prompt can't be overwritten. This change was made in PSReadLine v2.4.3-beta3.
11851189

11861190
- Function is unbound.
11871191

reference/7.6/Microsoft.PowerShell.Core/About/about_Arrays.md

Lines changed: 15 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
description: Describes arrays, which are data structures designed to store collections of items.
33
Locale: en-US
4-
ms.date: 01/03/2025
4+
ms.date: 10/01/2025
55
no-loc: [Count, Length, LongLength, Rank, ForEach, Clear, Default, First, Last, SkipUntil, Until, Split, Tuple]
66
online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_arrays?view=powershell-7.6&WT.mc_id=ps-gethelp
77
schema: 2.0.0
@@ -515,6 +515,13 @@ ForEach(string methodName)
515515
ForEach(string methodName, object[] arguments)
516516
```
517517

518+
PowerShell 7.6-preview.5 added `PSForEach()` as an alias for the `ForEach()`
519+
method and `PSWhere()` as an alias for the `Where()` method. Use these aliases
520+
to avoid conflicts with `ForEach()` and `Where()` that might be defined on the
521+
base class of the object. For example, the `System.Collections.Generic.List<T>`
522+
class defines its own `ForEach()` method. Use `PSForEach()` to avoid calling
523+
the base class method.
524+
518525
#### ForEach(scriptblock expression)
519526

520527
#### ForEach(scriptblock expression, object[] arguments)
@@ -671,6 +678,13 @@ hi
671678
there
672679
```
673680

681+
PowerShell 7.6-preview.5 added `PSForEach()` as an alias for the `ForEach()`
682+
method and `PSWhere()` as an alias for the `Where()` method. Use these aliases
683+
to avoid conflicts with `ForEach()` and `Where()` that might be defined on the
684+
base class of the object. For example, the `System.Collections.Generic.List<T>`
685+
class defines its own `ForEach()` method. Use `PSForEach()` to avoid calling
686+
the base class method.
687+
674688
#### Default
675689

676690
The `Default` mode filters items using the `Expression` scriptblock.

reference/7.6/Microsoft.PowerShell.Core/About/about_Environment_Variables.md

Lines changed: 17 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
description: Describes how to access and manage environment variables in PowerShell.
33
Locale: en-US
4-
ms.date: 08/27/2025
4+
ms.date: 10/01/2025
55
online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_environment_variables?view=powershell-7.6&WT.mc_id=ps-gethelp
66
schema: 2.0.0
77
title: about_Environment_Variables
@@ -20,6 +20,7 @@ programs. PowerShell creates the following environment variables:
2020
- `POWERSHELL_TELEMETRY_OPTOUT`
2121
- `POWERSHELL_DISTRIBUTION_CHANNEL`
2222
- `POWERSHELL_UPDATECHECK`
23+
- `POWERSHELL_DIAGNOSTICS_OPTOUT`
2324
- `PSExecutionPolicyPreference`
2425
- `PSModulePath`
2526
- `PSModuleAnalysisCachePath`
@@ -413,6 +414,21 @@ The environment variables that store preferences include:
413414
PowerShell process. See the previous sections for information about creating
414415
persistent environment variables.
415416

417+
- `POWERSHELL_DIAGNOSTICS_OPTOUT`
418+
419+
This environment variable was added in PowerShell 7.6-preview.5. By default,
420+
PowerShell creates a named pipe that is uses for Interprocess Communication
421+
(IPC), such as `Enter-PSHostProcess`. PowerShell creates the named pipe at
422+
startup so that it's available for use when needed.
423+
424+
On non-Windows platforms, named pipes are implemented as files in the `/tmp`
425+
folder. If PowerShell crashes, these files may not be deleted. Over time,
426+
these files can accumulate.
427+
428+
Beginning in PowerShell 7.6, `POWERSHELL_DIAGNOSTICS_OPTOUT` is set to
429+
`false`. To turn off the creation of the named pipe, set the environment
430+
variable to `true`, `yes`, or `1`.
431+
416432
- `PSExecutionPolicyPreference`
417433

418434
Stores the execution policy set for the current session. This environment

reference/7.6/Microsoft.PowerShell.Core/About/about_Intrinsic_Members.md

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
description: Describes automatic members in all PowerShell objects
33
Locale: en-US
4-
ms.date: 01/03/2025
4+
ms.date: 10/01/2025
55
online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_Intrinsic_Members?view=powershell-7.6&WT.mc_id=ps-gethelp
66
schema: 2.0.0
77
title: about_Intrinsic_Members
@@ -165,6 +165,13 @@ The `ForEach()` and `Where()` methods are available to all PowerShell objects.
165165
However, they're most useful when working with collections. For more
166166
information on how to use these methods, see [about_Arrays][01].
167167

168+
PowerShell 7.6-preview.5 added `PSForEach()` as an alias for the `ForEach()`
169+
method and `PSWhere()` as an alias for the `Where()` method. Use these aliases
170+
to avoid conflicts with `ForEach()` and `Where()` that might be defined on the
171+
base class of the object. For example, the `System.Collections.Generic.List<T>`
172+
class defines its own `ForEach()` method. Use `PSForEach()` to avoid calling
173+
the base class method.
174+
168175
## Properties
169176

170177
Not all scalar type have **Count** or **Length** properties in the base type.

reference/7.6/Microsoft.PowerShell.Core/Register-ArgumentCompleter.md

Lines changed: 33 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -19,15 +19,21 @@ Registers a custom argument completer.
1919
### NativeSet
2020

2121
```
22-
Register-ArgumentCompleter -CommandName <String[]> -ScriptBlock <ScriptBlock> [-Native]
22+
Register-ArgumentCompleter -CommandName <string[]> -ScriptBlock <scriptblock> [-Native]
2323
[<CommonParameters>]
2424
```
2525

2626
### PowerShellSet
2727

2828
```
29-
Register-ArgumentCompleter [-CommandName <String[]>] -ParameterName <String>
30-
-ScriptBlock <ScriptBlock> [<CommonParameters>]
29+
Register-ArgumentCompleter -ParameterName <string> -ScriptBlock <scriptblock>
30+
[-CommandName <string[]>] [<CommonParameters>]
31+
```
32+
33+
### NativeFallbackSet
34+
35+
```
36+
Register-ArgumentCompleter -ScriptBlock <scriptblock> [-NativeFallback] [<CommonParameters>]
3137
```
3238

3339
## DESCRIPTION
@@ -220,6 +226,30 @@ Accept pipeline input: False
220226
Accept wildcard characters: False
221227
```
222228
229+
### -NativeFallback
230+
231+
When you use this parameter, PowerShell registers a cover-all argument completer for native
232+
commands. When a native command doesn't have a specific completer for it, it uses the cover-all
233+
completer. A cover-all completer allows a module like Microsoft.PowerShell.UnixTabCompletion to be
234+
registered to provide tab completion for many native commands on Linux and macOS systems.
235+
236+
> [!NOTE]
237+
> You can only register one cover-all completer.
238+
239+
This parameter was added in PowerShell 7.6-preview.5.
240+
241+
```yaml
242+
Type: System.Management.Automation.SwitchParameter
243+
Parameter Sets: NativeFallbackSet
244+
Aliases:
245+
246+
Required: False
247+
Position: Named
248+
Default value: None
249+
Accept pipeline input: False
250+
Accept wildcard characters: False
251+
```
252+
223253
### -ParameterName
224254
225255
Specifies the name of the parameter the argument completer applies to. The type for specified

reference/7.6/PSDiagnostics/Disable-PSTrace.md

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
external help file: PSDiagnostics-help.xml
33
Locale: en-US
44
Module Name: PSDiagnostics
5-
ms.date: 12/12/2022
5+
ms.date: 10/01/2025
66
online version: https://learn.microsoft.com/powershell/module/psdiagnostics/disable-pstrace?view=powershell-7.6&WT.mc_id=ps-gethelp
77
schema: 2.0.0
88
title: Disable-PSTrace
@@ -11,7 +11,7 @@ title: Disable-PSTrace
1111
# Disable-PSTrace
1212

1313
## SYNOPSIS
14-
Disables the Microsoft-Windows-PowerShell event provider logs.
14+
Disables the PowerShellCore event provider logs.
1515

1616
## SYNTAX
1717

@@ -23,16 +23,20 @@ Disable-PSTrace [-AnalyticOnly] [<CommonParameters>]
2323

2424
> **This cmdlet is only available on the Windows platform.**
2525
26-
This cmdlet disables the Operational and Analytic event logs of the Microsoft-Windows-PowerShell
26+
This cmdlet disables the Operational and Analytic event logs of the PowerShellCore
2727
event provider.
2828

2929
You must run this cmdlet from an elevated PowerShell session.
3030

31+
> [!NOTE]
32+
> Prior to PowerShell 7.6, this command only disabled logging for the Microsoft-Windows-PowerShell
33+
> event provider.
34+
3135
## EXAMPLES
3236

3337
### Example 1: Disable the Analytic event log for PowerShell
3438

35-
The following example disables only the Analytic event log of the Microsoft-Windows-PowerShell
39+
The following example disables only the Analytic event log of the PowerShellCore
3640
provider.
3741

3842
```powershell
@@ -43,8 +47,8 @@ Disable-PSTrace -AnalyticOnly
4347

4448
### -AnalyticOnly
4549

46-
When this parameter is used, the cmdlet disables the Analytic event log of the
47-
Microsoft-Windows-PowerShell provider. The Operational event log is not changed.
50+
When this parameter is used, the cmdlet disables the Analytic event log of the PowerShellCore
51+
provider. The Operational event log is not changed.
4852

4953
```yaml
5054
Type: System.Management.Automation.SwitchParameter

reference/7.6/PSDiagnostics/Enable-PSTrace.md

Lines changed: 9 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
external help file: PSDiagnostics-help.xml
33
Locale: en-US
44
Module Name: PSDiagnostics
5-
ms.date: 12/12/2022
5+
ms.date: 10/01/2025
66
online version: https://learn.microsoft.com/powershell/module/psdiagnostics/enable-pstrace?view=powershell-7.6&WT.mc_id=ps-gethelp
77
schema: 2.0.0
88
title: Enable-PSTrace
@@ -11,7 +11,7 @@ title: Enable-PSTrace
1111
# Enable-PSTrace
1212

1313
## SYNOPSIS
14-
Enables the Microsoft-Windows-PowerShell event provider logs.
14+
Enables the PowerShellCore event provider logs.
1515

1616
## SYNTAX
1717

@@ -23,16 +23,20 @@ Enable-PSTrace [-Force] [-AnalyticOnly] [<CommonParameters>]
2323

2424
> **This cmdlet is only available on the Windows platform.**
2525
26-
This cmdlet enables the Operational and Analytic event logs of the Microsoft-Windows-PowerShell
26+
This cmdlet enables the Operational and Analytic event logs of the PowerShellCore
2727
event provider.
2828

2929
You must run this cmdlet from an elevated PowerShell session.
3030

31+
> [!NOTE]
32+
> Prior to PowerShell 7.6, this command only enabled logging for the Microsoft-Windows-PowerShell
33+
> event provider.
34+
3135
## EXAMPLES
3236

3337
### Example 1: Enable the Analytic event log for PowerShell
3438

35-
The following example enables only the Analytic event log of the Microsoft-Windows-PowerShell
39+
The following example enables only the Analytic event log of the PowerShellCore
3640
provider.
3741

3842
```powershell
@@ -44,7 +48,7 @@ Enable-PSTrace -AnalyticOnly
4448
### -AnalyticOnly
4549

4650
When this parameter is used, the cmdlet enables the Analytic event log of the
47-
Microsoft-Windows-PowerShell provider. The Operational event log is not changed.
51+
PowerShellCore provider. The Operational event log is not changed.
4852

4953
```yaml
5054
Type: System.Management.Automation.SwitchParameter

reference/7.6/PSReadLine/About/about_PSReadLine_Functions.md

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ description: >
33
This article documents the functions provided by PSReadLine. These functions
44
can be bound to keystrokes for easy access and invocation.
55
Locale: en-US
6-
ms.date: 03/03/2025
6+
ms.date: 10/01/2025
77
online version: https://learn.microsoft.com/powershell/module/psreadline/about/about_psreadline_functions?view=powershell-7.6&WT.mc_id=ps-gethelp
88
schema: 2.0.0
99
title: about_PSReadLine_Functions
@@ -1179,9 +1179,13 @@ Similarly, you can use this with other operations, like `<Delete>` or
11791179

11801180
### InvokePrompt
11811181

1182-
Erases the current prompt and calls the prompt function to redisplay the
1183-
prompt. Useful for custom key handlers that change state. For example, change
1184-
the current directory.
1182+
Attempt to erase the current prompt and call the prompt function to redisplay
1183+
the prompt. Useful for custom key handlers that change state. For example,
1184+
change the current directory. This method can't overwrite a prompt that has
1185+
left the screen buffer.
1186+
1187+
Calls to InvokePrompt with no Y position argument immediately return if the
1188+
prompt can't be overwritten. This change was made in PSReadLine v2.4.3-beta3.
11851189

11861190
- Function is unbound.
11871191

reference/docs-conceptual/install/Installing-PowerShell-on-Windows.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
description: Information about installing PowerShell on Windows
3-
ms.date: 10/09/2025
3+
ms.date: 10/01/2025
44
title: Installing PowerShell on Windows
55
---
66
# Installing PowerShell on Windows
@@ -42,7 +42,7 @@ winget search Microsoft.PowerShell
4242
Name Id Version Source
4343
---------------------------------------------------------------
4444
PowerShell Microsoft.PowerShell 7.5.3.0 winget
45-
PowerShell Preview Microsoft.PowerShell.Preview 7.6.0.4 winget
45+
PowerShell Preview Microsoft.PowerShell.Preview 7.6.0.5 winget
4646
```
4747

4848
Install PowerShell or PowerShell Preview using the `id` parameter

0 commit comments

Comments
 (0)