Contact Info

Crumbtrail » Administration » Powershell » Powershell 3.0 » Start-Job

Start-Job - Powershell 3.0 CmdLet

ActiveXperts Network Monitor ships with integrated Powershell scripts to monitor complex network. The scripts run out of the box
Download the ActiveXperts Network Monitor FREE version now »


Short description
Starts a Windows PowerShell background job.

Start-Job [-ScriptBlock] <ScriptBlock> [[-InitializationScript] <ScriptBlock>] [-ArgumentList <Object[]>] [-Authenticat
ion <AuthenticationMechanism>] [-Credential <PSCredential>] [-InputObject <PSObject>] [-Name <String>] [-PSVersion <Ver
sion>] [-RunAs32] [<CommonParameters>]
Start-Job [-FilePath] <String> [[-InitializationScript] <ScriptBlock>] [-ArgumentList <Object[]>] [-Authentication <Aut
henticationMechanism>] [-Credential <PSCredential>] [-InputObject <PSObject>] [-Name <String>] [-PSVersion <Version>] [
-RunAs32] [<CommonParameters>]
Start-Job [[-InitializationScript] <ScriptBlock>] [-ArgumentList <Object[]>] [-Authentication <AuthenticationMechanism>
] [-Credential <PSCredential>] [-InputObject <PSObject>] [-Name <String>] [-PSVersion <Version>] [-RunAs32] -LiteralPat
h <String> [<CommonParameters>]
Start-Job [-DefinitionName] <String> [[-DefinitionPath] <String>] [[-Type] <String>] [<CommonParameters>]

The Start-Job cmdlet starts a Windows PowerShell background job on the local computer.

A Windows PowerShell background job runs a command "in the background" without interacting with the current session. Wh
en you start a background job, a job object is returned immediately, even if the job takes an extended time to complete
. You can continue to work in the session without interruption while the job runs.

The job object contains useful information about the job, but it does not contain the job results. When the job complet
es, use the Receive-Job cmdlet to get the results of the job. For more information about background jobs, see about_Job

To run a background job on a remote computer, use the AsJob parameter that is available on many cmdlets, or use the Inv
oke-Command cmdlet to run a Start-Job command on the remote computer.  For more information, see about_Remote_Jobs.

Beginning in Windows PowerShell 3.0, Start-Job can start instances of custom job types, such as scheduled jobs. For inf
ormation about using Start-Job to start jobs with custom types, see the help topics for the job type feature.