Start-Job

Modulo:

Microsoft.PowerShell.Core

Avvia un processo in background di PowerShell.

Sintassi

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

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

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

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

Descrizione

Il cmdlet Start-Job avvia un processo in background di PowerShell nel computer locale.

Un processo in background di PowerShell esegue un comando senza interagire con la sessione corrente. Quando si avvia un processo in background, un oggetto di processo viene restituito immediatamente, anche se il processo richiede un tempo prolungato per il completamento. Puoi continuare a lavorare nella sessione senza interruzioni mentre il processo è in esecuzione.

L'oggetto processo contiene informazioni utili sul processo, ma non contiene i risultati del processo. Al termine del processo, usare il cmdlet Receive-Job per ottenere i risultati del processo. Per altre informazioni sui processi in background, vedere about_Jobs.

Per eseguire un processo in background in un computer remoto, usare il parametro AsJob disponibile in molti cmdlet oppure usare il cmdlet Invoke-Command per eseguire un comando Start-Job nel computer remoto. Per altre informazioni, vedere about_Remote_Jobs.

A partire da PowerShell 3.0, Start-Job può avviare istanze di tipi di processi personalizzati, ad esempio processi pianificati. Per informazioni su come usare Start-Job per avviare attività con tipi personalizzati, vedere i documenti della Guida per la funzionalità relativa ai tipi di attività.

A partire da PowerShell 6.0, è possibile avviare i processi usando l'operatore di sfondo ampersand (&). La funzionalità dell'operatore in background è simile a Start-Job. Entrambi i metodi per avviare un'attività creano un oggetto attività PSRemotingJob. Per ulteriori informazioni sull'uso della e commerciale (&), consultare about_Operators.

PowerShell 7 ha introdotto il parametro WorkingDirectory che specifica la directory di lavoro iniziale di un processo in background. Se il parametro non è specificato, per impostazione predefinita Start-Job corrisponde alla directory di lavoro corrente del chiamante che ha avviato il processo.

Nota

La creazione di un processo in background isolato con Start-Job non è supportata nello scenario in cui PowerShell è ospitato in altre applicazioni, come nel caso delle Funzioni Azure di PowerShell.

Questo è intenzionale perché Start-Job dipende dalla disponibilità dell'eseguibile pwsh sotto $PSHOME per avviare un processo in background out-of-process, ma quando un'applicazione ospita PowerShell, utilizza direttamente i pacchetti NuGet SDK di PowerShell e non avrà pwsh incluso.

Il sostituto in questo scenario è Start-ThreadJob dal modulo ThreadJob.

Esempio

Esempio 1: Avviare un lavoro in background

In questo esempio viene avviato un processo in background eseguito nel computer locale.

Start-Job -ScriptBlock { Get-Process -Name pwsh }

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

Start-Job usa il parametro ScriptBlock per eseguire Get-Process come processo in background. Il parametro Name specifica di trovare i processi PowerShell pwsh. Le informazioni sul processo vengono visualizzate e PowerShell torna a una richiesta mentre il processo viene eseguito in background.

Per visualizzare l'output del processo, usare il cmdlet Receive-Job. Ad esempio, Receive-Job -Id 1.

Esempio 2: Utilizzare l'operatore background per avviare un processo in background

In questo esempio viene utilizzato l'operatore di sfondo & () per avviare un processo in background sul computer locale. Il lavoro ottiene lo stesso risultato di Start-Job nell'Esempio 1.

Get-Process -Name pwsh &

Id    Name   PSJobTypeName   State       HasMoreData     Location      Command
--    ----   -------------   -----       -----------     --------      -------
5     Job5   BackgroundJob   Running     True            localhost     Microsoft.PowerShell.Man...

Get-Process usa il parametro Name per specificare i processi di PowerShell pwsh. La e commerciale (&) esegue il comando come processo in background. Le informazioni sul processo vengono visualizzate e PowerShell torna a una richiesta mentre il processo viene eseguito in background.

Per visualizzare l'output del processo, utilizzare il cmdlet Receive-Job. Ad esempio, Receive-Job -Id 5.

Esempio 3: Avviare un processo usando Invoke-Command

Questo esempio esegue un'operazione su più computer. Il processo viene archiviato in una variabile e viene eseguito usando il nome della variabile nella riga di comando di PowerShell.

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

Viene creato e archiviato un processo che usa Invoke-Command nella variabile $jobWRM. Invoke-Command usa il parametro ComputerName per specificare i computer in cui viene eseguito il processo. Get-Content ottiene i nomi dei server dal file di C:\Servers.txt.

