From 10ffe5d1f8cc6571315ce1da48d9845ea6172835 Mon Sep 17 00:00:00 2001 From: Sean Wheeler Date: Mon, 30 Mar 2026 18:41:29 -0500 Subject: [PATCH 1/2] Fix formatting to avoid over-localization --- .../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..74a6ded2e525 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`, Lo`goff | +| [`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 72c1f599f39e92320eeac96d4b1cdef1d844dd8f Mon Sep 17 00:00:00 2001 From: Sean Wheeler Date: Mon, 30 Mar 2026 18:47:54 -0500 Subject: [PATCH 2/2] Apply suggestions from code review Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- .../cmdlet/approved-verbs-for-windows-powershell-commands.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) 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 74a6ded2e525..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 @@ -129,7 +129,7 @@ that apply to communications. The following table lists most of the defined verb | 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`, Lo`goff | +| [`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` |