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

Descrição
-----------
Esse comando inicia um trabalho em segundo plano que executa um comando Get-Process. O comando retorna um objeto de trabalho com informações sobre o trabalho. O prompt de comando retorna imediatamente de forma que você possa trabalhar na sessão enquanto o trabalho é executado em segundo plano.

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

Descrição
-----------
Esse comando usa o cmdlet Invoke-Command e seu parâmetro AsJob para iniciar um trabalho em segundo plano que executa um comando "get-service winrm" em vários computadores. Como o comando está sendo executado em um servidor com tráfego de rede significativo, o comando usa o parâmetro ThrottleLimit de Invoke-Command para limitar o número de comandos simultâneos a 16. 

O comando usa o parâmetro ComputerName para especificar os computadores nos quais o trabalho é executado. O valor do parâmetro ComputerName é um comando Get-Content que obtém o texto no arquivo Servers.txt, um arquivo de nomes de computadores em um domínio. 

O comando usa o parâmetro ScriptBlock para especificar o comando e o parâmetro JobName para especificar um nome amigável para o trabalho.

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...
...

Descrição
-----------
Esses comandos gerenciam um trabalho em segundo plano que obtém todos os eventos do log do sistema no Visualizador de Eventos. O trabalho é executado no computador local.

O primeiro comando usa o cmdlet Start-Job para iniciar o trabalho. Ele usa o parâmetro Credential para especificar a conta de um usuário que tem permissão de executar o trabalho no computador. Em seguida, ele salva o objeto de trabalho que Start-Job retorna na variável $j.

Nesse momento, você pode continuar sua outra atividade enquanto o trabalho é concluído.

O segundo comando usa um operador de pipeline (|) para transmitir o objeto de trabalho em $j para o cmdlet Format-List. O comando Format-List usa o parâmetro Property com um valor igual a all (*) para exibir todas as propriedades do objeto de trabalho em uma lista.

O terceiro comando exibe o valor da propriedade JobStateInfo. Ele contém o status do trabalho.

O quarto comando utiliza o cmdlet Receive-Job para obter os resultados do trabalho. Ele armazena os resultados na variável $results.

O comando final exibe o conteúdo da variável $results.

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

Descrição
-----------
Esse comando executa o script Sample.ps1 como um trabalho em segundo plano.

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

Descrição
-----------
Esse comando executa um trabalho em segundo plano que obtém o processo WinRM no computador local. O comando usa o parâmetro ScriptBlock para especificar o comando executado em segundo plano. Ele usa o parâmetro Name para especificar um nome amigável para o novo trabalho.

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

Descrição
-----------
Esse comando inicia um trabalho que coleta uma grande quantidade de dados e salva-os em um arquivo .tif. O comando usa o parâmetro InitializationScript para executar um bloco de script que importa um módulo necessário. Ele também usa o parâmetro RunAs32 para executar o trabalho em um processo de 32 bits, mesmo que o computador tenha um sistema operacional de 64 bits.