Invoke-Command in PowerShell - Mini Project: Build & Apply

Using Invoke-Command to Run Remote Commands

📖 Scenario: You are managing multiple computers in your office network. You want to run a simple command on a remote computer to check its system information without logging in physically.

🎯 Goal: Learn how to use Invoke-Command in PowerShell to run a command on a remote computer and get the output.

📋 What You'll Learn

Create a variable with the remote computer name

Create a script block with the command to run remotely

Use Invoke-Command to run the script block on the remote computer

Display the output of the remote command

💡 Why This Matters

🌍 Real World

System administrators often need to run commands on remote computers to gather information or perform tasks without physically accessing each machine.

💼 Career

Knowing how to use Invoke-Command is essential for IT professionals managing Windows networks and automating remote tasks.

1

Set the remote computer name

Create a variable called $computerName and set it to the string "Server01".

PowerShell

# Create a variable called $computerName and set it to "Server01"
# Your code here

Hint

Use = to assign the string "Server01" to the variable $computerName.

2

Create the script block with the command

Create a variable called $scriptBlock and assign it a script block that runs the command Get-ComputerInfo.

PowerShell

$computerName = "Server01"
# Create a variable called $scriptBlock with a script block running Get-ComputerInfo
# Your code here

Hint

Use curly braces { } to create a script block and put Get-ComputerInfo inside.

3

Run Invoke-Command on the remote computer

Use Invoke-Command with the -ComputerName parameter set to $computerName and the -ScriptBlock parameter set to $scriptBlock. Store the result in a variable called $result.

PowerShell

$computerName = "Server01"
$scriptBlock = { Get-ComputerInfo }
# Use Invoke-Command with -ComputerName $computerName and -ScriptBlock $scriptBlock, store output in $result
# Your code here

Hint

Use Invoke-Command with the parameters exactly as shown and assign the output to $result.

4

Display the output of the remote command

Print the contents of the variable $result to show the remote computer information.

PowerShell

$computerName = "Server01"
$scriptBlock = { Get-ComputerInfo }
$result = Invoke-Command -ComputerName $computerName -ScriptBlock $scriptBlock
# Print the $result variable
# Your code here

Hint

Simply type $result on a line by itself to display the output.

Practice

1. What is the primary purpose of the Invoke-Command cmdlet in PowerShell?

easy

A. To display system event logs

B. To run commands on remote or local computers

C. To edit files locally

D. To create new user accounts

Solution

1. Step 1: Understand the cmdlet's function

   Invoke-Command is designed to run commands remotely or locally on one or more computers.

2. Step 2: Compare options

   Options A, B, and C describe unrelated tasks like user management, file editing, or log viewing, which are not the main purpose of Invoke-Command.

3. Final Answer:

   To run commands on remote or local computers -> Option B

4. Quick Check:

   Invoke-Command runs commands remotely or locally [OK]

Hint: Invoke-Command runs scripts on other computers [OK]

Common Mistakes:

• Confusing Invoke-Command with file editing cmdlets
• Thinking it only works locally
• Assuming it manages user accounts

2. Which of the following is the correct syntax to run a script block on a remote computer named 'Server01' using Invoke-Command?

easy

A. Invoke-Command -ComputerName Server01 -ScriptBlock { Get-Process }

B. Invoke-Command Server01 -ScriptBlock Get-Process

C. Invoke-Command -ScriptBlock Server01 { Get-Process }

D. Invoke-Command -ComputerName { Server01 } -ScriptBlock Get-Process

Solution

1. Step 1: Identify correct parameter usage

   The -ComputerName parameter expects the remote computer's name, and -ScriptBlock expects a script block enclosed in braces.

2. Step 2: Validate syntax correctness

   Invoke-Command -ComputerName Server01 -ScriptBlock { Get-Process } correctly uses -ComputerName Server01 and -ScriptBlock { Get-Process }. Other options misuse parameters or omit braces.

3. Final Answer:

   Invoke-Command -ComputerName Server01 -ScriptBlock { Get-Process } -> Option A

