Start-Job

Start-Job
    [-ScriptBlock] <ScriptBlock>
    [[-InitializationScript] <ScriptBlock>]
    [-Name <String>]
    [-Credential <PSCredential>]
    [-Authentication <AuthenticationMechanism>]
    [-RunAs32]
    [-PSVersion <Version>]
    [-InputObject <PSObject>]
    [-ArgumentList <Object[]>]
    [<CommonParameters>]

Start-Job
    [-DefinitionName] <String>
    [[-DefinitionPath] <String>]
    [[-Type] <String>]
    [<CommonParameters>]

Start-Job
    [-FilePath] <String>
    [[-InitializationScript] <ScriptBlock>]
    [-Name <String>]
    [-Credential <PSCredential>]
    [-Authentication <AuthenticationMechanism>]
    [-RunAs32]
    [-PSVersion <Version>]
    [-InputObject <PSObject>]
    [-ArgumentList <Object[]>]
    [<CommonParameters>]

Start-Job
    [[-InitializationScript] <ScriptBlock>]
    -LiteralPath <String>
    [-Name <String>]
    [-Credential <PSCredential>]
    [-Authentication <AuthenticationMechanism>]
    [-RunAs32]
    [-PSVersion <Version>]
    [-InputObject <PSObject>]
    [-ArgumentList <Object[]>]
    [<CommonParameters>]

Start-Job
    [-VMGuid] <Guid[]>
    [<CommonParameters>]

Start-Job
    [-VMGuid] <Guid[]>
    [<CommonParameters>]

Start-Job
    -VMName <String[]>
    [<CommonParameters>]

Start-Job
    -VMName <String[]>
    [<CommonParameters>]

El cmdlet Start-Job inicia un trabajo en segundo plano de PowerShell en el equipo local.

Un trabajo en segundo plano de PowerShell ejecuta un comando sin interactuar con la sesión actual. Cuando se inicia un trabajo en segundo plano, se devuelve inmediatamente un objeto de trabajo, incluso aunque el trabajo tarde mucho en finalizar. Puede seguir trabajando en la sesión sin interrupciones mientras se ejecuta la tarea.

El objeto de trabajo contiene información útil sobre el trabajo, pero no contiene los resultados del trabajo. Cuando finalice el trabajo, use el cmdlet Receive-Job para obtener los resultados del trabajo. Para obtener más información sobre los trabajos en segundo plano, vea about_Jobs.

Para ejecutar un trabajo en segundo plano en un equipo remoto, use el parámetro AsJob que está disponible en muchos cmdlets o use el cmdlet Invoke-Command para ejecutar un comando Start-Job en el equipo remoto. Para obtener más información, vea about_Remote_Jobs.

A partir de PowerShell 3.0, Start-Job puede iniciar instancias de tipos de trabajo personalizados, como trabajos programados. Para obtener información sobre cómo usar Start-Job para iniciar trabajos con tipos personalizados, consulte los documentos de ayuda de la característica de tipo de trabajo.

En este ejemplo se inicia un trabajo que se ejecuta en segundo plano en el equipo local.

Start-Job -ScriptBlock {Get-Process}

Id  Name   PSJobTypeName   State     HasMoreData   Location    Command
--  ----   -------------   -----     -----------   --------    -------
1   Job1   BackgroundJob   Running   True          localhost   Get-Process

Start-Job usa el parámetro scriptBlock para ejecutar Get-Process como trabajo en segundo plano. Se muestra la información del trabajo y PowerShell regresa al indicador mientras el trabajo se ejecuta en segundo plano.

En este ejemplo se ejecuta un trabajo en varios equipos. El trabajo se almacena en una variable y se ejecuta mediante el nombre de la variable en la línea de comandos de PowerShell.

$jobWRM = Invoke-Command -ComputerName (Get-Content -Path C:\Servers.txt) -ScriptBlock {
   Get-Service -Name WinRM } -JobName WinRM -ThrottleLimit 16 -AsJob

Se crea un trabajo que usa Invoke-Command y se almacena en la variable $jobWRM. Invoke-Command usa el parámetro ComputerName para especificar los equipos en los que se ejecuta el trabajo. Get-Content obtiene los nombres de servidor del archivo C:\Servers.txt.

