Verb-Noun naming convention in PowerShell - Step-by-Step Execution

Concept Flow - Verb-Noun naming convention

Start: Define action

↓

Choose verb describing action

↓

Choose noun describing target

↓

Combine verb and noun with hyphen

↓

Use as function or cmdlet name

↓

Execute or call function

↓

End

This flow shows how to create a PowerShell function name by combining a verb and a noun to clearly describe what the function does.

Execution Sample

PowerShell

function Get-User {
  param($Name)
  "Getting user: $Name"
}
Get-User -Name "Alice"

Defines a function named with Verb-Noun style and calls it to show the output.

Execution Table

Step	Action	Evaluation	Result
1	Define function Get-User	Function named 'Get-User' created	Ready to call
2	Call Get-User with Name='Alice'	Parameter Name='Alice' passed	Function runs
3	Inside function: build string	"Getting user: Alice"	String returned
4	Output result	Print string	Getting user: Alice
5	End	No more commands	Script ends

💡 Function executed and script finished

Variable Tracker

Variable	Start	After Call	Final
Name	undefined	Alice	Alice

Key Moments - 3 Insights

Why do we use a hyphen between verb and noun in function names?

The hyphen clearly separates the action (verb) from the target (noun), making the function name easy to read and understand, as shown in step 1 of the execution_table.

Can the verb be anything in the function name?

No, PowerShell uses approved verbs to keep names consistent and clear. Using standard verbs like 'Get', 'Set', or 'Remove' helps others understand the function's purpose, as seen in the function name 'Get-User'.

What happens if we don't follow the Verb-Noun convention?

The function name may become confusing or unclear. Following the convention ensures scripts are easier to read and maintain, as demonstrated by the clear output in step 4.

Visual Quiz - 3 Questions

Look at the execution_table, what is the function name defined at step 1?

A GetUser

B User-Get

C Get-User

D UserGet

💡 Hint

Check the 'Action' column in row 1 of the execution_table.

At which step does the function output the string 'Getting user: Alice'?

A Step 2

B Step 4

C Step 3

D Step 5

💡 Hint

Look at the 'Result' column for the output string in the execution_table.

If we change the verb from 'Get' to 'Set' in the function name, what changes in the execution?

A The function name changes but output string stays the same

B The function name and output string both change

C Only the output string changes

D No changes occur

💡 Hint

Consider how the function name is defined and how the output string is built in the code.

Concept Snapshot

Verb-Noun naming convention in PowerShell:
- Function names combine an action verb and a target noun
- Use a hyphen to separate verb and noun (e.g., Get-User)
- Use approved verbs for clarity and consistency
- Makes scripts easier to read and maintain
- Example: function Get-User { ... }

Full Transcript

This lesson shows how to name PowerShell functions using the Verb-Noun convention. First, choose a verb that describes the action, like 'Get'. Next, pick a noun that describes the target, like 'User'. Combine them with a hyphen to form the function name, for example, 'Get-User'. This naming style helps make scripts clear and easy to understand. The example defines a function named Get-User that takes a name and returns a string showing the action. The execution table traces defining the function, calling it with a parameter, building the output string, and printing it. Variables like 'Name' change from undefined to the passed value. Key points include why the hyphen is used, the importance of approved verbs, and the clarity gained by following this convention. The quiz checks understanding of the function name, output step, and effect of changing the verb. This method helps beginners write readable and maintainable PowerShell scripts.