4. Quick Check:

   Correct syntax uses -ComputerName and script block braces [OK]

Hint: Use braces {} for script block and -ComputerName for target [OK]

Common Mistakes:

• Omitting braces around script block
• Placing computer name inside braces
• Using script block without braces

3. What will be the output of this command?

Invoke-Command -ComputerName localhost -ScriptBlock { 2 + 3 }

medium

A. Error: Cannot find computer

B. 2 + 3

C. 5

D. null

Solution

1. Step 1: Understand command execution on localhost

   The command runs the script block { 2 + 3 } on the local computer named 'localhost'.

2. Step 2: Calculate the script block result

   The expression 2 + 3 evaluates to 5, so the output will be 5.

3. Final Answer:

   5 -> Option C

4. Quick Check:

   2 + 3 = 5 [OK]

Hint: Script block runs and returns result, not expression text [OK]

Common Mistakes:

• Expecting the expression as string output
• Assuming remote computer error on localhost
• Thinking output is null

4. You run this command:

Invoke-Command -ComputerName Server01 -ScriptBlock { Get-Service }

But get an error: "Access is denied." What is the most likely cause?

medium

A. The script block syntax is incorrect

B. Get-Service cmdlet does not exist

C. Server01 is offline

D. You do not have permission to run commands on Server01

Solution

1. Step 1: Analyze the error message

   "Access is denied" indicates a permissions issue, not syntax or cmdlet existence.

2. Step 2: Match error to cause

   Permission problems usually mean the user lacks rights to run remote commands on Server01.

3. Final Answer:

   You do not have permission to run commands on Server01 -> Option D

4. Quick Check:

   Access denied = permission issue [OK]

Hint: Access denied usually means permission problem [OK]

Common Mistakes:

• Assuming syntax error causes access denied
• Thinking server offline causes access denied
• Believing cmdlet absence causes access denied

5. You want to run a command on multiple remote computers: Server01, Server02, and Server03. Which command correctly runs Get-EventLog -LogName System -Newest 5 on all three at once?

hard

A. Invoke-Command -ComputerName @('Server01', 'Server02', 'Server03') -ScriptBlock { Get-EventLog -LogName System -Newest 5 }

B. Invoke-Command -ComputerName 'Server01 Server02 Server03' -ScriptBlock { Get-EventLog -LogName System -Newest 5 }

C. Invoke-Command -ComputerName Server01 Server02 Server03 -ScriptBlock { Get-EventLog -LogName System -Newest 5 }

D. Invoke-Command -ComputerName Server01; Server02; Server03 -ScriptBlock { Get-EventLog -LogName System -Newest 5 }

Solution

1. Step 1: Understand how to specify multiple computers

   The -ComputerName parameter accepts an array of strings to target multiple computers.

2. Step 2: Evaluate options for correct array syntax

   Invoke-Command -ComputerName @('Server01', 'Server02', 'Server03') -ScriptBlock { Get-EventLog -LogName System -Newest 5 } uses an array @('Server01', 'Server02', 'Server03'), which is the correct way to pass multiple names. Invoke-Command -ComputerName Server01 Server02 Server03 -ScriptBlock { Get-EventLog -LogName System -Newest 5 } uses space-separated names without commas or array syntax, which is invalid. Invoke-Command -ComputerName 'Server01 Server02 Server03' -ScriptBlock { Get-EventLog -LogName System -Newest 5 } passes a single string with spaces, treated as one name. Invoke-Command -ComputerName Server01; Server02; Server03 -ScriptBlock { Get-EventLog -LogName System -Newest 5 } uses semicolons, which is invalid syntax.

3. Final Answer:

   Invoke-Command -ComputerName @('Server01', 'Server02', 'Server03') -ScriptBlock { Get-EventLog -LogName System -Newest 5 } -> Option A

4. Quick Check:

   Use array syntax @() for multiple computers [OK]

Hint: Use @() array for multiple computer names [OK]

Common Mistakes:

• Using space-separated names without commas or array syntax
• Passing all names as one string
• Using semicolons to separate names