Il parametro ScriptBlock specifica un comando che Get-Service ottiene il servizio WinRM. Il parametro JobName specifica un nome amichevole per il processo, WinRM. Il parametro ThrottleLimit limita il numero di comandi simultanei a 16. Il parametro AsJob avvia un processo in background che esegue il comando nei server.

Esempio 4: Ottenere informazioni sul lavoro

In questo esempio vengono recuperate informazioni su un processo e vengono visualizzati i risultati di un processo completato eseguito nel computer locale.

$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 il parametro ScriptBlock per eseguire un comando che specifica Get-WinEvent per ottenere il log di sistema . Il parametro Credenziale specifica un account utente di dominio autorizzato a eseguire l'attività sul computer. L'oggetto job viene archiviato nella variabile $j.

L'oggetto nella variabile $j viene inviato nella pipeline al Select-Object. Il parametro Proprietà è rappresentato da un asterisco (*) per visualizzare tutte le proprietà dell'oggetto di lavoro.

Esempio 5: Eseguire uno script come processo in background

In questo esempio viene eseguito uno script nel computer locale come processo in background.

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

Start-Job usa il parametro FilePath per specificare un file di script archiviato nel computer locale.

Esempio 6: Ottenere un processo utilizzando un'attività in background

In questo esempio viene utilizzata un'attività in background per ottenere un processo specificato in base al nome.

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

Start-Job usa il parametro Nome per specificare un nome di processo amichevole, PShellJob. Il parametro ScriptBlock specifica Get-Process per ottenere processi con il nome PowerShell.

Esempio 7: Raccogliere e salvare i dati usando un processo in background

In questo esempio viene avviato un processo che raccoglie una grande quantità di dati della mappa e quindi lo salva in un file di .tif.

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

Start-Job usa il parametro Name per specificare un nome amichevole per il processo, GetMappingFiles. Il parametro InitializationScript esegue un blocco di script che importa il modulo MapFunctions. Il parametro ScriptBlock viene eseguito Get-Map e Set-Content salva i dati nella posizione specificata dal parametro Path.

Esempio 8: Passare l'input a un processo in background

In questo esempio viene utilizzata la variabile automatica $input per elaborare un oggetto di input. Usare Receive-Job per visualizzare l'output del lavoro.

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

Server01
Server02
Server03
Server04

Start-Job usa il parametro ScriptBlock per eseguire Get-Content con la variabile automatica $input. La variabile $input ottiene oggetti dal parametro InputObject. Receive-Job usa il parametro nome per specificare il processo e restituisce i risultati. Il parametro Keep salva l'output del processo in modo che possa essere visualizzato di nuovo durante la sessione di PowerShell.

Esempio 9: Imposta la cartella di lavoro per un processo in background

Il WorkingDirectory consente di specificare una directory alternativa per un processo da cui è possibile eseguire script o aprire file. In questo esempio, il processo in background specifica una directory di lavoro diversa da quella corrente.

PS C:\Test> Start-Job -WorkingDirectory C:\Test\Scripts { $PWD } | Receive-Job -AutoRemoveJob -Wait

Path
----
C:\Test\Scripts

La directory corrente di lavoro per questo esempio è C:\Test. Start-Job usa il parametro WorkingDirectory per specificare la directory di lavoro dell'attività. Il parametro ScriptBlock usa $PWD per visualizzare la directory di lavoro dell'operazione. Receive-Job visualizza l'output del processo in background. AutoRemoveJob elimina il processo e Wait sospende il prompt dei comandi fino a quando non vengono ricevuti tutti i risultati.

Esempio 10: Usare il parametro ArgumentList per specificare una matrice

In questo esempio viene utilizzato il parametro ArgumentList per specificare una matrice di argomenti. La matrice è un elenco delimitato da virgole di nomi di processo.

Start-Job -ScriptBlock { Get-Process -Name $args } -ArgumentList powershell, pwsh, notepad

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

Il cmdlet Start-Job usa il parametro ScriptBlock per eseguire un comando. Get-Process usa il parametro Name per specificare la variabile automatica $args. Il parametro ArgumentList passa la matrice di nomi di processo a $args. I nomi dei processi powershell, pwsh e Blocco note sono processi in esecuzione nel computer locale.

Per visualizzare l'output del processo, utilizzare il cmdlet Receive-Job. Ad esempio, Receive-Job -Id 1.

Esempio 11: Eseguire un processo in windows PowerShell 5.1

In questo esempio viene usato il parametro PSVersion con valore 5.1 per eseguire il processo in una sessione di Windows PowerShell 5.1.

$PSVersionTable.PSVersion

Major  Minor  Patch  PreReleaseLabel BuildLabel
-----  -----  -----  --------------- ----------
7      0      0      rc.1

