Start-Job

  • Referencia
Módulo:
Microsoft.PowerShell.Core

Inicia un trabajo en segundo plano de PowerShell.

Syntax

Start-Job
     [-Name <String>]
     [-ScriptBlock] <ScriptBlock>
     [-Credential <PSCredential>]
     [-Authentication <AuthenticationMechanism>]
     [[-InitializationScript] <ScriptBlock>]
     [-RunAs32]
     [-PSVersion <Version>]
     [-InputObject <PSObject>]
     [-ArgumentList <Object[]>]
     [<CommonParameters>]
Start-Job
     [-DefinitionName] <String>
     [[-DefinitionPath] <String>]
     [[-Type] <String>]
     [<CommonParameters>]
Start-Job
     [-Name <String>]
     [-Credential <PSCredential>]
     [-FilePath] <String>
     [-Authentication <AuthenticationMechanism>]
     [[-InitializationScript] <ScriptBlock>]
     [-RunAs32]
     [-PSVersion <Version>]
     [-InputObject <PSObject>]
     [-ArgumentList <Object[]>]
     [<CommonParameters>]
Start-Job
     [-Name <String>]
     [-Credential <PSCredential>]
     -LiteralPath <String>
     [-Authentication <AuthenticationMechanism>]
     [[-InitializationScript] <ScriptBlock>]
     [-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>]

Description

El Start-Job cmdlet 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 interrupción mientras se ejecuta el trabajo.

El objeto job contiene información útil sobre el trabajo, pero no contiene los resultados del trabajo. Cuando finalice el trabajo, use el Receive-Job cmdlet 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 Invoke-Command cmdlet para ejecutar un Start-Job comando en el equipo remoto. Para obtener más información, consulte 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.

Ejemplos

Ejemplo 1: Inicio de un trabajo en segundo plano

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 ejecutarse Get-Process como un trabajo en segundo plano. Se muestra la información del trabajo y PowerShell vuelve a un símbolo del sistema mientras el trabajo se ejecuta en segundo plano.

Ejemplo 2: Iniciar un trabajo mediante Invoke-Command

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

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

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.

Ejemplo 3: Obtención de información del trabajo

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 del sistema . 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 $j variable .

El objeto de la $j variable 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.

Ejemplo 4: Ejecución de un script como trabajo en segundo plano

En este ejemplo, un script en el equipo local se ejecuta 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.

Ejemplo 5: Obtener un proceso mediante un trabajo en segundo plano

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.

Ejemplo 6: Recopilar y guardar datos mediante un trabajo en segundo plano

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

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 descriptivo, GetMappingFiles. El parámetro InitializationScript ejecuta un bloque de script que importa el módulo MapFunctions . El parámetro ScriptBlock se ejecuta Get-Map y Set-Content guarda los datos en la ubicación especificada por el parámetro Path . El parámetro RunAs32 ejecuta el proceso como de 32 bits, incluso en un sistema operativo de 64 bits.

Ejemplo 7: Pasar la entrada a un trabajo en segundo plano

En este ejemplo se usa la $input variable automática para procesar un objeto de entrada. Use Receive-Job para ver la salida 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 ejecutarse Get-Content con la $input variable automática. La $input variable 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 se pueda volver a ver durante la sesión de PowerShell.

Parámetros

-ArgumentList

Especifica una matriz de argumentos o valores de parámetro para el script especificado por el parámetro FilePath .

Dado que todos los valores que siguen el nombre del parámetro ArgumentList se interpretan como valores de ArgumentList, especifique este parámetro como el último parámetro del comando.

Type:Object[]
Aliases:Args
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Authentication

Especifica el mecanismo que se usa para autenticar las credenciales de usuario.

Los valores aceptables para este parámetro son los siguientes:

  • Valor predeterminado
  • Básico
  • Credssp
  • Digest
  • Kerberos
  • Negotiate
  • NegotiateWithImplicitCredential

El valor predeterminado es Default.

La autenticación CredSSP solo está disponible en Windows Vista, Windows Server 2008 y versiones posteriores del sistema operativo Windows.

Para obtener más información sobre los valores de este parámetro, vea AuthenticationMechanism.

Precaución

la autenticación de proveedor de servicios de seguridad de credenciales (CredSSP), en la que las credenciales de usuario se envían a un equipo remoto para autenticarlas, está pensada para comandos que requieren autenticación en más de un recurso, como el acceso a un recurso compartido de red remoto. Este mecanismo el riesgo de seguridad de la operación remota. Si el equipo remoto se ve comprometido, las credenciales que se pasen a él se pueden utilizar para controlar la sesión de red.

Type:AuthenticationMechanism
Accepted values:Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos
Position:Named
Default value:Default
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Especifica una cuenta de usuario con permiso para realizar esta acción. Si no se especifica el parámetro Credential , el comando usa las credenciales del usuario actual.