El parámetro ScriptBlock especifica un comando que Get-Service obtiene el servicio WinRM. El parámetro JobName especifica un nombre descriptivo para el trabajo, WinRM. El parámetro ThrottleLimit limita el número de comandos simultáneos a 16. El parámetro AsJob inicia un trabajo en segundo plano que ejecuta el comando en los servidores.

En este ejemplo se obtiene información sobre un trabajo y se muestran los resultados de un trabajo completado que se ejecutó en el equipo local.

$j = Start-Job -ScriptBlock { Get-WinEvent -Log System } -Credential Domain01\User01
$j | Select-Object -Property *

State         : Completed
HasMoreData   : True
StatusMessage :
Location      : localhost
Command       : Get-WinEvent -Log System
JobStateInfo  : Completed
Finished      : System.Threading.ManualResetEvent
InstanceId    : 27ce3fd9-40ed-488a-99e5-679cd91b9dd3
Id            : 18
Name          : Job18
ChildJobs     : {Job19}
PSBeginTime   : 8/8/2019 14:41:57
PSEndTime     : 8/8/2019 14:42:07
PSJobTypeName : BackgroundJob
Output        : {}
Error         : {}
Progress      : {}
Verbose       : {}
Debug         : {}
Warning       : {}
Information   : {}

Start-Job usa el parámetro ScriptBlock para ejecutar un comando que especifica Get-WinEvent para obtener el registro de eventos del sistema System. El parámetro Credential especifica una cuenta de usuario de dominio con permiso para ejecutar el trabajo en el equipo. El objeto de trabajo se almacena en la variable $j.

El objeto en la variable $j se envía por la canalización a Select-Object. El parámetro Property especifica un asterisco (*) para mostrar todas las propiedades del objeto de trabajo.

En este ejemplo, se ejecuta un script en el equipo local como un trabajo en segundo plano.

Start-Job -FilePath C:\Scripts\Sample.ps1

Start-Job usa el parámetro FilePath para especificar un archivo de script almacenado en el equipo local.

En este ejemplo se usa un trabajo en segundo plano para obtener un proceso especificado por nombre.

Start-Job -Name PShellJob -ScriptBlock { Get-Process -Name PowerShell }

Start-Job usa el parámetro Name para especificar un nombre de trabajo descriptivo, PShellJob. El parámetro ScriptBlock especifica Get-Process para obtener procesos con el nombre PowerShell.

En este ejemplo se inicia un trabajo que recopila una gran cantidad de datos de mapa y, a continuación, se guarda en un archivo .tif.

Start-Job -Name GetMappingFiles -InitializationScript {Import-Module MapFunctions} -ScriptBlock {
   Get-Map -Name * | Set-Content -Path D:\Maps.tif } -RunAs32

Start-Job usa el parámetro Name para especificar un nombre de trabajo amigable, GetMappingFiles. El parámetro InitializationScript ejecuta un bloque de script que importa el módulo MapFunctions. El parámetro ScriptBlock ejecuta Get-Map y Set-Content guarda los datos en la ubicación especificada por el parámetro path de. El parámetro RunAs32 ejecuta el proceso como de 32 bits, incluso en un sistema operativo de 64 bits.

En este ejemplo se usa el $input variable automática para procesar un objeto de entrada. Usa Receive-Job para ver el resultado del trabajo.

Start-Job -ScriptBlock { Get-Content $input } -InputObject "C:\Servers.txt"
Receive-Job -Name Job45 -Keep

Server01
Server02
Server03
Server04

Start-Job usa el parámetro ScriptBlock para ejecutar Get-Content con la variable automática $input. La variable $input obtiene objetos del parámetro InputObject. Receive-Job usa el parámetro Name para especificar el trabajo y genera los resultados. El parámetro Keep guarda la salida del trabajo para que pueda verse nuevamente durante la sesión de PowerShell.

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Puede usar la canalización para enviar un objeto con la propiedad Name al parámetro Name . Por ejemplo, puede canalizar un objeto FileInfo de Get-ChildItem a Start-Job.

Start-Job devuelve un objeto PSRemotingJob que representa el trabajo que inició.

Para ejecutarse en segundo plano, Start-Job se ejecuta en su propia sesión en la sesión actual. Cuando se usa el cmdlet Invoke-Command para ejecutar un comando de Start-Job en una sesión en un equipo remoto, Start-Job se ejecuta en una sesión en la sesión remota.