$job = Start-Job -ScriptBlock { $PSVersionTable.PSVersion } -PSVersion 5.1
Receive-Job -Job $job

Major  Minor  Build  Revision
-----  -----  -----  --------
5      1      14393  3383

Parametri

-ArgumentList

Specifica una matrice di argomenti o valori di parametro per lo script specificato dal parametro FilePath o un comando specificato con il parametro ScriptBlock.

Gli argomenti devono essere passati a ArgumentList come argomento matrice a dimensione singola. Ad esempio, un elenco delimitato da virgole. Per altre informazioni sul comportamento di ArgumentList, vedere about_Splatting.

Tipo:	Object[]
Alias:	Args
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Authentication

Specifica il meccanismo utilizzato per autenticare le credenziali utente.

I valori accettabili per questo parametro sono i seguenti:

• Predefinito
• Basico
• Credssp
• Digerire
• Kerberos
• Negoziare
• NegotiateWithImplicitCredential

Il valore predefinito è Default.

L'autenticazione CredSSP è disponibile solo in Windows Vista, Windows Server 2008 e versioni successive del sistema operativo Windows.

Per altre informazioni sui valori di questo parametro, vedere AuthenticationMechanism.

Cautela

L'autenticazione credSSP (Credential Security Support Provider), in cui le credenziali dell'utente vengono passate a un computer remoto da autenticare, è progettato per i comandi che richiedono l'autenticazione su più di una risorsa, ad esempio l'accesso a una condivisione di rete remota. Questo meccanismo aumenta il rischio di sicurezza dell'operazione remota. Se il computer remoto viene compromesso, è possibile usare le credenziali passate per controllare la sessione di rete.

Tipo:	AuthenticationMechanism
Valori accettati:	Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos
Posizione:	Named
Valore predefinito:	Default
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Credential

Specifica un account utente autorizzato a eseguire questa azione. Se il parametro Credential non è specificato, il comando usa le credenziali dell'utente corrente.

Digitare un nome utente, ad esempio User01 o Domain01\User01oppure immettere un oggetto PSCredential generato dal cmdlet Get-Credential. Se si digita un nome utente, viene richiesto di immettere la password.

Le credenziali vengono archiviate in un oggetto PSCredential e la password viene archiviata come SecureString.

Nota

Per ulteriori informazioni sulla protezione dei dati di SecureString, consultare Quanto è sicuro SecureString?.

Tipo:	PSCredential
Posizione:	Named
Valore predefinito:	Current user
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-DefinitionName

Specifica il nome della definizione del processo avviato da questo cmdlet. Usare questo parametro per avviare tipi di processo personalizzati con un nome di definizione, ad esempio processi pianificati.

Quando si usa Start-Job per avviare un'istanza di un processo pianificato, il processo viene avviato immediatamente, indipendentemente dai trigger di processo o dalle opzioni del processo. L'istanza del processo risultante è un processo pianificato, ma non viene salvato su disco come i processi pianificati attivati. Non è possibile usare il parametro ArgumentList di Start-Job per fornire valori per i parametri degli script eseguiti in un processo pianificato.

Questo parametro è stato introdotto in PowerShell 3.0.

Tipo:	String
Posizione:	0
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-DefinitionPath

Specifica il percorso della definizione per il processo avviato da questo cmdlet. Immettere il percorso di definizione. La concatenazione dei valori dei parametri DefinitionPath e DefinitionName è il percorso completo della definizione del processo. Usare questo parametro per avviare tipi di processo personalizzati con un percorso di definizione, ad esempio processi pianificati.

Per i processi pianificati, il valore del parametro DefinitionPath è $HOME\AppData\Local\Windows\PowerShell\ScheduledJob.

Questo parametro è stato introdotto in PowerShell 3.0.

Tipo:	String
Posizione:	1
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-FilePath

Specifica uno script locale che Start-Job esegue in background. Immettere il percorso e il nome file dello script oppure usare la pipeline per inviare un percorso di script a Start-Job. Lo script deve trovarsi nel computer locale o in una cartella a cui il computer locale può accedere.

Quando si usa questo parametro, PowerShell converte il contenuto del file di script specificato in un blocco di script ed esegue il blocco di script come processo in background.

Tipo:	String
Posizione:	0
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-InitializationScript

Specifica i comandi eseguiti prima dell'avvio del processo. Per creare un blocco di script, racchiudere i comandi tra parentesi graffe ({}).

Usare questo parametro per preparare la sessione in cui viene eseguito il processo. Ad esempio, è possibile usarlo per aggiungere funzioni, snap-in e moduli alla sessione.

