diff --git a/.github/ISSUE_TEMPLATE/01-article.yml b/.github/ISSUE_TEMPLATE/01-article.yml index 8d2fdf659937..e95405d2b6b1 100644 --- a/.github/ISSUE_TEMPLATE/01-article.yml +++ b/.github/ISSUE_TEMPLATE/01-article.yml @@ -35,6 +35,7 @@ body: - "5.1" - "7.4" - "7.5" + - "7.6" - type: textarea id: summary validations: diff --git a/README.md b/README.md index 4773a72a1a0d..51dc23f139e2 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,5 @@ --- -ms.date: 01/03/2025 +ms.date: 01/17/2025 --- # PowerShell Documentation @@ -30,6 +30,7 @@ The following list describes the main folders in this repository. - `5.1` - contains the cmdlet reference and about topics for PowerShell 5.1 - `7.4` - contains the cmdlet reference and about topics for PowerShell 7.4 - `7.5` - contains the cmdlet reference and about topics for PowerShell 7.5 + - `7.6` - contains the cmdlet reference and about topics for PowerShell 7.6 - `bread` - contains the TOC used for breadcrumb navigation - `docs-conceptual` - contains the conceptual articles that are published to the Docs site. In general, the folder structure mirrors the Table of Contents (TOC). diff --git a/reference/5.1/Microsoft.PowerShell.Utility/Invoke-RestMethod.md b/reference/5.1/Microsoft.PowerShell.Utility/Invoke-RestMethod.md index 70766aad3376..581920411115 100644 --- a/reference/5.1/Microsoft.PowerShell.Utility/Invoke-RestMethod.md +++ b/reference/5.1/Microsoft.PowerShell.Utility/Invoke-RestMethod.md @@ -635,7 +635,7 @@ WindowsPowerShell/3.0" with slight variations for each operating system and plat To test a website with the standard user agent string that is used by most Internet browsers, use the properties of the [PSUserAgent](/dotnet/api/microsoft.powershell.commands) class, such as -Chrome, FireFox, Internet Explorer, Opera, and Safari. +Chrome, Firefox, Internet Explorer, Opera, and Safari. ```yaml Type: System.String diff --git a/reference/5.1/Microsoft.PowerShell.Utility/Invoke-WebRequest.md b/reference/5.1/Microsoft.PowerShell.Utility/Invoke-WebRequest.md index 4a8ffe7689df..6cf00ffefdf5 100644 --- a/reference/5.1/Microsoft.PowerShell.Utility/Invoke-WebRequest.md +++ b/reference/5.1/Microsoft.PowerShell.Utility/Invoke-WebRequest.md @@ -671,7 +671,7 @@ each operating system and platform. To test a website with the standard user agent string that is used by most Internet browsers, use the properties of the [PSUserAgent](/dotnet/api/microsoft.powershell.commands.psuseragent) class, -such as Chrome, FireFox, InternetExplorer, Opera, and Safari. For example, the following command +such as Chrome, Firefox, InternetExplorer, Opera, and Safari. For example, the following command uses the user agent string for Internet Explorer: `Invoke-WebRequest -Uri https://website.com/ -UserAgent ([Microsoft.PowerShell.Commands.PSUserAgent]::InternetExplorer)` diff --git a/reference/7.4/Microsoft.PowerShell.Utility/Invoke-RestMethod.md b/reference/7.4/Microsoft.PowerShell.Utility/Invoke-RestMethod.md index 9d02a52d2771..11042b730684 100644 --- a/reference/7.4/Microsoft.PowerShell.Utility/Invoke-RestMethod.md +++ b/reference/7.4/Microsoft.PowerShell.Utility/Invoke-RestMethod.md @@ -1419,7 +1419,7 @@ variations for each operating system and platform. To test a website with the standard user agent string that is used by most internet browsers, use the properties of the [PSUserAgent](/dotnet/api/microsoft.powershell.commands.psuseragent) class, -such as Chrome, FireFox, InternetExplorer, Opera, and Safari. +such as Chrome, Firefox, InternetExplorer, Opera, and Safari. ```yaml Type: System.String diff --git a/reference/7.4/Microsoft.PowerShell.Utility/Invoke-WebRequest.md b/reference/7.4/Microsoft.PowerShell.Utility/Invoke-WebRequest.md index d378fd6bf0d8..9328fc28da75 100644 --- a/reference/7.4/Microsoft.PowerShell.Utility/Invoke-WebRequest.md +++ b/reference/7.4/Microsoft.PowerShell.Utility/Invoke-WebRequest.md @@ -1396,7 +1396,7 @@ variations for each operating system and platform. To test a website with the standard user agent string that's used by most internet browsers, use the properties of the [PSUserAgent](/dotnet/api/microsoft.powershell.commands.psuseragent) class, such -as Chrome, FireFox, InternetExplorer, Opera, and Safari. +as Chrome, Firefox, InternetExplorer, Opera, and Safari. For example, the following command uses the user agent string for Internet Explorer: `Invoke-WebRequest -Uri https://website.com/ -UserAgent ([Microsoft.PowerShell.Commands.PSUserAgent]::InternetExplorer)` diff --git a/reference/7.5/CimCmdlets/Get-CimAssociatedInstance.md b/reference/7.5/CimCmdlets/Get-CimAssociatedInstance.md index 7fa1de22df1b..f75cd57229e5 100644 --- a/reference/7.5/CimCmdlets/Get-CimAssociatedInstance.md +++ b/reference/7.5/CimCmdlets/Get-CimAssociatedInstance.md @@ -332,6 +332,6 @@ This cmdlet is only available on Windows platforms. ## RELATED LINKS -[Get-CimClass](get-cimclass.md) +[Get-CimClass](Get-CimClass.md) -[Get-CimInstance](get-ciminstance.md) +[Get-CimInstance](Get-CimInstance.md) diff --git a/reference/7.5/CimCmdlets/Get-CimInstance.md b/reference/7.5/CimCmdlets/Get-CimInstance.md index 20c5238922be..7387fa02bf6f 100644 --- a/reference/7.5/CimCmdlets/Get-CimInstance.md +++ b/reference/7.5/CimCmdlets/Get-CimInstance.md @@ -144,7 +144,7 @@ the key property `@{ "Handle"=0 }` and stores it in a variable named `$x`. The v a CIM instance to the `Get-CimInstance` cmdlet to get a particular instance. ```powershell -$x = New-CimInstance -ClassName Win32_Process -Namespace root\cimv2 -Property @{ "Handle"=0 } -Key Handle -ClientOnly +$x = New-CimInstance -ClassName Win32_Process -Namespace root\cimv2 -Property @{"Handle"=0} -Key Handle -ClientOnly Get-CimInstance -CimInstance $x ``` @@ -156,7 +156,7 @@ the variables `$x` and `$y`. The variable `$x` is then formatted in a table cont ```powershell $x,$y = Get-CimInstance -ClassName Win32_Process -$x | Format-Table -Property Name,KernelModeTime -AutoSize +$x | Format-Table -Property Name, KernelModeTime -AutoSize ``` ```Output @@ -171,7 +171,7 @@ This example retrieves the CIM instances of a class named **Win32_ComputerSystem computers named **Server01** and **Server02**. ```powershell -Get-CimInstance -ClassName Win32_ComputerSystem -ComputerName Server01,Server02 +Get-CimInstance -ClassName Win32_ComputerSystem -ComputerName Server01, Server02 ``` ### Example 8: Getting only the key properties, instead of all properties @@ -190,8 +190,8 @@ This example retrieves only a subset of properties, which reduces the size of th traffic. ```powershell -Get-CimInstance -Class Win32_Process -Property Name,KernelModeTime -$x = Get-CimInstance -Class Win32_Process -Property Name,KernelModeTime +Get-CimInstance -Class Win32_Process -Property Name, KernelModeTime +$x = Get-CimInstance -Class Win32_Process -Property Name, KernelModeTime $x | Invoke-CimMethod -MethodName GetOwner ``` @@ -206,7 +206,7 @@ the variable are then passed to `Get-CimInstance` by using the **CimSession** pa CIM instances of the class named **Win32_ComputerSystem**. ```powershell -$s = New-CimSession -ComputerName Server01,Server02 +$s = New-CimSession -ComputerName Server01, Server02 Get-CimInstance -ClassName Win32_ComputerSystem -CimSession $s ``` @@ -216,7 +216,8 @@ Get-CimInstance -ClassName Win32_ComputerSystem -CimSession $s Specifies the CIM session to use for this cmdlet. Enter a variable that contains the CIM session or a command that creates or gets the CIM session, such as the `New-CimSession` or `Get-CimSession` -cmdlets. For more information, see [about_CimSession](../Microsoft.PowerShell.Core/About/about_CimSession.md). +cmdlets. For more information, see +[about_CimSession](../Microsoft.PowerShell.Core/About/about_CimSession.md). ```yaml Type: Microsoft.Management.Infrastructure.CimSession[] @@ -322,8 +323,8 @@ Accept wildcard characters: False Indicates that only objects with key properties populated are returned. Specifying the **KeyOnly** parameter reduces the amount of data transferred over the network. -Use the **KeyOnly** parameter to return only a small portion of the object, which can be used for other -operations, such as the `Set-CimInstance` or `Get-CimAssociatedInstance` cmdlets. +Use the **KeyOnly** parameter to return only a small portion of the object, which can be used for +other operations, such as the `Set-CimInstance` or `Get-CimAssociatedInstance` cmdlets. ```yaml Type: System.Management.Automation.SwitchParameter @@ -497,7 +498,8 @@ Accept wildcard characters: False This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, --WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). +-WarningAction, and -WarningVariable. For more information, see +[about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). ## INPUTS @@ -523,18 +525,18 @@ This cmdlet is only available on Windows platforms. ## RELATED LINKS -[Format-Table](../microsoft.powershell.utility/format-table.md) +[Format-Table](../Microsoft.Powershell.Utility/Format-Table.md) [Get-CimAssociatedInstance](Get-CimAssociatedInstance.md) [Get-CimClass](Get-CimClass.md) -[Invoke-CimMethod](invoke-cimmethod.md) +[Invoke-CimMethod](Invoke-CimMethod.md) [New-CimInstance](New-CimInstance.md) [Register-CimIndicationEvent](Register-CimIndicationEvent.md) -[Remove-CimInstance](remove-ciminstance.md) +[Remove-CimInstance](Remove-CimInstance.md) [Set-CimInstance](Set-CimInstance.md) diff --git a/reference/7.5/CimCmdlets/Get-CimSession.md b/reference/7.5/CimCmdlets/Get-CimSession.md index 0b8298b008a0..4c81ea011d87 100644 --- a/reference/7.5/CimCmdlets/Get-CimSession.md +++ b/reference/7.5/CimCmdlets/Get-CimSession.md @@ -48,7 +48,8 @@ can use the parameters of `Get-CimSession` to get the sessions that are for part you can identify sessions by their names or other identifiers. `Get-CimSession` does not get CIM sessions that were created in other PowerShell sessions or that were created on other computers. -For more information about CIM sessions, see [about_CimSession](../Microsoft.PowerShell.Core/About/about_CimSession.md). +For more information about CIM sessions, see +[about_CimSession](../Microsoft.PowerShell.Core/About/about_CimSession.md). ## EXAMPLES @@ -58,7 +59,7 @@ This example creates CIM sessions using [New-CimSession](New-CimSession.md), and sessions using `Get-CimSession`. ```powershell -New-CimSession -ComputerName Server01,Server02 +New-CimSession -ComputerName Server01, Server02 Get-CimSession ``` @@ -98,7 +99,7 @@ This example gets all CIM sessions in the current PowerShell session and display only the **ComputerName** and **InstanceID** properties. ```powershell -Get-CimSession | Format-Table -Property ComputerName,InstanceId +Get-CimSession | Format-Table -Property ComputerName, InstanceId ``` ```Output @@ -171,7 +172,8 @@ Specifies the identifier of the CIM session to get. For multiple IDs, use commas or use the range operator (`..`) to specify a range of IDs. An **Id** is an integer that uniquely identifies the CIM session within the current PowerShell session. -For more information about the range operator, see [about_Operators](../Microsoft.PowerShell.Core/About/about_Operators.md). +For more information about the range operator, see +[about_Operators](../Microsoft.PowerShell.Core/About/about_Operators.md). ```yaml Type: System.UInt32[] @@ -254,10 +256,10 @@ This cmdlet is only available on Windows platforms. ## RELATED LINKS -[Format-Table](../microsoft.powershell.utility/format-table.md) +[Format-Table](../Microsoft.Powershell.Utility/Format-Table.md) [New-CimSession](New-CimSession.md) -[Remove-CimSession](remove-cimsession.md) +[Remove-CimSession](Remove-CimSession.md) [about_CimSession](../Microsoft.PowerShell.Core/About/about_CimSession.md) diff --git a/reference/7.5/CimCmdlets/Invoke-CimMethod.md b/reference/7.5/CimCmdlets/Invoke-CimMethod.md index 018997a1425d..4d711ae23cf2 100644 --- a/reference/7.5/CimCmdlets/Invoke-CimMethod.md +++ b/reference/7.5/CimCmdlets/Invoke-CimMethod.md @@ -155,7 +155,7 @@ to `Invoke-CimMethod`. ```powershell $c = Get-CimClass -ClassName Win32_Process -Invoke-CimMethod -CimClass $c -MethodName "xyz" -Arguments @{ CommandLine = 'notepad.exe' } +Invoke-CimMethod -CimClass $c -MethodName "xyz" -Arguments @{CommandLine='notepad.exe'} ``` ## PARAMETERS @@ -476,9 +476,9 @@ This cmdlet is only available on Windows platforms. ## RELATED LINKS -[Get-CimClass](get-cimclass.md) +[Get-CimClass](Get-CimClass.md) -[Get-CimInstance](get-ciminstance.md) +[Get-CimInstance](Get-CimInstance.md) [Get-CimSession](Get-CimSession.md) diff --git a/reference/7.5/CimCmdlets/New-CimInstance.md b/reference/7.5/CimCmdlets/New-CimInstance.md index 5048d821aa33..0a7f7c537585 100644 --- a/reference/7.5/CimCmdlets/New-CimInstance.md +++ b/reference/7.5/CimCmdlets/New-CimInstance.md @@ -277,10 +277,10 @@ Accept wildcard characters: False Specifies the amount of time that the cmdlet waits for a response from the CIM server. By default, the value of this parameter is 0, which means that the cmdlet uses the default timeout value for the -server. If the **OperationTimeoutSec** parameter is set to a value less than the robust connection retry -timeout of 3 minutes, network failures that last more than the value of the **OperationTimeoutSec** -parameter are not recoverable, because the operation on the server times out before the client can -reconnect. +server. If the **OperationTimeoutSec** parameter is set to a value less than the robust connection +retry timeout of 3 minutes, network failures that last more than the value of the +**OperationTimeoutSec** parameter are not recoverable, because the operation on the server times +out before the client can reconnect. ```yaml Type: System.UInt32 @@ -412,10 +412,10 @@ This cmdlet is only available on Windows platforms. ## RELATED LINKS -[Get-CimClass](get-cimclass.md) +[Get-CimClass](Get-CimClass.md) -[Get-CimInstance](get-ciminstance.md) +[Get-CimInstance](Get-CimInstance.md) -[Remove-CimInstance](remove-ciminstance.md) +[Remove-CimInstance](Remove-CimInstance.md) [Set-CimInstance](Set-CimInstance.md) diff --git a/reference/7.5/CimCmdlets/New-CimSession.md b/reference/7.5/CimCmdlets/New-CimSession.md index c007add1b4cb..273d6806489d 100644 --- a/reference/7.5/CimCmdlets/New-CimSession.md +++ b/reference/7.5/CimCmdlets/New-CimSession.md @@ -10,7 +10,6 @@ title: New-CimSession # New-CimSession ## SYNOPSIS - Creates a CIM session. ## SYNTAX @@ -68,7 +67,7 @@ This example creates a CIM session to each of the computers specified by **Compu comma separated list. ```powershell -New-CimSession -ComputerName Server01,Server02,Server03 +New-CimSession -ComputerName Server01, Server02, Server03 ``` ### Example 4: Create a CIM session with a friendly name @@ -130,9 +129,9 @@ parameter are: - NtlmDomain - CredSsp -You cannot use the **NtlmDomain** authentication type for connection to the local computer. **CredSSP** -authentication is available only in Windows Vista, Windows Server 2008, and later versions of -Windows. +You cannot use the **NtlmDomain** authentication type for connection to the local computer. +**CredSSP** authentication is available only in Windows Vista, Windows Server 2008, and later +versions of Windows. > [!CAUTION] > Credential Security Service Provider (CredSSP) authentication is designed for commands that @@ -166,7 +165,8 @@ To get a certificate thumbprint, use the [`Get-ChildItem`](../Microsoft.Powershell.Management/Get-ChildItem.md) cmdlets in the PowerShell Certificate Provider. -For more information, see [about_Certificate_Provider](../Microsoft.PowerShell.Security/About/about_Certificate_Provider.md). +For more information, see +[about_Certificate_Provider](../Microsoft.PowerShell.Security/About/about_Certificate_Provider.md). ```yaml Type: System.String @@ -217,7 +217,8 @@ Specify the value for **Credential** using one of the following formats: - A user name: "User01" - A domain name and a user name: "Domain01\User01" - A user principal name: "User@Domain.com" -- A PSCredential object, such as one returned by the [`Get-Credential`](../Microsoft.PowerShell.Security/Get-Credential.md) cmdlet. +- A PSCredential object, such as one returned by the + [`Get-Credential`](../Microsoft.PowerShell.Security/Get-Credential.md) cmdlet. When you type a user name, you are prompted for a password. @@ -237,8 +238,9 @@ Accept wildcard characters: False Specifies a friendly name for the CIM session. -You can use the name to refer to the CIM session when using other cmdlets, such as the [Get-CimSession](Get-CimSession.md) cmdlet. -The name is not required to be unique to the computer or the current session. +You can use the name to refer to the CIM session when using other cmdlets, such as the +[Get-CimSession](Get-CimSession.md) cmdlet. The name is not required to be unique to the computer +or the current session. ```yaml Type: System.String diff --git a/reference/7.5/CimCmdlets/New-CimSessionOption.md b/reference/7.5/CimCmdlets/New-CimSessionOption.md index bce19976d4bb..fa3eb5995404 100644 --- a/reference/7.5/CimCmdlets/New-CimSessionOption.md +++ b/reference/7.5/CimCmdlets/New-CimSessionOption.md @@ -95,7 +95,8 @@ parameter using one of the following formats: - A culture name in `-` format such as "EN-US". - A variable that contains a **CultureInfo** object. -- A command that gets a **CultureInfo** object, such as [Get-Culture](../Microsoft.PowerShell.Utility/Get-Culture.md) +- A command that gets a **CultureInfo** object, such as + [Get-Culture](../Microsoft.PowerShell.Utility/Get-Culture.md) ```yaml Type: System.Globalization.CultureInfo @@ -488,12 +489,12 @@ This cmdlet is only available on Windows platforms. ## RELATED LINKS -[Get-ChildItem](../microsoft.powershell.management/get-childitem.md) +[Get-ChildItem](../Microsoft.Powershell.Management/Get-ChildItem.md) -[Get-Credential](../microsoft.powershell.security/get-credential.md) +[Get-Credential](../Microsoft.Powershell.Security/Get-Credential.md) -[Get-Culture](../microsoft.powershell.utility/get-culture.md) +[Get-Culture](../Microsoft.Powershell.Utility/Get-Culture.md) -[Get-Item](../microsoft.powershell.management/get-item.md) +[Get-Item](../Microsoft.Powershell.Management/Get-Item.md) [New-CimSession](New-CimSession.md) diff --git a/reference/7.5/CimCmdlets/Register-CimIndicationEvent.md b/reference/7.5/CimCmdlets/Register-CimIndicationEvent.md index 849dbdce671e..837e2b12a407 100644 --- a/reference/7.5/CimCmdlets/Register-CimIndicationEvent.md +++ b/reference/7.5/CimCmdlets/Register-CimIndicationEvent.md @@ -98,13 +98,13 @@ script block for **Action**, which uses the `$event` variable to access the even $action = { $name = $event.SourceEventArgs.NewEvent.ProcessName $id = $event.SourceEventArgs.NewEvent.ProcessId - Write-Host -Object "New Process Started : Name = $name - ID = $id" + Write-Host -Object "New Process Started : Name = $name ID = $id" } Register-CimIndicationEvent -ClassName 'Win32_ProcessStartTrace' -SourceIdentifier "ProcessStarted" -Action $action ``` -For more information, see [Win32_ProcessStartTrace](/previous-versions/windows/desktop/krnlprov/win32-processstarttrace). +For more information, see +[Win32_ProcessStartTrace](/previous-versions/windows/desktop/krnlprov/win32-processstarttrace). ### Example 4: Register the events on a remote computer @@ -399,13 +399,13 @@ This cmdlet is only available on Windows platforms. ## RELATED LINKS -[Get-Event](../microsoft.powershell.utility/get-event.md) +[Get-Event](../Microsoft.Powershell.Utility/Get-Event.md) -[Remove-Event](../microsoft.powershell.utility/remove-event.md) +[Remove-Event](../Microsoft.Powershell.Utility/Remove-Event.md) -[Unregister-Event](../microsoft.powershell.utility/unregister-event.md) +[Unregister-Event](../Microsoft.Powershell.Utility/Unregister-Event.md) -[Write-Host](../microsoft.powershell.utility/write-host.md) +[Write-Host](../Microsoft.Powershell.Utility/Write-Host.md) [Get-CimSession](Get-CimSession.md) diff --git a/reference/7.5/CimCmdlets/Remove-CimInstance.md b/reference/7.5/CimCmdlets/Remove-CimInstance.md index ee1ff1e7007c..7787a946205a 100644 --- a/reference/7.5/CimCmdlets/Remove-CimInstance.md +++ b/reference/7.5/CimCmdlets/Remove-CimInstance.md @@ -329,6 +329,6 @@ This cmdlet is only available on Windows platforms. [New-CimInstance](New-CimInstance.md) -[Get-CimInstance](get-ciminstance.md) +[Get-CimInstance](Get-CimInstance.md) [Set-CimInstance](Set-CimInstance.md) diff --git a/reference/7.5/CimCmdlets/Remove-CimSession.md b/reference/7.5/CimCmdlets/Remove-CimSession.md index 8204da801ba3..b76e7ed28f4e 100644 --- a/reference/7.5/CimCmdlets/Remove-CimSession.md +++ b/reference/7.5/CimCmdlets/Remove-CimSession.md @@ -126,7 +126,8 @@ Specifies the ID of the CIM session to remove. Specify one or more IDs separated the range operator (`..`) to specify a range of IDs. An **Id** is an integer that uniquely identifies the CIM session in the current PowerShell session. -For more information about the range operator, see [about_Operators](../Microsoft.PowerShell.Core/About/about_Operators.md). +For more information about the range operator, see +[about_Operators](../Microsoft.PowerShell.Core/About/about_Operators.md). ```yaml Type: System.UInt32[] @@ -146,7 +147,8 @@ Specifies the instance ID of the CIM session to remove. **InstanceId** is a Glob Identifier (GUID) that uniquely identifies a CIM session. The **InstanceId** is unique, even when you have multiple sessions running in PowerShell. -The **InstanceId** is stored in the **InstanceId** property of the object that represents a CIM session. +The **InstanceId** is stored in the **InstanceId** property of the object that represents a CIM +session. ```yaml Type: System.Guid[] diff --git a/reference/7.5/CimCmdlets/Set-CimInstance.md b/reference/7.5/CimCmdlets/Set-CimInstance.md index a45f6a7953d8..f7cda96c2aa8 100644 --- a/reference/7.5/CimCmdlets/Set-CimInstance.md +++ b/reference/7.5/CimCmdlets/Set-CimInstance.md @@ -143,7 +143,7 @@ cmdlet, and retrieves its contents in to a variable `$x`. The variable is then p Because the **PassThru** parameter is used, This example returns a modified CIM instance object. ```powershell -$x = New-CimInstance -ClassName Win32_Environment -Property @{Name="testvar";UserName="domain\user"} -Key Name,UserName -ClientOnly +$x = New-CimInstance -ClassName Win32_Environment -Property @{Name="testvar";UserName="domain\user"} -Key Name, UserName -ClientOnly Set-CimInstance -CimInstance $x -Property @{VariableValue="somevalue"} -PassThru ``` @@ -424,8 +424,8 @@ This cmdlet is only available on Windows platforms. ## RELATED LINKS -[Get-CimInstance](get-ciminstance.md) +[Get-CimInstance](Get-CimInstance.md) [New-CimInstance](New-CimInstance.md) -[Remove-CimInstance](remove-ciminstance.md) +[Remove-CimInstance](Remove-CimInstance.md) diff --git a/reference/7.5/Microsoft.PowerShell.Utility/Invoke-RestMethod.md b/reference/7.5/Microsoft.PowerShell.Utility/Invoke-RestMethod.md index 7140d76a3268..4806dd48ce23 100644 --- a/reference/7.5/Microsoft.PowerShell.Utility/Invoke-RestMethod.md +++ b/reference/7.5/Microsoft.PowerShell.Utility/Invoke-RestMethod.md @@ -1414,7 +1414,7 @@ variations for each operating system and platform. To test a website with the standard user agent string that is used by most internet browsers, use the properties of the [PSUserAgent](/dotnet/api/microsoft.powershell.commands.psuseragent) class, -such as Chrome, FireFox, InternetExplorer, Opera, and Safari. +such as Chrome, Firefox, InternetExplorer, Opera, and Safari. ```yaml Type: System.String diff --git a/reference/7.5/Microsoft.PowerShell.Utility/Invoke-WebRequest.md b/reference/7.5/Microsoft.PowerShell.Utility/Invoke-WebRequest.md index 2a851863da97..ed77d11e29bd 100644 --- a/reference/7.5/Microsoft.PowerShell.Utility/Invoke-WebRequest.md +++ b/reference/7.5/Microsoft.PowerShell.Utility/Invoke-WebRequest.md @@ -1392,7 +1392,7 @@ variations for each operating system and platform. To test a website with the standard user agent string that's used by most internet browsers, use the properties of the [PSUserAgent](/dotnet/api/microsoft.powershell.commands.psuseragent) class, such -as Chrome, FireFox, InternetExplorer, Opera, and Safari. +as Chrome, Firefox, InternetExplorer, Opera, and Safari. For example, the following command uses the user agent string for Internet Explorer: `Invoke-WebRequest -Uri https://website.com/ -UserAgent ([Microsoft.PowerShell.Commands.PSUserAgent]::InternetExplorer)` diff --git a/reference/7.6/Microsoft.PowerShell.Core/Get-Command.md b/reference/7.6/Microsoft.PowerShell.Core/Get-Command.md index ed0e7a18de7e..a6c8f660e398 100644 --- a/reference/7.6/Microsoft.PowerShell.Core/Get-Command.md +++ b/reference/7.6/Microsoft.PowerShell.Core/Get-Command.md @@ -2,7 +2,7 @@ external help file: System.Management.Automation.dll-Help.xml Locale: en-US Module Name: Microsoft.PowerShell.Core -ms.date: 11/09/2024 +ms.date: 01/17/2025 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/get-command?view=powershell-7.6&WT.mc_id=ps-gethelp schema: 2.0.0 title: Get-Command @@ -17,20 +17,20 @@ Gets all commands. ### CmdletSet (Default) ``` -Get-Command [-Verb ] [-Noun ] [-Module ] - [-FullyQualifiedModule ] [-TotalCount ] [-Syntax] [-ShowCommandInfo] - [[-ArgumentList] ] [-All] [-ListImported] [-ParameterName ] - [-ParameterType ] [] +Get-Command [[-ArgumentList] ] [-Verb ] [-Noun ] + [-Module ] [-ExcludeModule ] [-FullyQualifiedModule ] + [-TotalCount ] [-Syntax] [-ShowCommandInfo] [-All] [-ListImported] + [-ParameterName ] [-ParameterType ] [] ``` ### AllCommandSet ``` -Get-Command [[-Name] ] [-Module ] - [-FullyQualifiedModule ] [-CommandType ] [-TotalCount ] - [-Syntax] [-ShowCommandInfo] [[-ArgumentList] ] [-All] [-ListImported] - [-ParameterName ] [-ParameterType ] [-UseFuzzyMatching] - [-FuzzyMinimumDistance ] [-UseAbbreviationExpansion] [] +Get-Command [[-Name] ] [[-ArgumentList] ] [-Module ] + [-ExcludeModule ] [-FullyQualifiedModule ] + [-CommandType ] [-TotalCount ] [-Syntax] [-ShowCommandInfo] [-All] + [-ListImported] [-ParameterName ] [-ParameterType ] [-UseFuzzyMatching] + [-FuzzyMinimumDistance ] [-UseAbbreviationExpansion] [] ``` ## DESCRIPTION @@ -324,6 +324,18 @@ Application getconf 0.0.0.0 /usr/bin/getconf Application command 0.0.0.0 /usr/bin/command ``` +### Example 17: Exclude modules from the search for commands + +The following example shows the difference in results of searching for commands in all modules and +when you exclude a specific module. + +```powershell +PS> (Get-Command *-*Disk*).Count +73 +PS> (Get-Command *-*Disk* -ExcludeModule Storage).Count +35 +``` + ## PARAMETERS ### -All @@ -425,6 +437,22 @@ Accept pipeline input: True (ByPropertyName) Accept wildcard characters: False ``` +### ExcludeModule + +Specify the name of one or more modules to be excluded from the search. + +```yaml +Type: System.String[] +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: ByValue (False), ByName (False) +Accept wildcard characters: False +``` + ### -FullyQualifiedModule The value can be a module name, a full module specification, or a path to a module file. diff --git a/reference/7.6/Microsoft.PowerShell.Utility/Invoke-RestMethod.md b/reference/7.6/Microsoft.PowerShell.Utility/Invoke-RestMethod.md index 1efeab040902..a4425a3a327a 100644 --- a/reference/7.6/Microsoft.PowerShell.Utility/Invoke-RestMethod.md +++ b/reference/7.6/Microsoft.PowerShell.Utility/Invoke-RestMethod.md @@ -1414,7 +1414,7 @@ variations for each operating system and platform. To test a website with the standard user agent string that is used by most internet browsers, use the properties of the [PSUserAgent](/dotnet/api/microsoft.powershell.commands.psuseragent) class, -such as Chrome, FireFox, InternetExplorer, Opera, and Safari. +such as Chrome, Firefox, InternetExplorer, Opera, and Safari. ```yaml Type: System.String diff --git a/reference/7.6/Microsoft.PowerShell.Utility/Invoke-WebRequest.md b/reference/7.6/Microsoft.PowerShell.Utility/Invoke-WebRequest.md index 9b52c61384e8..3e73aab3c1b5 100644 --- a/reference/7.6/Microsoft.PowerShell.Utility/Invoke-WebRequest.md +++ b/reference/7.6/Microsoft.PowerShell.Utility/Invoke-WebRequest.md @@ -1392,7 +1392,7 @@ variations for each operating system and platform. To test a website with the standard user agent string that's used by most internet browsers, use the properties of the [PSUserAgent](/dotnet/api/microsoft.powershell.commands.psuseragent) class, such -as Chrome, FireFox, InternetExplorer, Opera, and Safari. +as Chrome, Firefox, InternetExplorer, Opera, and Safari. For example, the following command uses the user agent string for Internet Explorer: `Invoke-WebRequest -Uri https://website.com/ -UserAgent ([Microsoft.PowerShell.Commands.PSUserAgent]::InternetExplorer)` diff --git a/reference/docs-conceptual/community/contributing/get-started-writing.md b/reference/docs-conceptual/community/contributing/get-started-writing.md index 4fd2d09bbd6d..57076a72ead1 100644 --- a/reference/docs-conceptual/community/contributing/get-started-writing.md +++ b/reference/docs-conceptual/community/contributing/get-started-writing.md @@ -1,6 +1,6 @@ --- description: This article is an overview of how to get started as a contributor to the PowerShell documentation. -ms.date: 01/03/2025 +ms.date: 01/17/2025 title: Get started contributing to PowerShell documentation --- # Get started contributing to PowerShell documentation @@ -18,9 +18,9 @@ There are three categories of content in the [PowerShell-Docs][1] repository: ### Reference content The reference content is the PowerShell cmdlet reference for the cmdlets that ship in PowerShell. -The cmdlet [reference][2] is collected in versioned folders (like 5.1, 7.4, and 7.5), which contain -reference for the modules that ship with PowerShell. This content is also used to create the help -information displayed by the `Get-Help` cmdlet. +The cmdlet [reference][2] is collected in versioned folders (like 5.1, 7.4, 7.5, and 7.6), which +contain the reference for the modules that ship with PowerShell. This content is also used to create +the help information displayed by the `Get-Help` cmdlet. ### Conceptual content diff --git a/reference/docs-conceptual/how-to-use-docs.md b/reference/docs-conceptual/how-to-use-docs.md index 009c2ed855bc..66eb44c204cb 100644 --- a/reference/docs-conceptual/how-to-use-docs.md +++ b/reference/docs-conceptual/how-to-use-docs.md @@ -1,6 +1,6 @@ --- description: This articles explains how to use the features of this site including search filtering and version selection. -ms.date: 11/02/2024 +ms.date: 01/17/2025 ms.topic: how-to title: How to use the PowerShell documentation --- @@ -9,7 +9,8 @@ title: How to use the PowerShell documentation Welcome to the PowerShell online documentation. This site contains cmdlet reference for the following versions of PowerShell: -- PowerShell 7.5 (preview) +- PowerShell 7.6 (preview) +- PowerShell 7.5 (RC) - PowerShell 7.4 (LTS) - PowerShell 5.1 @@ -97,7 +98,7 @@ can choose **Previous Versions** from the version selector. ![Screenshot of the Previous Versions option.](media/how-to-use-docs/previous-versions.gif) -This site contains documentation for the following topics: +The previous versions site contains documentation for the following topics: - PowerShell 7.3 - PowerShell 7.2 diff --git a/reference/docs-conceptual/install/PowerShell-Support-Lifecycle.md b/reference/docs-conceptual/install/PowerShell-Support-Lifecycle.md index 5caaf14112bd..df0a2f646cc0 100644 --- a/reference/docs-conceptual/install/PowerShell-Support-Lifecycle.md +++ b/reference/docs-conceptual/install/PowerShell-Support-Lifecycle.md @@ -1,6 +1,6 @@ --- description: Details the policies governing support for PowerShell. -ms.date: 05/09/2024 +ms.date: 01/17/2025 ms.topic: lifecycle title: PowerShell Support Lifecycle --- @@ -110,21 +110,21 @@ guarantees of responsiveness or fixes. The PowerShell support lifecycle follows the [support lifecycle of .NET][06]. The following table lists the end-of-support dates for the current versions of PowerShell: -| Version | End-of-support | Release Date | +| Version | Release Date | End-of-support | | --------- | ------------------ | ------------------ | -| 7.4 (LTS) | November 10, 2026 | November 16, 2023 | +| 7.4 (LTS) | November 16, 2023 | November 10, 2026 | The following table lists the end-of-support dates for retired versions of PowerShell: -| Version | End-of-support | Release Date | +| Version | Release Date | End-of-support | | --------- | ------------------ | ------------------ | -| 7.2 (LTS) | November 8, 2024 | November 8, 2021 | -| 7.3 | May 8, 2024 | November 9, 2022 | -| 7.0 (LTS) | December 3, 2022 | March 4, 2020 | -| 7.1 | May 8, 2022 | November 11, 2020 | -| 6.2 | September 4, 2020 | March 28, 2019 | -| 6.1 | September 28, 2019 | September 13, 2018 | -| 6.0 | February 13, 2019 | January 20, 2018 | +| 7.3 | November 9, 2022 | May 8, 2024 | +| 7.2 (LTS) | November 8, 2021 | November 8, 2024 | +| 7.0 (LTS) | March 4, 2020 | December 3, 2022 | +| 7.1 | November 11, 2020 | May 8, 2022 | +| 6.2 | March 28, 2019 | September 4, 2020 | +| 6.1 | September 13, 2018 | September 28, 2019 | +| 6.0 | January 20, 2018 | February 13, 2019 | ## Release history @@ -132,7 +132,8 @@ The following table contains a historical timeline of the major releases of Powe | Version | Release Date | Note | | ------------------------ | :----------: | -------------------------------------------------------------------------- | -| PowerShell 7.5 (preview) | Future | Built on [.NET 9.0.0][14] | +| PowerShell 7.6 (preview) | Future | Built on [.NET 9.0.0][14] | +| PowerShell 7.5 (RC) | Future | Built on [.NET 9.0.0][14] | | PowerShell 7.4 (LTS) | Nov-2023 | Built on [.NET 8.0.0][13] | | PowerShell 7.3 | Nov-2022 | Built on [.NET 7.0][12] | | PowerShell 7.2 (LTS) | Nov-2021 | Built on [.NET 6.0][11] | diff --git a/reference/docs-conceptual/toc.yml b/reference/docs-conceptual/toc.yml index 78472580a71f..5ec029edd8df 100644 --- a/reference/docs-conceptual/toc.yml +++ b/reference/docs-conceptual/toc.yml @@ -215,6 +215,8 @@ items: items: - name: Overview href: whats-new/overview.yml + - name: What's new in PowerShell 7.6 + href: whats-new/what-s-new-in-powershell-76.md - name: What's new in PowerShell 7.5 href: whats-new/what-s-new-in-powershell-75.md - name: What's new in PowerShell 7.4 diff --git a/reference/docs-conceptual/whats-new/What-s-New-in-PowerShell-76.md b/reference/docs-conceptual/whats-new/What-s-New-in-PowerShell-76.md new file mode 100644 index 000000000000..9a5f9b458ada --- /dev/null +++ b/reference/docs-conceptual/whats-new/What-s-New-in-PowerShell-76.md @@ -0,0 +1,75 @@ +--- +title: What's New in PowerShell 7.6 +description: New features and changes released in PowerShell 7.6 +ms.date: 01/17/2025 +--- + +# What's New in PowerShell 7.6 + +PowerShell 7.6-preview.2 includes the following features, updates, and breaking changes. PowerShell +7.6 is built on .NET 9.0.101 GA release. + +For a complete list of changes, see the [CHANGELOG][04] in the GitHub repository. + +## Breaking Changes + +No breaking changes were introduced in PowerShell 7.6-preview.2. + +## Updated modules + +PowerShell 7.6-preview.2 includes the following updated modules: + +- **Microsoft.PowerShell.PSResourceGet** v1.1.0-RC3 +- **PSReadLine** v2.3.6 + +## Tab completion improvements + +- Update Named and Statement block type inference to not consider AssignmentStatements and + Increment/decrement operators as part of their output ([#21137][21137]) (Thanks @MartinGC94!) +- Add -PropertyType argument completer for New-ItemProperty ([#21117][21117]) (Thanks + @ArmaanMcleod!) + +## Cmdlet improvements + +- Add -ExcludeModule parameter to Get-Command ([#18955][18955]) (Thanks @MartinGC94!) +- Return correct FileName property for Get-Item when listing alternate data streams + ([#18019][18019]) (Thanks @kilasuit!) +- Fix Get-ItemProperty to report non-terminating error for cast exception ([#21115][21115]) (Thanks + @ArmaanMcleod!) +- Fix a bug in how Write-Host handles XmlNode object ([#24669][24669]) (Thanks @brendandburns!) + +## Engine improvements + +- Added the AIShell module to telemetry collection list ([#24747][24747]) +- Added helper in EnumSingleTypeConverter to get enum names as array ([#17785][17785]) (Thanks + @fflaten!) +- Update DnsNameList for X509Certificate2 to use + X509SubjectAlternativeNameExtension.EnumerateDnsNames Method ([#24714][24714]) (Thanks + @ArmaanMcleod!) +- Add completion of modules by their shortname ([#20330][20330]) (Thanks @MartinGC94!) + +## Experimental features + +The following experimental features are included in PowerShell 7.6-preview.2: + +- [PSNativeWindowsTildeExpansion][01] - Add tilde expansion for windows native executables +- [PSRedirectToVariable][02] - Allow redirecting to a variable +- [PSSerializeJSONLongEnumAsNumber][03] - `ConvertTo-Json` now treats large enums as numbers + + + +[01]: ../learn/experimental-features.md#psnativewindowstildeexpansion +[02]: ../learn/experimental-features.md#psredirecttovariable +[03]: ../learn/experimental-features.md#psserializejsonlongenumasnumber +[04]: https://github.com/PowerShell/PowerShell/blob/master/CHANGELOG/preview.md + +[17785]: https://github.com/PowerShell/PowerShell/pull/17785 +[18019]: https://github.com/PowerShell/PowerShell/pull/18019 +[18955]: https://github.com/PowerShell/PowerShell/pull/18955 +[20330]: https://github.com/PowerShell/PowerShell/pull/20330 +[21115]: https://github.com/PowerShell/PowerShell/pull/21115 +[21117]: https://github.com/PowerShell/PowerShell/pull/21117 +[21137]: https://github.com/PowerShell/PowerShell/pull/21137 +[24669]: https://github.com/PowerShell/PowerShell/pull/24669 +[24714]: https://github.com/PowerShell/PowerShell/pull/24714 +[24747]: https://github.com/PowerShell/PowerShell/pull/24747 diff --git a/reference/docs-conceptual/whats-new/cmdlet-versions.md b/reference/docs-conceptual/whats-new/cmdlet-versions.md index 7bf3b23d5f7d..df9236924ed0 100644 --- a/reference/docs-conceptual/whats-new/cmdlet-versions.md +++ b/reference/docs-conceptual/whats-new/cmdlet-versions.md @@ -1,6 +1,6 @@ --- description: This article lists the modules and cmdlets that are included in various versions of PowerShell. -ms.date: 01/18/2024 +ms.date: 01/17/2025 title: Release history of modules and cmdlets --- # Release history of modules and cmdlets @@ -20,7 +20,7 @@ This is a work in progress. Please help us keep this information fresh. ## Module release history -| ModuleName / PSVersion | 5.1 | 7.2 | 7.4 | 7.5 | Note | +| ModuleName / PSVersion | 5.1 | 7.4 | 7.5 | 7.6 | Note | | ----------------------------------------------- | --------------- | --------------- | --------------- | --------------- | ------------------------------------------- | | [CimCmdlets][05] | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | Windows only | | [ISE (introduced in 2.0)][06] | ![Included][01] | | | | Windows only | @@ -32,7 +32,7 @@ This is a work in progress. Please help us keep this information fresh. | [Microsoft.PowerShell.Management][12] | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | | [Microsoft.PowerShell.ODataUtils][13] | ![Included][01] | | | | Windows only | | [Microsoft.PowerShell.Operation.Validation][14] | ![Included][01] | | | | Windows only | -| [Microsoft.PowerShell.PSResourceGet][15] | | | ![Included][01] | ![Included][01] | New versions available from the Gallery | +| [Microsoft.PowerShell.PSResourceGet][15] | | ![Included][01] | ![Included][01] | ![Included][01] | New versions available from the Gallery | | [Microsoft.PowerShell.Security][16] | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | | [Microsoft.PowerShell.Utility][17] | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | | [Microsoft.WsMan.Management][18] | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | Windows only | @@ -40,10 +40,10 @@ This is a work in progress. Please help us keep this information fresh. | [PowershellGet 1.1][20] | ![Included][01] | | | | Must upgrade to v2.x | | [PowershellGet 2.x][20] | | ![Included][01] | ![Included][01] | ![Included][01] | New versions available from the Gallery | | [PSDesiredStateConfiguration 1.1][21] | ![Included][01] | | | | Removed in 7.2 - available from the Gallery | -| [PSDesiredStateConfiguration 2.x][22] | | ![Removed][02] | | | Removed in 7.2 - available from the Gallery | +| [PSDesiredStateConfiguration 2.x][22] | | | | | Removed in 7.2 - available from the Gallery | | [PSDesiredStateConfiguration 3.x][23] | | | | | Preview available from the Gallery | | [PSDiagnostics][24] | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | Windows only | -| [PSReadLine][25] | v1.x | v2.1 | v2.3.4 | v2.3.4 | New versions available from the Gallery | +| [PSReadLine][25] | v1.x | v2.3.4 | v2.3.4 | v2.3.6 | New versions available from the Gallery | | [PSScheduledJob][26] | ![Included][01] | | | | Windows only | | [PSWorkflow][27] | ![Included][01] | | | | Windows only | | [PSWorkflowUtility][27] | ![Included][01] | | | | Windows only | @@ -53,7 +53,7 @@ This is a work in progress. Please help us keep this information fresh. ### CimCmdlets -| Cmdlet name | 5.1 | 7.2 | 7.4 | 7.5 | Note | +| Cmdlet name | 5.1 | 7.4 | 7.5 | 7.6 | Note | | --------------------------- | --------------- | --------------- | --------------- | --------------- | ------------ | | Export-BinaryMiLog | ![Included][01] | | | | Windows only | | Get-CimAssociatedInstance | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | Windows only | @@ -82,14 +82,14 @@ This modules is only available in Windows PowerShell. ### Microsoft.PowerShell.Archive -| Cmdlet name | 5.1 | 7.2 | 7.4 | 7.5 | Note | +| Cmdlet name | 5.1 | 7.4 | 7.5 | 7.6 | Note | | ---------------- | --------------- | --------------- | --------------- | --------------- | ---- | | Compress-Archive | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | | Expand-Archive | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | ### Microsoft.PowerShell.Core -| Cmdlet name | 5.1 | 7.2 | 7.4 | 7.5 | Note | +| Cmdlet name | 5.1 | 7.4 | 7.5 | 7.6 | Note | | --------------------------------- | --------------- | --------------- | --------------- | --------------- | ------------------------------------------ | | Add-History | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | | Add-PSSnapin | ![Included][01] | | | | Windows only | @@ -162,7 +162,7 @@ This modules is only available in Windows PowerShell. ### Microsoft.PowerShell.Diagnostics -| Cmdlet name | 5.1 | 7.2 | 7.4 | 7.5 | Note | +| Cmdlet name | 5.1 | 7.4 | 7.5 | 7.6 | Note | | -------------- | --------------- | --------------- | --------------- | --------------- | ------------ | | Export-Counter | ![Included][01] | | | | Windows only | | Get-Counter | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | Windows only | @@ -172,7 +172,7 @@ This modules is only available in Windows PowerShell. ### Microsoft.PowerShell.Host -| Cmdlet name | 5.1 | 7.2 | 7.4 | 7.5 | Note | +| Cmdlet name | 5.1 | 7.4 | 7.5 | 7.6 | Note | | ---------------- | --------------- | --------------- | --------------- | --------------- | ---- | | Start-Transcript | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | | Stop-Transcript | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | @@ -201,7 +201,7 @@ This modules is only available in Windows PowerShell. ### Microsoft.PowerShell.Management -| Cmdlet name | 5.1 | 7.2 | 7.4 | 7.5 | Note | +| Cmdlet name | 5.1 | 7.4 | 7.5 | 7.6 | Note | | ----------------------------- | --------------- | --------------- | --------------- | --------------- | -------------------------------- | | Add-Computer | ![Included][01] | | | | Windows only | | Add-Content | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | @@ -314,30 +314,31 @@ This modules is only available in Windows PowerShell. ### Microsoft.PowerShell.PSResourceGet -| Cmdlet name | 7.4 | 7.5 | Note | -| ------------------------------- | --------------- | --------------- | ---- | -| Get-PSResource | ![Included][01] | ![Included][01] | | -| Import-PSGetRepository | ![Included][01] | ![Included][01] | | -| Find-PSResource | ![Included][01] | ![Included][01] | | -| Get-InstalledPSResource | ![Included][01] | ![Included][01] | | -| Get-PSResourceRepository | ![Included][01] | ![Included][01] | | -| Get-PSScriptFileInfo | ![Included][01] | ![Included][01] | | -| Install-PSResource | ![Included][01] | ![Included][01] | | -| New-PSScriptFileInfo | ![Included][01] | ![Included][01] | | -| Publish-PSResource | ![Included][01] | ![Included][01] | | -| Register-PSResourceRepository | ![Included][01] | ![Included][01] | | -| Save-PSResource | ![Included][01] | ![Included][01] | | -| Set-PSResourceRepository | ![Included][01] | ![Included][01] | | -| Test-PSScriptFileInfo | ![Included][01] | ![Included][01] | | -| Uninstall-PSResource | ![Included][01] | ![Included][01] | | -| Unregister-PSResourceRepository | ![Included][01] | ![Included][01] | | -| Update-PSModuleManifest | ![Included][01] | ![Included][01] | | -| Update-PSResource | ![Included][01] | ![Included][01] | | -| Update-PSScriptFileInfo | ![Included][01] | ![Included][01] | | +| Cmdlet name | 7.4 | 7.5 | 7.6 | Note | +| ------------------------------- | --------------- | --------------- | --------------- | ----------------------------- | +| Compress-PSResource | | ![Included][01] | ![Included][01] | Added in v1.1.0 of the module | +| Find-PSResource | ![Included][01] | ![Included][01] | ![Included][01] | | +| Get-InstalledPSResource | ![Included][01] | ![Included][01] | ![Included][01] | | +| Get-PSResource | ![Included][01] | ![Included][01] | ![Included][01] | | +| Get-PSResourceRepository | ![Included][01] | ![Included][01] | ![Included][01] | | +| Get-PSScriptFileInfo | ![Included][01] | ![Included][01] | ![Included][01] | | +| Import-PSGetRepository | ![Included][01] | ![Included][01] | ![Included][01] | | +| Install-PSResource | ![Included][01] | ![Included][01] | ![Included][01] | | +| New-PSScriptFileInfo | ![Included][01] | ![Included][01] | ![Included][01] | | +| Publish-PSResource | ![Included][01] | ![Included][01] | ![Included][01] | | +| Register-PSResourceRepository | ![Included][01] | ![Included][01] | ![Included][01] | | +| Save-PSResource | ![Included][01] | ![Included][01] | ![Included][01] | | +| Set-PSResourceRepository | ![Included][01] | ![Included][01] | ![Included][01] | | +| Test-PSScriptFileInfo | ![Included][01] | ![Included][01] | ![Included][01] | | +| Uninstall-PSResource | ![Included][01] | ![Included][01] | ![Included][01] | | +| Unregister-PSResourceRepository | ![Included][01] | ![Included][01] | ![Included][01] | | +| Update-PSModuleManifest | ![Included][01] | ![Included][01] | ![Included][01] | | +| Update-PSResource | ![Included][01] | ![Included][01] | ![Included][01] | | +| Update-PSScriptFileInfo | ![Included][01] | ![Included][01] | ![Included][01] | | ### Microsoft.PowerShell.Security -| Cmdlet name | 5.1 | 7.2 | 7.4 | 7.5 | Note | +| Cmdlet name | 5.1 | 7.4 | 7.5 | 7.6 | Note | | ------------------------- | --------------- | --------------- | --------------- | --------------- | --------------------------------------- | | ConvertFrom-SecureString | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | | ConvertTo-SecureString | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | @@ -357,19 +358,21 @@ This modules is only available in Windows PowerShell. ### Microsoft.PowerShell.Utility -| Cmdlet name | 5.1 | 7.2 | 7.4 | 7.5 | Note | +| Cmdlet name | 5.1 | 7.4 | 7.5 | 7.6 | Note | | ------------------------- | --------------- | --------------- | --------------- | --------------- | ----------------------------------------- | | Add-Member | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | | Add-Type | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | | Clear-Variable | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | | Compare-Object | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | +| Convert-String | ![Included][01] | | | | | +| ConvertFrom-CliXml | | | ![Included][01] | ![Included][01] | Added in 7.5 | | ConvertFrom-Csv | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | | ConvertFrom-Json | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | | ConvertFrom-Markdown | | ![Included][01] | ![Included][01] | ![Included][01] | Added in 6.1 | | ConvertFrom-SddlString | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | Windows only | | ConvertFrom-String | ![Included][01] | | | | | | ConvertFrom-StringData | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | -| Convert-String | ![Included][01] | | | | | +| ConvertTo-CliXml | | | ![Included][01] | ![Included][01] | Added in 7.5 | | ConvertTo-Csv | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | | ConvertTo-Html | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | | ConvertTo-Json | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | @@ -405,7 +408,7 @@ This modules is only available in Windows PowerShell. | Get-Random | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | | Get-Runspace | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | | Get-RunspaceDebug | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | -| Get-SecureRandom | | | ![Included][01] | ![Included][01] | Added in 7.4 | +| Get-SecureRandom | | ![Included][01] | ![Included][01] | ![Included][01] | Added in 7.4 | | Get-TraceSource | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | | Get-TypeData | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | | Get-UICulture | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | @@ -480,7 +483,7 @@ This modules is only available in Windows PowerShell. ### Microsoft.WsMan.Management -| Cmdlet name | 5.1 | 7.2 | 7.4 | 7.5 | Note | +| Cmdlet name | 5.1 | 7.4 | 7.5 | 7.6 | Note | | ---------------------- | --------------- | --------------- | --------------- | --------------- | ------------ | | Connect-WSMan | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | Windows only | | Disable-WSManCredSSP | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | Windows only | @@ -498,25 +501,25 @@ This modules is only available in Windows PowerShell. ### PackageManagement -| Cmdlet name | 5.1 | 7.2 | 7.4 | 7.4 | 7.5 | Note | -| ------------------------ | --------------- | --------------- | --------------- | --------------- | --------------- | ---- | -| Find-Package | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | -| Find-PackageProvider | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | -| Get-Package | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | -| Get-PackageProvider | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | -| Get-PackageSource | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | -| Import-PackageProvider | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | -| Install-Package | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | -| Install-PackageProvider | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | -| Register-PackageSource | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | -| Save-Package | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | -| Set-PackageSource | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | -| Uninstall-Package | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | -| Unregister-PackageSource | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | +| Cmdlet name | 5.1 | 7.4 | 7.5 | 7.6 | Note | +| ------------------------ | --------------- | --------------- | --------------- | --------------- | ---- | +| Find-Package | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | +| Find-PackageProvider | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | +| Get-Package | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | +| Get-PackageProvider | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | +| Get-PackageSource | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | +| Import-PackageProvider | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | +| Install-Package | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | +| Install-PackageProvider | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | +| Register-PackageSource | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | +| Save-Package | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | +| Set-PackageSource | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | +| Uninstall-Package | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | +| Unregister-PackageSource | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | ### PowershellGet 2.x -| Cmdlet name | 5.1 | 7.2 | 7.4 | 7.5 | Note | +| Cmdlet name | 5.1 | 7.4 | 7.5 | 7.6 | Note | | ------------------------------- | --------------- | --------------- | --------------- | --------------- | ---- | | Find-Command | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | | Find-DscResource | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | @@ -594,7 +597,7 @@ This modules is only available from the PowerShell Gallery. ### PSDiagnostics -| Cmdlet name | 5.1 | 7.2 | 7.4 | 7.5 | Note | +| Cmdlet name | 5.1 | 7.4 | 7.5 | 7.6 | Note | | ---------------------------- | --------------- | --------------- | --------------- | --------------- | ------------ | | Disable-PSTrace | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | Windows only | | Disable-PSWSManCombinedTrace | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | Windows only | @@ -609,7 +612,7 @@ This modules is only available from the PowerShell Gallery. ### PSReadLine -| Cmdlet name | 5.1 | 7.2 | 7.4 | 7.5 | Note | +| Cmdlet name | 5.1 | 7.4 | 7.5 | 7.6 | Note | | --------------------------- | --------------- | --------------- | --------------- | --------------- | ---- | | Get-PSReadLineKeyHandler | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | | Get-PSReadLineOption | ![Included][01] | ![Included][01] | ![Included][01] | ![Included][01] | | @@ -653,7 +656,7 @@ This modules is only available in Windows PowerShell. ### ThreadJob -| Cmdlet name | 5.1 | 7.2 | 7.4 | 7.5 | Note | +| Cmdlet name | 5.1 | 7.4 | 7.5 | 7.6 | Note | | --------------- | --- | --------------- | --------------- | --------------- | ---------------------------------- | | Start-ThreadJob | | ![Included][01] | ![Included][01] | ![Included][01] | Can be installed in PowerShell 5.1 | diff --git a/reference/docs-conceptual/whats-new/overview.yml b/reference/docs-conceptual/whats-new/overview.yml index 2342c09994c0..d57d646f6c77 100644 --- a/reference/docs-conceptual/whats-new/overview.yml +++ b/reference/docs-conceptual/whats-new/overview.yml @@ -9,7 +9,7 @@ metadata: ms.topic: landing-page author: sdwheeler ms.author: sewhee - ms.date: 11/30/2023 + ms.date: 01/17/2025 # linkListType: architecture | concept | deploy | download | get-started | how-to-guide | learn | # overview | quickstart | reference | tutorial | video | whats-new @@ -21,16 +21,14 @@ landingContent: linkLists: - linkListType: whats-new links: + - text: What's new in PowerShell 7.6 (preview) + url: ./What-s-New-in-PowerShell-76.md + - text: What's new in PowerShell 7.5 (RC) + url: ./What-s-New-in-PowerShell-75.md - text: What's new in PowerShell 7.4 (LTS) url: ./What-s-New-in-PowerShell-74.md - - text: What's new in PowerShell 7.3 - url: ./What-s-New-in-PowerShell-73.md - - text: What's new in PowerShell 7.2 (LTS) - url: ./What-s-New-in-PowerShell-72.md - - text: What's new in PowerShell 7.1 (out of support) - url: /previous-versions/powershell/scripting/whats-new/what-s-new-in-powershell-71 - - text: What's new in PowerShell 7.0 - url: ./What-s-New-in-PowerShell-70.md + - text: Differences between Windows PowerShell 5.1 and PowerShell 7 + url: ./differences-from-windows-powershell.md - text: PowerShell differences on non-Windows platforms url: ./unix-support.md