From 8c99632ea145563e9ef2836b914884f462351412 Mon Sep 17 00:00:00 2001 From: Sean Wheeler Date: Mon, 30 Mar 2026 18:53:36 -0500 Subject: [PATCH 1/3] Fix formatting to avoid over-localization (#12907) * Fix formatting to avoid over-localization * Apply suggestions from code review Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- .../Microsoft.PowerShell.Core/Start-Job.md | 18 +- .../Microsoft.PowerShell.Core/Start-Job.md | 20 +- .../Microsoft.PowerShell.Core/Start-Job.md | 20 +- .../Microsoft.PowerShell.Core/Start-Job.md | 20 +- ...d-verbs-for-windows-powershell-commands.md | 224 +++++++++--------- 5 files changed, 151 insertions(+), 151 deletions(-) diff --git a/reference/5.1/Microsoft.PowerShell.Core/Start-Job.md b/reference/5.1/Microsoft.PowerShell.Core/Start-Job.md index 641b6c0a4156..3c08faefc903 100644 --- a/reference/5.1/Microsoft.PowerShell.Core/Start-Job.md +++ b/reference/5.1/Microsoft.PowerShell.Core/Start-Job.md @@ -2,7 +2,7 @@ external help file: System.Management.Automation.dll-Help.xml Locale: en-US Module Name: Microsoft.PowerShell.Core -ms.date: 01/18/2026 +ms.date: 03/30/2026 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/start-job?view=powershell-5.1&WT.mc_id=ps-gethelp schema: 2.0.0 aliases: @@ -264,15 +264,15 @@ Specifies the mechanism that is used to authenticate user credentials. The acceptable values for this parameter are as follows: -- Default -- Basic -- Credssp -- Digest -- Kerberos -- Negotiate -- NegotiateWithImplicitCredential +- `Default` +- `Basic` +- `Credssp` +- `Digest` +- `Kerberos` +- `Negotiate` +- `NegotiateWithImplicitCredential` -The default value is Default. +The default value is `Default`. CredSSP authentication is available only in Windows Vista, Windows Server 2008, and later versions of the Windows operating system. diff --git a/reference/7.4/Microsoft.PowerShell.Core/Start-Job.md b/reference/7.4/Microsoft.PowerShell.Core/Start-Job.md index 15baa47c282b..3f81057b9c43 100644 --- a/reference/7.4/Microsoft.PowerShell.Core/Start-Job.md +++ b/reference/7.4/Microsoft.PowerShell.Core/Start-Job.md @@ -2,7 +2,7 @@ external help file: System.Management.Automation.dll-Help.xml Locale: en-US Module Name: Microsoft.PowerShell.Core -ms.date: 01/18/2026 +ms.date: 03/30/2026 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/start-job?view=powershell-7.4&WT.mc_id=ps-gethelp schema: 2.0.0 aliases: @@ -260,7 +260,7 @@ run scripts or open files. In this example, the background job specifies a worki different than the current directory location. ```powershell -PS C:\Test> Start-Job -WorkingDirectory C:\Test\Scripts { $PWD } | +PS C:\Test> Start-Job -WorkingDirectory C:\Test\Scripts { $PWD } | Receive-Job -AutoRemoveJob -Wait Path @@ -351,15 +351,15 @@ Specifies the mechanism that is used to authenticate user credentials. The acceptable values for this parameter are as follows: -- Default -- Basic -- Credssp -- Digest -- Kerberos -- Negotiate -- NegotiateWithImplicitCredential +- `Default` +- `Basic` +- `Credssp` +- `Digest` +- `Kerberos` +- `Negotiate` +- `NegotiateWithImplicitCredential` -The default value is Default. +The default value is `Default`. CredSSP authentication is available only in Windows Vista, Windows Server 2008, and later versions of the Windows operating system. diff --git a/reference/7.5/Microsoft.PowerShell.Core/Start-Job.md b/reference/7.5/Microsoft.PowerShell.Core/Start-Job.md index c798e2ca0839..e8c25982ab8c 100644 --- a/reference/7.5/Microsoft.PowerShell.Core/Start-Job.md +++ b/reference/7.5/Microsoft.PowerShell.Core/Start-Job.md @@ -2,7 +2,7 @@ external help file: System.Management.Automation.dll-Help.xml Locale: en-US Module Name: Microsoft.PowerShell.Core -ms.date: 01/18/2026 +ms.date: 03/30/2026 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/start-job?view=powershell-7.5&WT.mc_id=ps-gethelp schema: 2.0.0 aliases: @@ -260,7 +260,7 @@ run scripts or open files. In this example, the background job specifies a worki different than the current directory location. ```powershell -PS C:\Test> Start-Job -WorkingDirectory C:\Test\Scripts { $PWD } | +PS C:\Test> Start-Job -WorkingDirectory C:\Test\Scripts { $PWD } | Receive-Job -AutoRemoveJob -Wait Path @@ -351,15 +351,15 @@ Specifies the mechanism that is used to authenticate user credentials. The acceptable values for this parameter are as follows: -- Default -- Basic -- Credssp -- Digest -- Kerberos -- Negotiate -- NegotiateWithImplicitCredential +- `Default` +- `Basic` +- `Credssp` +- `Digest` +- `Kerberos` +- `Negotiate` +- `NegotiateWithImplicitCredential` -The default value is Default. +The default value is `Default`. CredSSP authentication is available only in Windows Vista, Windows Server 2008, and later versions of the Windows operating system. diff --git a/reference/7.6/Microsoft.PowerShell.Core/Start-Job.md b/reference/7.6/Microsoft.PowerShell.Core/Start-Job.md index f8135970c3de..45a80ecb29b9 100644 --- a/reference/7.6/Microsoft.PowerShell.Core/Start-Job.md +++ b/reference/7.6/Microsoft.PowerShell.Core/Start-Job.md @@ -2,7 +2,7 @@ external help file: System.Management.Automation.dll-Help.xml Locale: en-US Module Name: Microsoft.PowerShell.Core -ms.date: 01/18/2026 +ms.date: 03/30/2026 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/start-job?view=powershell-7.6&WT.mc_id=ps-gethelp schema: 2.0.0 aliases: @@ -260,7 +260,7 @@ run scripts or open files. In this example, the background job specifies a worki different than the current directory location. ```powershell -PS C:\Test> Start-Job -WorkingDirectory C:\Test\Scripts { $PWD } | +PS C:\Test> Start-Job -WorkingDirectory C:\Test\Scripts { $PWD } | Receive-Job -AutoRemoveJob -Wait Path @@ -351,15 +351,15 @@ Specifies the mechanism that is used to authenticate user credentials. The acceptable values for this parameter are as follows: -- Default -- Basic -- Credssp -- Digest -- Kerberos -- Negotiate -- NegotiateWithImplicitCredential +- `Default` +- `Basic` +- `Credssp` +- `Digest` +- `Kerberos` +- `Negotiate` +- `NegotiateWithImplicitCredential` -The default value is Default. +The default value is `Default`. CredSSP authentication is available only in Windows Vista, Windows Server 2008, and later versions of the Windows operating system. diff --git a/reference/docs-conceptual/developer/cmdlet/approved-verbs-for-windows-powershell-commands.md b/reference/docs-conceptual/developer/cmdlet/approved-verbs-for-windows-powershell-commands.md index 7b9c3f7306ae..eeab8f9a1603 100644 --- a/reference/docs-conceptual/developer/cmdlet/approved-verbs-for-windows-powershell-commands.md +++ b/reference/docs-conceptual/developer/cmdlet/approved-verbs-for-windows-powershell-commands.md @@ -1,6 +1,6 @@ --- description: Approved Verbs for PowerShell Commands -ms.date: 12/18/2025 +ms.date: 03/30/2026 title: Approved Verbs for PowerShell Commands --- # Approved Verbs for PowerShell Commands @@ -84,56 +84,56 @@ PowerShell uses the [System.Management.Automation.VerbsCommon][03] enumeration c generic actions that can apply to almost any cmdlet. The following table lists most of the defined verbs. -| Verb (alias) | Action | Synonyms to avoid | -| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ | -| [`Add`][04] (`a`) | Adds a resource to a container, or attaches an item to another item. For example, the `Add-Content` cmdlet adds content to a file. This verb is paired with `Remove`. | Append, Attach, Concatenate, Insert | -| [`Clear`][05] (`cl`) | Removes all the resources from a container but doesn't delete the container. For example, the `Clear-Content` cmdlet removes the contents of a file but doesn't delete the file. | Flush, Erase, Release, Unmark, Unset, Nullify | -| [`Close`][06] (`cs`) | Changes the state of a resource to make it inaccessible, unavailable, or unusable. This verb is paired with `Open.` | | -| [`Copy`][07] (`cp`) | Copies a resource to another name or to another container. For example, the `Copy-Item` cmdlet copies an item (such as a file) from one location in the data store to another location. | Duplicate, Clone, Replicate, Sync | -| [`Enter`][08] (`et`) | Specifies an action that allows the user to move into a resource. For example, the `Enter-PSSession` cmdlet places the user in an interactive session. This verb is paired with `Exit`. | Push, Into | -| [`Exit`][09] (`ex`) | Sets the current environment or context to the most recently used context. For example, the `Exit-PSSession` cmdlet places the user in the session that was used to start the interactive session. This verb is paired with `Enter`. | Pop, Out | -| [`Find`][10] (`fd`) | Looks for an object in a container that's unknown, implied, optional, or specified. | Search | -| [`Format`][11] (`f`) | Arranges objects in a specified form or layout | | -| [`Get`][12] (`g`) | Specifies an action that retrieves a resource. This verb is paired with `Set`. | Read, Open, Cat, Type, Dir, Obtain, Dump, Acquire, Examine, Find, Search | -| [`Hide`][13] (`h`) | Makes a resource undetectable. For example, a cmdlet whose name includes the Hide verb might conceal a service from a user. This verb is paired with `Show`. | Block | -| [`Join`][14] (`j`) | Combines resources into one resource. For example, the `Join-Path` cmdlet combines a path with one of its child paths to create a single path. This verb is paired with `Split`. | Combine, Unite, Connect, Associate | -| [`Lock`][15] (`lk`) | Secures a resource. This verb is paired with `Unlock`. | Restrict, Secure | -| [`Move`][16] (`m`) | Moves a resource from one location to another. For example, the `Move-Item` cmdlet moves an item from one location in the data store to another location. | Transfer, Name, Migrate | -| [`New`][17] (`n`) | Creates a resource. (The `Set` verb can also be used when creating a resource that includes data, such as the `Set-Variable` cmdlet.) | Create, Generate, Build, Make, Allocate | -| [`Open`][18] (`op`) | Changes the state of a resource to make it accessible, available, or usable. This verb is paired with `Close`. | | -| [`Optimize`][19] (`om`) | Increases the effectiveness of a resource. | | -| [`Pop`][20] (`pop`) | Removes an item from the top of a stack. For example, the `Pop-Location` cmdlet changes the current location to the location that was most recently pushed onto the stack. | | -| [`Push`][21] (`pu`) | Adds an item to the top of a stack. For example, the `Push-Location` cmdlet pushes the current location onto the stack. | | -| [`Redo`][22] (`re`) | Resets a resource to the state that was undone. | | -| [`Remove`][23] (`r`) | Deletes a resource from a container. For example, the `Remove-Variable` cmdlet deletes a variable and its value. This verb is paired with `Add`. | Clear, Cut, Dispose, Discard, Erase | -| [`Rename`][24] (`rn`) | Changes the name of a resource. For example, the `Rename-Item` cmdlet, which is used to access stored data, changes the name of an item in the data store. | Change | -| [`Reset`][25] (`rs`) | Sets a resource back to its original state. | | -| [`Resize`][26] (`rz`) | Changes the size of a resource. | | -| [`Search`][27] (`sr`) | Creates a reference to a resource in a container. | Find, Locate | -| [`Select`][28] (`sc`) | Locates a resource in a container. For example, the `Select-String` cmdlet finds text in strings and files. | Find, Locate | -| [`Set`][29] (`s`) | Replaces data on an existing resource or creates a resource that contains some data. For example, the `Set-Date` cmdlet changes the system time on the local computer. (The `New` verb can also be used to create a resource.) This verb is paired with `Get`. | Write, Reset, Assign, Configure, Update | -| [`Show`][30] (`sh`) | Makes a resource visible to the user. This verb is paired with `Hide`. | Display, Produce | -| [`Skip`][31] (`sk`) | Bypasses one or more resources or points in a sequence. | Bypass, Jump | -| [`Split`][32] (`sl`) | Separates parts of a resource. For example, the `Split-Path` cmdlet returns different parts of a path. This verb is paired with `Join`. | Separate | -| [`Step`][33] (`st`) | Moves to the next point or resource in a sequence. | | -| [`Switch`][34] (`sw`) | Specifies an action that alternates between two resources, such as to change between two locations, responsibilities, or states. | | -| [`Undo`][35] (`un`) | Sets a resource to its previous state. | | -| [`Unlock`][36] (`uk`) | Releases a resource that was locked. This verb is paired with `Lock`. | Release, Unrestrict, Unsecure | -| [`Watch`][37] (`wc`) | Continually inspects or monitors a resource for changes. | | +| Verb (alias) | Action | Synonyms to avoid | +| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | +| [`Add`][04] (`a`) | Adds a resource to a container, or attaches an item to another item. For example, the `Add-Content` cmdlet adds content to a file. This verb is paired with `Remove`. | `Append`, `Attach`, `Concatenate`, `Insert` | +| [`Clear`][05] (`cl`) | Removes all the resources from a container but doesn't delete the container. For example, the `Clear-Content` cmdlet removes the contents of a file but doesn't delete the file. | `Flush`, `Erase`, `Release`, `Unmark`, `Unset`, `Nullify` | +| [`Close`][06] (`cs`) | Changes the state of a resource to make it inaccessible, unavailable, or unusable. This verb is paired with `Open.` | | +| [`Copy`][07] (`cp`) | Copies a resource to another name or to another container. For example, the `Copy-Item` cmdlet copies an item (such as a file) from one location in the data store to another location. | `Duplicate`, `Clone`, `Replicate`, `Sync` | +| [`Enter`][08] (`et`) | Specifies an action that allows the user to move into a resource. For example, the `Enter-PSSession` cmdlet places the user in an interactive session. This verb is paired with `Exit`. | `Push`, `Into` | +| [`Exit`][09] (`ex`) | Sets the current environment or context to the most recently used context. For example, the `Exit-PSSession` cmdlet places the user in the session that was used to start the interactive session. This verb is paired with `Enter`. | `Pop`, `Out` | +| [`Find`][10] (`fd`) | Looks for an object in a container that's unknown, implied, optional, or specified. | `Search` | +| [`Format`][11] (`f`) | Arranges objects in a specified form or layout | | +| [`Get`][12] (`g`) | Specifies an action that retrieves a resource. This verb is paired with `Set`. | `Read`, `Open`, `Cat`, `Type`, `Dir`, `Obtain`, `Dump`, `Acquire`, `Examine`, `Find`, `Search` | +| [`Hide`][13] (`h`) | Makes a resource undetectable. For example, a cmdlet whose name includes the Hide verb might conceal a service from a user. This verb is paired with `Show`. | `Block` | +| [`Join`][14] (`j`) | Combines resources into one resource. For example, the `Join-Path` cmdlet combines a path with one of its child paths to create a single path. This verb is paired with `Split`. | `Combine`, `Unite`, `Connect`, `Associate` | +| [`Lock`][15] (`lk`) | Secures a resource. This verb is paired with `Unlock`. | `Restrict`, `Secure` | +| [`Move`][16] (`m`) | Moves a resource from one location to another. For example, the `Move-Item` cmdlet moves an item from one location in the data store to another location. | `Transfer`, `Name`, `Migrate` | +| [`New`][17] (`n`) | Creates a resource. (The `Set` verb can also be used when creating a resource that includes data, such as the `Set-Variable` cmdlet.) | `Create`, `Generate`, `Build`, `Make`, `Allocate` | +| [`Open`][18] (`op`) | Changes the state of a resource to make it accessible, available, or usable. This verb is paired with `Close`. | | +| [`Optimize`][19] (`om`) | Increases the effectiveness of a resource. | | +| [`Pop`][20] (`pop`) | Removes an item from the top of a stack. For example, the `Pop-Location` cmdlet changes the current location to the location that was most recently pushed onto the stack. | | +| [`Push`][21] (`pu`) | Adds an item to the top of a stack. For example, the `Push-Location` cmdlet pushes the current location onto the stack. | | +| [`Redo`][22] (`re`) | Resets a resource to the state that was undone. | | +| [`Remove`][23] (`r`) | Deletes a resource from a container. For example, the `Remove-Variable` cmdlet deletes a variable and its value. This verb is paired with `Add`. | `Clear`, `Cut`, `Dispose`, `Discard`, `Erase` | +| [`Rename`][24] (`rn`) | Changes the name of a resource. For example, the `Rename-Item` cmdlet, which is used to access stored data, changes the name of an item in the data store. | `Change` | +| [`Reset`][25] (`rs`) | Sets a resource back to its original state. | | +| [`Resize`][26] (`rz`) | Changes the size of a resource. | | +| [`Search`][27] (`sr`) | Creates a reference to a resource in a container. | `Find`, `Locate` | +| [`Select`][28] (`sc`) | Locates a resource in a container. For example, the `Select-String` cmdlet finds text in strings and files. | `Find`, `Locate` | +| [`Set`][29] (`s`) | Replaces data on an existing resource or creates a resource that contains some data. For example, the `Set-Date` cmdlet changes the system time on the local computer. (The `New` verb can also be used to create a resource.) This verb is paired with `Get`. | `Write`, `Reset`, `Assign`, `Configure`, `Update` | +| [`Show`][30] (`sh`) | Makes a resource visible to the user. This verb is paired with `Hide`. | `Display`, `Produce` | +| [`Skip`][31] (`sk`) | Bypasses one or more resources or points in a sequence. | `Bypass`, `Jump` | +| [`Split`][32] (`sl`) | Separates parts of a resource. For example, the `Split-Path` cmdlet returns different parts of a path. This verb is paired with `Join`. | `Separate` | +| [`Step`][33] (`st`) | Moves to the next point or resource in a sequence. | | +| [`Switch`][34] (`sw`) | Specifies an action that alternates between two resources, such as to change between two locations, responsibilities, or states. | | +| [`Undo`][35] (`un`) | Sets a resource to its previous state. | | +| [`Unlock`][36] (`uk`) | Releases a resource that was locked. This verb is paired with `Lock`. | `Release`, `Unrestrict`, `Unsecure` | +| [`Watch`][37] (`wc`) | Continually inspects or monitors a resource for changes. | | ## Communications Verbs PowerShell uses the [System.Management.Automation.VerbsCommunications][38] class to define actions that apply to communications. The following table lists most of the defined verbs. -| Verb (alias) | Action | Synonyms to avoid | -| ------------------------- | ----------------------------------------------------------------------------------------- | ------------------------- | -| [`Connect`][39] (`cc`) | Creates a link between a source and a destination. This verb is paired with `Disconnect`. | Join, Telnet, Login | -| [`Disconnect`][40] (`dc`) | Breaks the link between a source and a destination. This verb is paired with `Connect`. | Break, Logoff | -| [`Read`][41] (`rd`) | Acquires information from a source. This verb is paired with `Write`. | Acquire, Prompt, Get | -| [`Receive`][42] (`rc`) | Accepts information sent from a source. This verb is paired with `Send`. | Read, Accept, Peek | -| [`Send`][43] (`sd`) | Delivers information to a destination. This verb is paired with `Receive`. | Put, Broadcast, Mail, Fax | -| [`Write`][44] (`wr`) | Adds information to a target. This verb is paired with `Read`. | Put, Print | +| Verb (alias) | Action | Synonyms to avoid | +| ------------------------- | ----------------------------------------------------------------------------------------- | --------------------------------- | +| [`Connect`][39] (`cc`) | Creates a link between a source and a destination. This verb is paired with `Disconnect`. | `Join`, `Telnet`, `Login` | +| [`Disconnect`][40] (`dc`) | Breaks the link between a source and a destination. This verb is paired with `Connect`. | `Break`, `Logoff` | +| [`Read`][41] (`rd`) | Acquires information from a source. This verb is paired with `Write`. | `Acquire`, `Prompt`, `Get` | +| [`Receive`][42] (`rc`) | Accepts information sent from a source. This verb is paired with `Send`. | `Read`, `Accept`, `Peek` | +| [`Send`][43] (`sd`) | Delivers information to a destination. This verb is paired with `Receive`. | `Put`, `Broadcast`, `Mail`, `Fax` | +| [`Write`][44] (`wr`) | Adds information to a target. This verb is paired with `Read`. | `Put`, `Print` | ## Data Verbs @@ -141,32 +141,32 @@ PowerShell uses the [System.Management.Automation.VerbsData][45] class to define actions that apply to data handling. The following table lists most of the defined verbs. -| Verb Name (alias) | Action | Synonyms to avoid | -| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------ | -| [`Backup`][46] (`ba`) | Stores data by replicating it. | Save, Burn, Replicate, Sync | -| [`Checkpoint`][47] (`ch`) | Creates a snapshot of the current state of the data or of its configuration. | Diff | -| [`Compare`][48] (`cr`) | Evaluates the data from one resource against the data from another resource. | Diff | -| [`Compress`][49] (`cm`) | Compacts the data of a resource. Pairs with `Expand`. | Compact | -| [`Convert`][50] (`cv`) | Changes the data from one representation to another when the cmdlet supports bidirectional conversion or when the cmdlet supports conversion between multiple data types. | Change, Resize, Resample | -| [`ConvertFrom`][51] (`cf`) | Converts one primary type of input (the cmdlet noun indicates the input) to one or more supported output types. | Export, Output, Out | -| [`ConvertTo`][52] (`ct`) | Converts from one or more types of input to a primary output type (the cmdlet noun indicates the output type). | Import, Input, In | -| [`Dismount`][53] (`dm`) | Detaches a named entity from a location. This verb is paired with `Mount`. | Unmount, Unlink | -| [`Edit`][54] (`ed`) | Modifies existing data by adding or removing content. | Change, Update, Modify | -| [`Expand`][55] (`en`) | Restores the data of a resource that has been compressed to its original state. This verb is paired with `Compress`. | Explode, Uncompress | -| [`Export`][56] (`ep`) | Encapsulates the primary input into a persistent data store, such as a file, or into an interchange format. This verb is paired with `Import`. | Extract, Backup | -| [`Group`][57] (`gp`) | Arranges or associates one or more resources | | -| [`Import`][58] (`ip`) | Creates a resource from data that's stored in a persistent data store (such as a file) or in an interchange format. For example, the `Import-Csv` cmdlet imports data from a comma-separated value (`CSV`) file to objects that can be used by other cmdlets. This verb is paired with `Export`. | BulkLoad, Load | -| [`Initialize`][59] (`in`) | Prepares a resource for use, and sets it to a default state. | Erase, Init, Renew, Rebuild, Reinitialize, Setup | -| [`Limit`][60] (`l`) | Applies constraints to a resource. | Quota | -| [`Merge`][61] (`mg`) | Creates a single resource from multiple resources. | Combine, Join | -| [`Mount`][62] (`mt`) | Attaches a named entity to a location. This verb is paired with `Dismount`. | Connect | -| [`Out`][63] (`o`) | Sends data out of the environment. For example, the `Out-Printer` cmdlet sends data to a printer. | | -| [`Publish`][64] (`pb`) | Makes a resource available to others. This verb is paired with `Unpublish`. | Deploy, Release, Install | -| [`Restore`][65] (`rr`) | Sets a resource to a predefined state, such as a state set by `Checkpoint`. For example, the `Restore-Computer` cmdlet starts a system restore on the local computer. | Repair, Return, Undo, Fix | -| [`Save`][66] (`sv`) | Preserves data to avoid loss. | | -| [`Sync`][67] (`sy`) | Assures that two or more resources are in the same state. | Replicate, Coerce, Match | -| [`Unpublish`][68] (`ub`) | Makes a resource unavailable to others. This verb is paired with `Publish`. | Uninstall, Revert, Hide | -| [`Update`][69] (`ud`) | Brings a resource up-to-date to maintain its state, accuracy, conformance, or compliance. For example, the `Update-FormatData` cmdlet updates and adds formatting files to the current PowerShell console. | Refresh, Renew, Recalculate, Re-index | +| Verb Name (alias) | Action | Synonyms to avoid | +| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------ | +| [`Backup`][46] (`ba`) | Stores data by replicating it. | `Save`, `Burn`, `Replicate`, `Sync` | +| [`Checkpoint`][47] (`ch`) | Creates a snapshot of the current state of the data or of its configuration. | `Diff` | +| [`Compare`][48] (`cr`) | Evaluates the data from one resource against the data from another resource. | `Diff` | +| [`Compress`][49] (`cm`) | Compacts the data of a resource. Pairs with `Expand`. | `Compact` | +| [`Convert`][50] (`cv`) | Changes the data from one representation to another when the cmdlet supports bidirectional conversion or when the cmdlet supports conversion between multiple data types. | `Change`, `Resize`, `Resample` | +| [`ConvertFrom`][51] (`cf`) | Converts one primary type of input (the cmdlet noun indicates the input) to one or more supported output types. | `Export`, `Output`, `Out` | +| [`ConvertTo`][52] (`ct`) | Converts from one or more types of input to a primary output type (the cmdlet noun indicates the output type). | `Import`, `Input`, `In` | +| [`Dismount`][53] (`dm`) | Detaches a named entity from a location. This verb is paired with `Mount`. | `Unmount`, `Unlink` | +| [`Edit`][54] (`ed`) | Modifies existing data by adding or removing content. | `Change`, `Update`, `Modify` | +| [`Expand`][55] (`en`) | Restores the data of a resource that has been compressed to its original state. This verb is paired with `Compress`. | `Explode`, `Uncompress` | +| [`Export`][56] (`ep`) | Encapsulates the primary input into a persistent data store, such as a file, or into an interchange format. This verb is paired with `Import`. | `Extract`, `Backup` | +| [`Group`][57] (`gp`) | Arranges or associates one or more resources | | +| [`Import`][58] (`ip`) | Creates a resource from data that's stored in a persistent data store (such as a file) or in an interchange format. For example, the `Import-Csv` cmdlet imports data from a comma-separated value (`CSV`) file to objects that can be used by other cmdlets. This verb is paired with `Export`. | `BulkLoad`, `Load` | +| [`Initialize`][59] (`in`) | Prepares a resource for use, and sets it to a default state. | `Erase`, `Init`, `Renew`, `Rebuild`, `Reinitialize`, `Setup` | +| [`Limit`][60] (`l`) | Applies constraints to a resource. | `Quota` | +| [`Merge`][61] (`mg`) | Creates a single resource from multiple resources. | `Combine`, `Join` | +| [`Mount`][62] (`mt`) | Attaches a named entity to a location. This verb is paired with `Dismount`. | `Connect` | +| [`Out`][63] (`o`) | Sends data out of the environment. For example, the `Out-Printer` cmdlet sends data to a printer. | | +| [`Publish`][64] (`pb`) | Makes a resource available to others. This verb is paired with `Unpublish`. | `Deploy`, `Release`, `Install` | +| [`Restore`][65] (`rr`) | Sets a resource to a predefined state, such as a state set by `Checkpoint`. For example, the `Restore-Computer` cmdlet starts a system restore on the local computer. | `Repair`, `Return`, `Undo`, `Fix` | +| [`Save`][66] (`sv`) | Preserves data to avoid loss. | | +| [`Sync`][67] (`sy`) | Assures that two or more resources are in the same state. | `Replicate`, `Coerce`, `Match` | +| [`Unpublish`][68] (`ub`) | Makes a resource unavailable to others. This verb is paired with `Publish`. | `Uninstall`, `Revert`, `Hide` | +| [`Update`][69] (`ud`) | Brings a resource up-to-date to maintain its state, accuracy, conformance, or compliance. For example, the `Update-FormatData` cmdlet updates and adds formatting files to the current PowerShell console. | `Refresh`, `Renew`, `Recalculate`, `Re-index` | ## Diagnostic Verbs @@ -175,15 +175,15 @@ PowerShell uses the class to define actions that apply to diagnostics. The following table lists most of the defined verbs. -| Verb (alias) | Action | Synonyms to avoid | -| ---------------------- | ---------------------------------------------------------------------------------------------------------- | ---------------------------------- | -| [`Debug`][71] (`db`) | Examines a resource to diagnose operational problems. | Diagnose | -| [`Measure`][72] (`ms`) | Identifies resources that are consumed by a specified operation, or retrieves statistics about a resource. | Calculate, Determine, Analyze | -| [`Ping`][73] (`pi`) | Deprecated - Use the Test verb instead. | | -| [`Repair`][74] (`rp`) | Restores a resource to a usable condition | Fix, Restore | -| [`Resolve`][75] (`rv`) | Maps a shorthand representation of a resource to a more complete representation. | Expand, Determine | -| [`Test`][76] (`t`) | Verifies the operation or consistency of a resource. | Diagnose, Analyze, Salvage, Verify | -| [`Trace`][77] (`tr`) | Tracks the activities of a resource. | Track, Follow, Inspect, Dig | +| Verb (alias) | Action | Synonyms to avoid | +| ---------------------- | ---------------------------------------------------------------------------------------------------------- | ------------------------------------------ | +| [`Debug`][71] (`db`) | Examines a resource to diagnose operational problems. | `Diagnose` | +| [`Measure`][72] (`ms`) | Identifies resources that are consumed by a specified operation, or retrieves statistics about a resource. | `Calculate`, `Determine`, `Analyze` | +| [`Ping`][73] (`pi`) | Deprecated - Use the Test verb instead. | | +| [`Repair`][74] (`rp`) | Restores a resource to a usable condition | `Fix`, `Restore` | +| [`Resolve`][75] (`rv`) | Maps a shorthand representation of a resource to a more complete representation. | `Expand`, `Determine` | +| [`Test`][76] (`t`) | Verifies the operation or consistency of a resource. | `Diagnose`, `Analyze`, `Salvage`, `Verify` | +| [`Trace`][77] (`tr`) | Tracks the activities of a resource. | `Track`, `Follow`, `Inspect`, `Dig` | ## Lifecycle Verbs @@ -192,30 +192,30 @@ PowerShell uses the class to define actions that apply to the lifecycle of a resource. The following table lists most of the defined verbs. -| Verb (alias) | Action | Synonyms to avoid | -| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------- | -| [`Approve`][79] (`ap`) | Confirms or agrees to the status of a resource or process. | | -| [`Assert`][80] (`as`) | Affirms the state of a resource. | Certify | -| [`Build`][81] (`bd`) | Creates an artifact (usually a binary or document) out of some set of input files (usually source code or declarative documents.) This verb was added in PowerShell 6. | | -| [`Complete`][82] (`cp`) | Concludes an operation. | | -| [`Confirm`][83] (`cn`) | Acknowledges, verifies, or validates the state of a resource or process. | Acknowledge, Agree, Certify, Validate, Verify | -| [`Deny`][84] (`dn`) | Refuses, objects, blocks, or opposes the state of a resource or process. | Block, Object, Refuse, Reject | -| [`Deploy`][85] (`dp`) | Sends an application, website, or solution to a remote target[s] in such a way that a consumer of that solution can access it after deployment is complete. This verb was added in PowerShell 6. | | -| [`Disable`][86] (`d`) | Configures a resource to an unavailable or inactive state. For example, the `Disable-PSBreakpoint` cmdlet makes a breakpoint inactive. This verb is paired with `Enable`. | Halt, Hide | -| [`Enable`][87] (`e`) | Configures a resource to an available or active state. For example, the `Enable-PSBreakpoint` cmdlet makes a breakpoint active. This verb is paired with `Disable`. | Start, Begin | -| [`Install`][88] (`is`) | Places a resource in a location, and optionally initializes it. This verb is paired with `Uninstall`. | Setup | -| [`Invoke`][89] (`i`) | Performs an action, such as running a command or a method. | Run, Start | -| [`Register`][90] (`rg`) | Creates an entry for a resource in a repository such as a database. This verb is paired with `Unregister`. | | -| [`Request`][91] (`rq`) | Asks for a resource or asks for permissions. | | -| [`Restart`][92] (`rt`) | Stops an operation and then starts it again. For example, the `Restart-Service` cmdlet stops and then starts a service. | Recycle | -| [`Resume`][93] (`ru`) | Starts an operation that has been suspended. For example, the `Resume-Service` cmdlet starts a service that has been suspended. This verb is paired with `Suspend`. | | -| [`Start`][94] (`sa`) | Initiates an operation. For example, the `Start-Service` cmdlet starts a service. This verb is paired with `Stop`. | Launch, Initiate, Boot | -| [`Stop`][95] (`sp`) | Discontinues an activity. This verb is paired with `Start`. | End, Kill, Terminate, Cancel | -| [`Submit`][96] (`sb`) | Presents a resource for approval. | Post | -| [`Suspend`][97] (`ss`) | Pauses an activity. For example, the `Suspend-Service` cmdlet pauses a service. This verb is paired with `Resume`. | Pause | -| [`Uninstall`][98] (`us`) | Removes a resource from an indicated location. This verb is paired with `Install`. | | -| [`Unregister`][99] (`ur`) | Removes the entry for a resource from a repository. This verb is paired with `Register`. | Remove | -| [`Wait`][100] (`w`) | Pauses an operation until a specified event occurs. For example, the `Wait-Job` cmdlet pauses operations until one or more of the background jobs are complete. | Sleep, Pause | +| Verb (alias) | Action | Synonyms to avoid | +| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------- | +| [`Approve`][79] (`ap`) | Confirms or agrees to the status of a resource or process. | | +| [`Assert`][80] (`as`) | Affirms the state of a resource. | `Certify` | +| [`Build`][81] (`bd`) | Creates an artifact (usually a binary or document) out of some set of input files (usually source code or declarative documents.) This verb was added in PowerShell 6. | | +| [`Complete`][82] (`cp`) | Concludes an operation. | | +| [`Confirm`][83] (`cn`) | Acknowledges, verifies, or validates the state of a resource or process. | `Acknowledge`, `Agree`, `Certify`, `Validate`, `Verify` | +| [`Deny`][84] (`dn`) | Refuses, objects, blocks, or opposes the state of a resource or process. | `Block`, `Object`, `Refuse`, `Reject` | +| [`Deploy`][85] (`dp`) | Sends an application, website, or solution to a remote target[s] in such a way that a consumer of that solution can access it after deployment is complete. This verb was added in PowerShell 6. | | +| [`Disable`][86] (`d`) | Configures a resource to an unavailable or inactive state. For example, the `Disable-PSBreakpoint` cmdlet makes a breakpoint inactive. This verb is paired with `Enable`. | `Halt`, `Hide` | +| [`Enable`][87] (`e`) | Configures a resource to an available or active state. For example, the `Enable-PSBreakpoint` cmdlet makes a breakpoint active. This verb is paired with `Disable`. | `Start`, `Begin` | +| [`Install`][88] (`is`) | Places a resource in a location, and optionally initializes it. This verb is paired with `Uninstall`. | `Setup` | +| [`Invoke`][89] (`i`) | Performs an action, such as running a command or a method. | `Run`, `Start` | +| [`Register`][90] (`rg`) | Creates an entry for a resource in a repository such as a database. This verb is paired with `Unregister`. | | +| [`Request`][91] (`rq`) | Asks for a resource or asks for permissions. | | +| [`Restart`][92] (`rt`) | Stops an operation and then starts it again. For example, the `Restart-Service` cmdlet stops and then starts a service. | `Recycle` | +| [`Resume`][93] (`ru`) | Starts an operation that has been suspended. For example, the `Resume-Service` cmdlet starts a service that has been suspended. This verb is paired with `Suspend`. | | +| [`Start`][94] (`sa`) | Initiates an operation. For example, the `Start-Service` cmdlet starts a service. This verb is paired with `Stop`. | `Launch`, `Initiate`, `Boot` | +| [`Stop`][95] (`sp`) | Discontinues an activity. This verb is paired with `Start`. | `End`, `Kill`, `Terminate`, `Cancel` | +| [`Submit`][96] (`sb`) | Presents a resource for approval. | `Post` | +| [`Suspend`][97] (`ss`) | Pauses an activity. For example, the `Suspend-Service` cmdlet pauses a service. This verb is paired with `Resume`. | `Pause` | +| [`Uninstall`][98] (`us`) | Removes a resource from an indicated location. This verb is paired with `Install`. | | +| [`Unregister`][99] (`ur`) | Removes the entry for a resource from a repository. This verb is paired with `Register`. | `Remove` | +| [`Wait`][100] (`w`) | Pauses an operation until a specified event occurs. For example, the `Wait-Job` cmdlet pauses operations until one or more of the background jobs are complete. | `Sleep`, `Pause` | ## Security Verbs @@ -223,14 +223,14 @@ PowerShell uses the [System.Management.Automation.VerbsSecurity][103] class to define actions that apply to security. The following table lists most of the defined verbs. -| Verb (alias) | Action | Synonyms to avoid | -| ------------------------- | ------------------------------------------------------------------------------------------------------------------------- | ------------------------ | -| [`Block`][104] (`bl`) | Restricts access to a resource. This verb is paired with `Unblock`. | Prevent, Limit, Deny | -| [`Grant`][105] (`gr`) | Allows access to a resource. This verb is paired with `Revoke`. | Allow, Enable | -| [`Protect`][106] (`pt`) | Safeguards a resource from attack or loss. This verb is paired with `Unprotect`. | Encrypt, Safeguard, Seal | -| [`Revoke`][107] (`rk`) | Specifies an action that doesn't allow access to a resource. This verb is paired with `Grant`. | Remove, Disable | -| [`Unblock`][108] (`ul`) | Removes restrictions to a resource. This verb is paired with `Block`. | Clear, Allow | -| [`Unprotect`][109] (`up`) | Removes safeguards from a resource that were added to prevent it from attack or loss. This verb is paired with `Protect`. | Decrypt, Unseal | +| Verb (alias) | Action | Synonyms to avoid | +| ------------------------- | ------------------------------------------------------------------------------------------------------------------------- | ------------------------------ | +| [`Block`][104] (`bl`) | Restricts access to a resource. This verb is paired with `Unblock`. | `Prevent`, `Limit`, `Deny` | +| [`Grant`][105] (`gr`) | Allows access to a resource. This verb is paired with `Revoke`. | `Allow`, `Enable` | +| [`Protect`][106] (`pt`) | Safeguards a resource from attack or loss. This verb is paired with `Unprotect`. | `Encrypt`, `Safeguard`, `Seal` | +| [`Revoke`][107] (`rk`) | Specifies an action that doesn't allow access to a resource. This verb is paired with `Grant`. | `Remove`, `Disable` | +| [`Unblock`][108] (`ul`) | Removes restrictions to a resource. This verb is paired with `Block`. | `Clear`, `Allow` | +| [`Unprotect`][109] (`up`) | Removes safeguards from a resource that were added to prevent it from attack or loss. This verb is paired with `Protect`. | `Decrypt`, `Unseal` | ## Other Verbs From 9887d5a1ace363d9c88524703a12d6ee6d0c8192 Mon Sep 17 00:00:00 2001 From: Sean Wheeler Date: Tue, 31 Mar 2026 08:53:11 -0500 Subject: [PATCH 2/3] Update install script disclaimer (#12909) * Update install script disclaimer * Update reference/docs-conceptual/install/install-debian.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- .../docs-conceptual/install/install-debian.md | 26 ++++++++++--------- .../docs-conceptual/install/install-rhel.md | 6 +++-- .../docs-conceptual/install/install-ubuntu.md | 6 +++-- 3 files changed, 22 insertions(+), 16 deletions(-) diff --git a/reference/docs-conceptual/install/install-debian.md b/reference/docs-conceptual/install/install-debian.md index f87f5b2d67d2..d5608f992354 100644 --- a/reference/docs-conceptual/install/install-debian.md +++ b/reference/docs-conceptual/install/install-debian.md @@ -1,36 +1,37 @@ --- description: How to install PowerShell on Debian Linux -ms.date: 03/18/2026 +ms.date: 03/31/2026 title: Install PowerShell 7 on Debian --- # Install PowerShell 7 on Debian There are multiple package versions of PowerShell 7 that can be installed. This article focuses on installing the latest stable release package. For more information about the package versions, see -the [PowerShell Support Lifecycle][05] article. +the [PowerShell Support Lifecycle][06] article. Newer versions of PowerShell 7 replace existing previous versions of PowerShell 7. Preview versions of PowerShell can be installed side-by-side with other versions of PowerShell. Newer preview versions replace existing previous preview versions. If you need to run PowerShell 7.5 side-by-side -with a previous version, reinstall the previous version using the [binary archive][04] method. +with a previous version, reinstall the previous version using the [binary archive][05] method. ## Choose an installation method On Debian Linux, you can install PowerShell using the universal `.deb` package from the Microsoft -package repository or by downloading a file from the GitHub [releases][01] page. +package repository or by downloading a file from the GitHub [releases][02] page. ### Install PowerShell 7 from the Package Repository Microsoft builds and supports a variety of software products for Linux systems and makes them available via Linux packaging clients (apt, dnf, yum, etc). These Linux software packages are hosted -on the _Linux package repository for Microsoft products_, [https://packages.microsoft.com][02], also +on the _Linux package repository for Microsoft products_, [https://packages.microsoft.com][03], also known as _PMC_. Installing PowerShell from PMC is the preferred method of installation. > [!NOTE] > This script only works for supported versions of Debian that have a package published to the -> Microsoft package repository. +> Microsoft package repository. For other supported versions of Debian, use the +> [manual installation method][01]. ```sh #!/bin/bash @@ -131,7 +132,7 @@ run `pwsh-preview`. The profiles respect PowerShell's per-host configuration, so the default host-specific profiles exists at `Microsoft.PowerShell_profile.ps1` in the same locations. -PowerShell respects the [XDG Base Directory Specification][03] on Linux. +PowerShell respects the [XDG Base Directory Specification][04] on Linux. ## Uninstall PowerShell 7 @@ -150,8 +151,9 @@ installation available from other third-party sources. While those tools and met Microsoft can't support those methods. -[01]: https://github.com/PowerShell/PowerShell/releases -[02]: https://packages.microsoft.com -[03]: https://specifications.freedesktop.org/basedir/latest/ -[04]: install-other-linux.md#binary-archives -[05]: PowerShell-Support-Lifecycle.md +[01]: #manually-download-and-install-powershell-7 +[02]: https://github.com/PowerShell/PowerShell/releases +[03]: https://packages.microsoft.com +[04]: https://specifications.freedesktop.org/basedir/latest/ +[05]: install-other-linux.md#binary-archives +[06]: PowerShell-Support-Lifecycle.md diff --git a/reference/docs-conceptual/install/install-rhel.md b/reference/docs-conceptual/install/install-rhel.md index df09b9ea53f6..a6311f334dab 100644 --- a/reference/docs-conceptual/install/install-rhel.md +++ b/reference/docs-conceptual/install/install-rhel.md @@ -1,6 +1,6 @@ --- description: Information about installing PowerShell on Red Hat Enterprise Linux (RHEL) -ms.date: 03/18/2026 +ms.date: 03/31/2026 title: Install PowerShell 7 on Red Hat Enterprise Linux (RHEL) --- # Install PowerShell 7 on Red Hat Enterprise Linux (RHEL) @@ -29,7 +29,8 @@ Installing PowerShell from PMC is the preferred method of installation. > [!NOTE] > This script only works for supported versions of RHEL that have a package published to the -> Microsoft package repository. +> Microsoft package repository. For other supported versions of RHEL, use the +> [manual installation method][04]. ```sh #!/bin/bash @@ -122,3 +123,4 @@ can't support those methods. [01]: https://packages.microsoft.com [02]: https://specifications.freedesktop.org/basedir/latest/ [03]: PowerShell-Support-Lifecycle.md +[04]: #manually-download-and-install-powershell-7 diff --git a/reference/docs-conceptual/install/install-ubuntu.md b/reference/docs-conceptual/install/install-ubuntu.md index 124bc1f62671..f58be10517f0 100644 --- a/reference/docs-conceptual/install/install-ubuntu.md +++ b/reference/docs-conceptual/install/install-ubuntu.md @@ -1,6 +1,6 @@ --- description: Information about installing PowerShell on Ubuntu -ms.date: 03/12/2026 +ms.date: 03/31/2026 title: Install PowerShell 7 on Ubuntu --- # Install PowerShell 7 on Ubuntu @@ -30,7 +30,8 @@ Installing PowerShell from PMC is the preferred method of installation. > [!NOTE] > This script only works for supported versions of Ubuntu that have a package published to the -> Microsoft package repository. +> Microsoft package repository. For other versions of Ubuntu, use the +> [manual installation method][08]. ```sh #!/bin/bash @@ -172,3 +173,4 @@ Microsoft can't support those methods. [05]: https://specifications.freedesktop.org/basedir/latest/ [06]: install-other-linux.md#binary-archives [07]: PowerShell-Support-Lifecycle.md +[08]: #manually-download-and-install-powershell-7 From 7540ad4e89bb113cabbb660640d95826751cb36a Mon Sep 17 00:00:00 2001 From: Sean Wheeler Date: Tue, 31 Mar 2026 09:30:13 -0500 Subject: [PATCH 3/3] Rename and update the linux overview page (#12910) --- redir/.openpublishing.redirection.json | 9 +++++++-- .../install/install-powershell.yml | 6 ++++-- ...-powershell-on-linux.md => linux-overview.md} | 16 +++++++--------- reference/docs-conceptual/toc.yml | 2 +- 4 files changed, 19 insertions(+), 14 deletions(-) rename reference/docs-conceptual/install/{install-powershell-on-linux.md => linux-overview.md} (87%) diff --git a/redir/.openpublishing.redirection.json b/redir/.openpublishing.redirection.json index d65a1278b43e..8ea6b8ea1434 100644 --- a/redir/.openpublishing.redirection.json +++ b/redir/.openpublishing.redirection.json @@ -177,12 +177,17 @@ }, { "redirect_document_id": false, - "redirect_url": "/powershell/scripting/install/install-powershell-on-linux", + "redirect_url": "/powershell/scripting/install/linux-overview", + "source_path": "../reference/docs-conceptual/install/install-powershell-on-linux.md" + }, + { + "redirect_document_id": false, + "redirect_url": "/powershell/scripting/install/linux-overview", "source_path": "../reference/docs-conceptual/install/Installing-PowerShell-Core-on-Linux.md" }, { "redirect_document_id": false, - "redirect_url": "/powershell/scripting/install/install-powershell-on-linux", + "redirect_url": "/powershell/scripting/install/linux-overview", "source_path": "../reference/docs-conceptual/install/Installing-PowerShell-on-Linux.md" }, { diff --git a/reference/docs-conceptual/install/install-powershell.yml b/reference/docs-conceptual/install/install-powershell.yml index dd3ebfa5ca87..cff6f6f508cf 100644 --- a/reference/docs-conceptual/install/install-powershell.yml +++ b/reference/docs-conceptual/install/install-powershell.yml @@ -34,6 +34,8 @@ landingContent: url: install-powershell-on-macos.md - text: Supported macOS releases url: install-powershell-on-macos.md#supported-versions-of-macos + - text: Alternate install methods + url: alternate-install-methods.md # Card - title: Linux @@ -41,7 +43,7 @@ landingContent: - linkListType: overview links: - text: Linux overview - url: install-powershell-on-linux.md + url: linux-overview.md - text: Alpine url: install-alpine.md - text: Debian @@ -57,7 +59,7 @@ landingContent: - linkListType: get-started links: - text: Alternate install methods - url: install-other-linux.md + url: alternate-install-methods.md - text: Community supported Linux url: community-support.md - text: Using PowerShell in Docker diff --git a/reference/docs-conceptual/install/install-powershell-on-linux.md b/reference/docs-conceptual/install/linux-overview.md similarity index 87% rename from reference/docs-conceptual/install/install-powershell-on-linux.md rename to reference/docs-conceptual/install/linux-overview.md index 3966a667b541..3dc8b629d2d8 100644 --- a/reference/docs-conceptual/install/install-powershell-on-linux.md +++ b/reference/docs-conceptual/install/linux-overview.md @@ -1,17 +1,15 @@ --- description: This article lists the Linux distributions and package managers that are supported for installing PowerShell. -ms.date: 03/12/2026 -title: Install PowerShell on Linux +ms.date: 03/31/2026 +title: PowerShell support for Linux --- -# Install PowerShell on Linux +# PowerShell support for Linux PowerShell can be installed on several different Linux distributions. Most Linux platforms and distributions have a major release each year, and provide a package manager that's used to install PowerShell. PowerShell can be installed on some distributions of Linux that aren't supported by Microsoft. In those cases, you may find support from the community for PowerShell on those -platforms. - -For more information, see the [PowerShell Support Lifecycle][01] documentation. +platforms. For more information, see the [PowerShell Support Lifecycle][01] documentation. This article lists the supported Linux distributions and package managers. All PowerShell releases remain supported until either the version of PowerShell or the version of the Linux distribution @@ -52,7 +50,7 @@ For more information, see [Install PowerShell on Ubuntu][07]. ## Community supported distributions PowerShell can be installed on many distributions of Linux that aren't supported by Microsoft. In -those cases, you may find support from the community for PowerShell on those platforms +those cases, you may find support from the community for PowerShell on those platforms. To be supported by Microsoft, the Linux distribution must meet the following criteria: @@ -65,10 +63,10 @@ For more information, see [Community support for PowerShell on Linux][02]. ## Alternate installation methods -There are three other ways to install PowerShell on Linux, including Linux distributions that aren't +There are other ways to install PowerShell on Linux, including Linux distributions that aren't officially supported. You can try to install PowerShell using the PowerShell Snap Package. You can also try deploying PowerShell binaries directly using the Linux `tar.gz` package. For more -information, see [Alternate ways to install PowerShell on Linux][05]. +information, see [Alternate ways to install PowerShell][05]. [01]: ../PowerShell-Support-Lifecycle.md diff --git a/reference/docs-conceptual/toc.yml b/reference/docs-conceptual/toc.yml index b59cdb698b80..183726c559ee 100644 --- a/reference/docs-conceptual/toc.yml +++ b/reference/docs-conceptual/toc.yml @@ -23,7 +23,7 @@ items: - name: Install PowerShell 7 on Linux items: - name: Overview - href: install/install-powershell-on-linux.md + href: install/linux-overview.md - name: Install on Alpine href: install/install-alpine.md - name: Install on Debian