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

Descrizione
-----------
Questo comando avvia un processo in background in cui viene eseguito un comando Get-Process. Il comando restituisce un oggetto processo con le informazioni sul processo. Il prompt dei comandi viene visualizzato immediatamente, in modo che sia possibile proseguire il lavoro nella sessione mentre il processo è in esecuzione in background.

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

Descrizione
-----------
Questo comando utilizza il cmdlet Invoke-Command e il parametro AsJob per avviare un processo in background che esegue un comando "winrm get-service" in numerosi computer. Poiché il comando è in esecuzione in un server con traffico di rete sostanziale, il comando utilizza il parametro ThrottleLimit di Invoke-Command per limitare il numero di comandi simultanei a 16. 

Viene utilizzato il parametro ComputerName per specificare i computer in cui viene eseguito il processo. Il valore del parametro ComputerName è un comando Get-Content che ottiene il testo nel file Servers.txt, un file di nomi di computer in un dominio. 

Viene utilizzato il parametro ScriptBlock per specificare il comando e il parametro JobName per specificare un nome descrittivo per il processo.

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

Descrizione
-----------
Questi comandi gestiscono un processo in background che ottiene tutti gli eventi dal registro di sistema in Visualizzatore eventi. Il processo viene eseguito nel computer locale.

Il primo comando utilizza il cmdlet Start-Job per avviare il processo. Viene utilizzato il parametro Credential per specificare l'account utente di un utente che dispone dell'autorizzazione per eseguire il processo nel computer. Successivamente il comando salva l'oggetto processo restituito da Start-Job nella variabile $j.

A questo punto, è possibile riprendere le altre attività mentre il processo viene completato.

Il secondo comando utilizza un operatore pipeline (|) per passare l'oggetto processo in $j al cmdlet Format-List. Il comando Format-List utilizza il parametro Property con un valore indicante tutti gli elementi (*) per visualizzare tutte le proprietà dell'oggetto processo in un elenco.

Nel terzo comando viene visualizzato il valore della proprietà JobStateInfo. Tale proprietà contiene lo stato del processo.

Nel quarto comando viene utilizzato il cmdlet Receive-Job per ottenere i risultati del processo. I risultati vengono archiviati nella variabile $results.

Nel comando finale viene visualizzato il contenuto della variabile $results.

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

Descrizione
-----------
Questo comando esegue lo script Sample.ps1 come processo in background.

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

Descrizione
-----------
Questo comando esegue un processo in background che ottiene il processo WinRM nel computer locale. Viene utilizzato il parametro ScriptBlock per specificare il comando che viene eseguito nel processo in background. Viene utilizzato il parametro Name per specificare un nome descrittivo per il nuovo processo.

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

Descrizione
-----------
Con questo comando viene avviato un processo che raccoglie una grande quantità di dati e li salva in un file con estensione tif. Nel comando viene utilizzato il parametro InitializationScript per eseguire un blocco di script che importa un modulo obbligatorio. Viene inoltre utilizzato il parametro RunAs32 per eseguire il processo in un processo a 32 bit anche se il computer dispone di un sistema operativo a 64 bit.