The Project | About Us | Contribute | Donations | License

HOME

Introduction

Invoke-Command is a powerful cmdlet in PowerShell that allows you to run commands on local and remote computers. This is particularly useful for managing multiple systems simultaneously, automating tasks, and performing administrative functions across a network.

Key Concepts

Cmdlet: A lightweight command used in the PowerShell environment.
Remote Session: A connection to a remote computer that allows you to run commands as if you were logged in locally.
ScriptBlock: A block of code or a script that you want to execute.

Basic Syntax

The basic syntax for Invoke-Command is as follows:

Invoke-Command -ComputerName <ComputerName> -ScriptBlock { <Script> }

-ComputerName: Specifies the remote computer(s) on which the command should be executed.
-ScriptBlock: Contains the commands or script to be executed.

Examples

Example 1: Running a Command on a Remote Computer

Invoke-Command -ComputerName "Server01" -ScriptBlock { Get-Process }

This command retrieves the list of processes running on the remote computer "Server01".

Example 2: Running a ScriptBlock on Multiple Computers

$computers = "Server01", "Server02", "Server03"
Invoke-Command -ComputerName $computers -ScriptBlock { Get-Service }

This command retrieves the list of services running on multiple remote computers specified in the $computers array.

Example 3: Using Credentials for Remote Execution

$cred = Get-Credential
Invoke-Command -ComputerName "Server01" -Credential $cred -ScriptBlock { Get-EventLog -LogName System }

This command retrieves the system event log from "Server01" using the credentials provided by the user.

Example 4: Running a Local Command

Invoke-Command -ScriptBlock { Get-ChildItem "C:\Windows" }

This command lists the contents of the "C:\Windows" directory on the local computer.

Practical Exercise

Exercise 1: Retrieve Disk Space Information

Objective: Use Invoke-Command to retrieve disk space information from multiple remote computers.

Steps:

Create an array of computer names.
Use Invoke-Command to run a script block that retrieves disk space information.

Solution:

$computers = "Server01", "Server02", "Server03"
Invoke-Command -ComputerName $computers -ScriptBlock {
    Get-PSDrive -PSProvider FileSystem | Select-Object Name, @{Name="FreeSpace(GB)";Expression={[math]::round($_.Free/1GB,2)}}
}

Exercise 2: Restart a Service on a Remote Computer

Objective: Use Invoke-Command to restart the "Spooler" service on a remote computer.

Steps:

Specify the remote computer name.
Use Invoke-Command to run a script block that restarts the "Spooler" service.

Solution:

Invoke-Command -ComputerName "Server01" -ScriptBlock {
    Restart-Service -Name "Spooler"
}

Common Mistakes and Tips

Incorrect Computer Name: Ensure that the computer names are correct and reachable.
Permissions: Make sure you have the necessary permissions to run commands on the remote computer.
Firewall Settings: Ensure that the firewall settings on the remote computer allow remote management.
Credential Management: Use Get-Credential to securely manage credentials for remote sessions.

Conclusion

Invoke-Command is an essential cmdlet for remote management and automation in PowerShell. By understanding its syntax and usage, you can efficiently manage multiple systems and perform complex administrative tasks. Practice using Invoke-Command with different scenarios to become proficient in remote command execution.

Using Invoke-Command

Introduction

Key Concepts

Basic Syntax

Examples

Example 1: Running a Command on a Remote Computer

Example 2: Running a ScriptBlock on Multiple Computers

Example 3: Using Credentials for Remote Execution

Example 4: Running a Local Command

Practical Exercise

Exercise 1: Retrieve Disk Space Information

Exercise 2: Restart a Service on a Remote Computer

Common Mistakes and Tips

Conclusion

PowerShell Course

Module 1: Introduction to PowerShell

Module 2: Basic Scripting

Module 3: Working with Objects

Module 4: Advanced Scripting Techniques

Module 5: Automation and Task Scheduling

Module 6: PowerShell Remoting

Module 7: Advanced PowerShell Features

Module 8: PowerShell and DevOps

Module 9: Best Practices and Advanced Tips