Invoke-Command
Runs a script block on remote computers and returns the results.
Syntax
Short syntax for this command. The parameter table below may list more parameters than this short line shows.
Syntax
Invoke-Command -ComputerName <Computer> -ScriptBlock { <code> }Parameters
Note: the short syntax above does not show every parameter in this table. The rows marked No in the last column are still listed here with their descriptions. Check Get-Help for the full syntax before you use one of them.
| Parameter | What it does | In short syntax |
|---|---|---|
-ComputerName | target computers | Yes |
-ScriptBlock | the code to run remotely | Yes |
-Credential | credentials to use | No |
Examples
Runs Get-Service on srv1.
Example 1
Invoke-Command -ComputerName srv1 -ScriptBlock { Get-Service -Name Spooler }Illustrative output: see the lesson example for this command.
Common mistakes
General cautions for this command.
- Guessing parameters instead of checking Get-Help for this command.
- Running a changing form of this command before previewing its effect.
Related commands
Commands that share this command's lesson come first, then commands that share its verb. Every link goes to a real command page.