Start-Job

Start-Job [-ScriptBlock] <scriptblock> [[-InitializationScript] <scriptblock>] [-ArgumentList <Object[]>] [-Authentication {<Default> | <Basic> | <Negotiate> | <NegotiateWithImplicitCredential> | <Credssp> | <Digest> | <Kerberos>}] [-Credential <PSCredential>] [-InputObject <psobject>] [-Name <string>] [-RunAs32] [<CommonParameters>]

Start-Job [[-FilePath] <string>] [[-InitializationScript] <scriptblock>] [-ArgumentList <Object[]>] [-Authentication {<Default> | <Basic> | <Negotiate> | <NegotiateWithImplicitCredential> | <Credssp> | <Digest> | <Kerberos>}] [-Credential <PSCredential>] [-InputObject <psobject>] [-Name <string>] [-RunAs32] [<CommonParameters>]

C:\PS>start-job -scriptblock {get-process}

C:\PS> start-job -command "get-process"

Id    Name  State    HasMoreData  Location   Command
---   ----  -----    -----------  --------   -------
1     Job1  Running  True         localhost  get-process

Descripción
-----------
Este comando inicia un trabajo en segundo plano que ejecuta un comando Get-Process. El comando devuelve un objeto de trabajo con información sobre el trabajo. El símbolo del sistema se devuelve inmediatamente para poder trabajar en la sesión mientras el trabajo se ejecuta en segundo plano.

C:\PS>$jobWRM = invoke-command -computerName (get-content servers.txt) -scriptblock {get-service winrm} -jobname WinRM -throttlelimit 16 -AsJob

Descripción
-----------
Este comando utiliza el cmdlet Invoke-Command y su parámetro AsJob para iniciar un trabajo en segundo plano que ejecuta un comando "get-service winrm" en numerosos equipos. Dado que el comando se ejecuta en un servidor con un tráfico de red importante, el comando utiliza el parámetro ThrottleLimit de Invoke-Command para limitar el número de comandos simultáneos a 16. 

El comando utiliza el parámetro ComputerName para especificar los equipos en que se ejecuta el trabajo. El valor del parámetro ComputerName es un comando Get-Content que obtiene el texto en el archivo Servers.txt, un archivo de nombres de equipo en un dominio. 

El comando utiliza el parámetro ScriptBlock para especificar el comando y el parámetro JobName para especificar un nombre simple para el trabajo.

C:\PS>$j = start-job -scriptblock {get-eventlog -log system} -credential domain01\user01

C:\PS> $j | format-list -property *

HasMoreData   : True
StatusMessage :
Location      : localhost
Command       : get-eventlog -log system
JobStateInfo  : Running
Finished      : System.Threading.ManualResetEvent
InstanceId    : 2d9d775f-63e0-4d48-b4bc-c05d0e177f34
Id            : 1
Name          : Job1
ChildJobs     : {Job2}
Output        : {}
Error         : {}
Progress      : {}
Verbose       : {}
Debug         : {}
Warning       : {}
StateChanged  :

C:\PS> $j.JobStateInfo.state
Completed

C:\PS> $results = receive-job -job $j

C:\PS> $results
Index Time          Type        Source                EventID Message
----- ----          ----        ------                ------- -------
84366 Feb 18 19:20  Information Service Control M...     7036 The description...
84365 Feb 18 19:16  Information Service Control M...     7036 The description...
84364 Feb 18 19:10  Information Service Control M...     7036 The description...
...

Descripción
-----------
Estos comandos administran un trabajo en segundo plano que obtiene todos los eventos del registro del sistema en el visor de eventos. El trabajo se ejecuta en el equipo local.

El primer comando utiliza el cmdlet Start-Job para iniciar el trabajo. Utiliza el parámetro Credential para especificar la cuenta de usuario de un usuario que tiene permiso para ejecutar el trabajo en el equipo. A continuación, guarda el objeto de trabajo que Start-Job devuelve en la variable $j.

En este momento, puede reanudar la otra tarea mientras el trabajo se completa.

El segundo comando usa un operador de canalización (|) para pasar el objeto de trabajo en $j al cmdlet Format-List. El comando Format-List usa el parámetro Property con el valor * (todo) para mostrar todas las propiedades del objeto de trabajo en una lista.

El tercer comando muestra el valor de la propiedad JobStateInfo. Esta propiedad contiene el estado del trabajo.

El cuarto comando utiliza el cmdlet Receive-Job para obtener los resultados del trabajo. Almacena los resultados en la variable $results.

El último comando muestra el contenido de la variable $results.

C:\PS>start-job -filepath c:\scripts\sample.ps1

Descripción
-----------
Este comando ejecuta el script Sample.ps1 como un trabajo en segundo plano.

C:\PS>start-job -name WinRm -scriptblock {get-process winrm}

Descripción
-----------
Este comando ejecuta un trabajo en segundo plano que obtiene el proceso de WinRM en el equipo local. El comando utiliza el parámetro ScriptBlock para especificar el comando que se ejecuta en el trabajo en segundo plano. Utiliza el parámetro Name para especificar un nombre simple para el nuevo trabajo.

C:\PS>start-job -name GetMappingFiles -initializationScript {import-module MapFunctions} -scriptblock {Get-Map -name * | set-content D:\Maps.tif} -runAs32

Descripción
-----------
Este comando inicia un trabajo que recopila gran cantidad de datos y los guarda en un archivo .tif. El comando utiliza el parámetro InitializationScript para ejecutar un bloque de script que importa un módulo necesario. También utiliza el parámetro RunAs32 para ejecutar el trabajo en un proceso de 32 bits aunque el equipo tenga un sistema operativo de 64 bits.