Tipo:	ScriptBlock
Posizione:	1
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-InputObject

Specifica l'input per il comando. Immettere una variabile contenente gli oggetti oppure digitare un comando o un'espressione che genera gli oggetti .

Nel valore del parametro ScriptBlock usare la variabile automatica $input per rappresentare gli oggetti di input.

Tipo:	PSObject
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-LiteralPath

Specifica uno script locale eseguito da questo cmdlet come processo in background. Immettere il percorso di uno script nel computer locale.

Start-Job usa il valore del parametro LiteralPath esattamente come viene digitato. Nessun carattere è interpretato come un carattere jolly. Se il percorso include caratteri di escape, racchiuderlo tra virgolette singole. Le virgolette singole indicano a PowerShell di non interpretare alcun carattere come sequenze di escape.

Tipo:	String
Alias:	PSPath, LP
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Name

Specifica un nome intuitivo per il nuovo processo. È possibile usare il nome per identificare il processo con altri cmdlet del processo, ad esempio il cmdlet Stop-Job.

Il nome amichevole predefinito è Job#, dove # è un numero ordinale incrementato per ogni attività.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-PSVersion

Specifica una versione di PowerShell da usare per l'esecuzione del processo. Quando il valore di PSVersion è 5.1 Il processo viene eseguito in una sessione di Windows PowerShell 5.1. Per qualsiasi altro valore, il processo viene eseguito usando la versione corrente di PowerShell.

Questo parametro è stato aggiunto in PowerShell 7 e funziona solo in Windows.

Tipo:	Version
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-RunAs32

A partire da PowerShell 7, il parametro RunAs32 non funziona in PowerShell a 64 bit (pwsh). Se RunAs32 viene specificato in PowerShell a 64 bit, Start-Job genera un errore di eccezione irreversibile. Per avviare un processo di PowerShell a 32 bit (pwsh) con RunAs32, è necessario che PowerShell a 32 bit sia installato.

In PowerShell a 32-bit RunAs32 forza l'esecuzione in un processo a 32 bit, anche se in un sistema operativo a 64 bit.

Nelle versioni a 64 bit di Windows 7 e Windows Server 2008 R2, quando il comando Start-Job include il parametro RunAs32, non è possibile usare il parametro credenziali per specificare le credenziali di un altro utente.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	False
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ScriptBlock

Specifica i comandi da eseguire nel processo in background. Per creare un blocco di script, racchiudere i comandi tra parentesi graffe ({}). Usare la variabile automatica $input per accedere al valore del parametro InputObject. Questo parametro è obbligatorio.

Tipo:	ScriptBlock
Alias:	Command
Posizione:	0
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Type

Specifica il tipo personalizzato per le attività avviate da Start-Job. Immettere un nome di tipo di processo personalizzato, ad esempio PSScheduledJob per i processi pianificati o PSWorkflowJob per i processi dei flussi di lavoro. Questo parametro non è valido per i processi in background standard.

Questo parametro è stato introdotto in PowerShell 3.0.

Tipo:	String
Posizione:	2
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-WorkingDirectory

Specifica la directory di lavoro iniziale del processo in background. Se il parametro non è specificato, il processo viene eseguito dal percorso predefinito. Il percorso predefinito è la cartella di lavoro corrente del chiamante che ha avviato l'operazione.

Questo parametro è stato introdotto in PowerShell 7.

Tipo:	String
Posizione:	Named
Valore predefinito:	$HOME on Unix (macOS, Linux) and $HOME\Documents on Windows
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

Input

String

È possibile inviare tramite pipe un oggetto con la proprietà Name al parametro Name di questo cmdlet. Ad esempio, è possibile inviare tramite pipe un oggetto fileInfo da Get-ChildItem.

Output

System.Management.Automation.PSRemotingJob

Questo cmdlet restituisce un oggetto PSRemotingJob che rappresenta il processo avviato.

Note

PowerShell include gli alias seguenti per Start-Job:

• Tutte le piattaforme:
  • sajb

Per l'esecuzione in background, Start-Job viene eseguita nella propria sessione nella sessione corrente. Quando si usa il cmdlet Invoke-Command per eseguire un comando Start-Job in una sessione in un computer remoto, Start-Job viene eseguito in una sessione nella sessione remota.

Collegamenti correlati

• informazioni_sugli_Array
• Informazioni su Variabili Automatiche
• informazioni_su_Lavori
• informazioni_su_Dettagli_Lavoro
• informazioni_su_Lavori_Remoti
• Get-Job
• Invoke-Command
• Receive-Job
• Remove-Job
• Stop-Job
• Wait-Job