Escriba un nombre de usuario, como User01 o Domain01\User01, o escriba un objeto PSCredential , como uno del Get-Credential cmdlet.

Type:PSCredential
Position:Named
Default value:Current user
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefinitionName

Especifica el nombre de definición del trabajo que inicia este cmdlet. Use este parámetro para iniciar tipos de trabajo personalizados que tengan un nombre de definición, como los trabajos programados.

Cuando se usa Start-Job para iniciar una instancia de un trabajo programado, el trabajo se inicia inmediatamente, independientemente de los desencadenadores de trabajo o las opciones de trabajo. La instancia de trabajo resultante es un trabajo programado, pero no se guarda en el disco como los trabajos programados desencadenados. No se puede usar el parámetro ArgumentList de Start-Job para proporcionar valores para los parámetros de los scripts que se ejecutan en un trabajo programado. Para obtener más información, consulte about_Scheduled_Jobs.

Este parámetro se introdujo en PowerShell 3.0.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DefinitionPath

Especifica la ruta de acceso de la definición del trabajo que inicia este cmdlet. Escriba la ruta de acceso de definición. La concatenación de los valores de los parámetros DefinitionPath y DefinitionName es la ruta de acceso completa de la definición del trabajo. Use este parámetro para iniciar tipos de trabajo personalizados que tengan una ruta de acceso de definición, como los trabajos programados.

Para los trabajos programados, el valor del parámetro DefinitionPath es $home\AppData\Local\Windows\PowerShell\ScheduledJob.

Este parámetro se introdujo en PowerShell 3.0.

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FilePath

Especifica un script local que Start-Job se ejecuta como un trabajo en segundo plano. Escriba la ruta de acceso y el nombre de archivo del script o use la canalización para enviar una ruta de acceso de script a Start-Job. El script debe estar en el equipo local o en una carpeta a la que pueda acceder el equipo local.

Cuando se usa este parámetro, PowerShell convierte el contenido del archivo de script especificado en un bloque de script y ejecuta el bloque de script como un trabajo en segundo plano.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InitializationScript

Especifica los comandos que se ejecutan antes de que se inicie el trabajo. Para crear un bloque de script, incluya los comandos entre llaves ({}).

Use este parámetro para preparar la sesión en la que se ejecuta el trabajo. Por ejemplo, puede usarlo para agregar funciones, complementos y módulos a la sesión.

Type:ScriptBlock
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Especifica entradas del comando. Escriba una variable que contenga los objetos, o escriba un comando o una expresión que genere los objetos.

En el valor del parámetro ScriptBlock , use la $input variable automática para representar los objetos de entrada.

Type:PSObject
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-LiteralPath

Especifica un script local que este cmdlet se ejecuta como un trabajo en segundo plano. Escriba la ruta de acceso de un script en el equipo local.

Start-Job usa el valor del parámetro LiteralPath exactamente como se escribe. Ningún carácter se interpreta como carácter comodín. Si la ruta de acceso contiene caracteres de escape, escríbalos entre comillas simples. Las comillas simples indican a PowerShell que no interprete caracteres como secuencias de escape.

Type:String
Aliases:PSPath
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

Especifica un nombre descriptivo para el nuevo trabajo. Puede usar el nombre para identificar el trabajo en otros cmdlets de trabajo, como el Stop-Job cmdlet .

El nombre descriptivo predeterminado es Job#, donde # es un número ordinal que se incrementa para cada trabajo.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PSVersion

Especifica una versión. Start-Job ejecuta el trabajo con la versión de PowerShell. Los valores aceptables para este parámetro son: 2.0 y 3.0.

Este parámetro se introdujo en PowerShell 3.0.

Type:Version
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAs32

Indica que Start-Job ejecuta el trabajo en un proceso de 32 bits. RunAs32 obliga al trabajo a ejecutarse en un proceso de 32 bits, incluso en un sistema operativo de 64 bits.

En versiones de 64 bits de Windows 7 y Windows Server 2008 R2, cuando el Start-Job comando incluye el parámetro RunAs32 , no puede usar el parámetro Credential para especificar las credenciales de otro usuario.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ScriptBlock

Especifica los comandos que se ejecutarán en el trabajo en segundo plano. Para crear un bloque de script, incluya los comandos entre llaves ({}). Use la $input variable automática para tener acceso al valor del parámetro InputObject . Este parámetro es obligatorio.

Type:ScriptBlock
Aliases:Command
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Type

Especifica el tipo personalizado para los trabajos iniciados por Start-Job. Escriba un nombre de tipo de trabajo personalizado, como PSScheduledJob para los trabajos programados o PSWorkflowJob para los trabajos de flujos de trabajo. Este parámetro no es válido para los trabajos en segundo plano estándar.

Este parámetro se introdujo en PowerShell 3.0.

Type:String
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

String

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

Salidas

System.Management.Automation.PSRemotingJob

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

Notas

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