Start-Process

Avvia uno o più processi nel computer locale.

Sintassi

Start-Process [-FilePath] <string> [[-ArgumentList] <string[]>] [-Credential <PSCredential>] [-LoadUserProfile] [-NoNewWindow] [-PassThru] [-RedirectStandardError <string>] [-RedirectStandardInput <string>] [-RedirectStandardOutput <string>] [-UseNewEnvironment] [-Wait] [-WorkingDirectory <string>] [<CommonParameters>]

Start-Process [-FilePath] <string> [[-ArgumentList] <string[]>] [-PassThru] [-Verb <string>] [-Wait] [-WindowStyle {<Normal> | <Hidden> | <Minimized> | <Maximized>}] [-WorkingDirectory <string>] [<CommonParameters>]

Descrizione

Avvia uno o più processi nel computer locale. Per specificare il programma in esecuzione nel processo, immettere un file eseguibile, un file script o un file che può essere aperto tramite un programma nel computer. Se si specifica un file non eseguibile, Start-Process avvia il programma associato al file, in modo analogo al cmdlet Invoke-Item.

È possibile utilizzare i parametri di Start-Process per specificare opzioni, ad esempio il caricamento di un profilo utente, l'avvio del processo in una nuova finestra o l'utilizzo di credenziali alternative.

Parametri

-ArgumentList <string[]>

Specifica i parametri o i valori dei parametri da utilizzare durante l'avvio del processo. Il nome del parametro ("Arguments") è facoltativo.

Obbligatorio?	false
Posizione?	2
Valore predefinito	nessuno
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-Credential <PSCredential>

Specifica un account utente con autorizzazione per l'esecuzione di questa azione. Digitare un nome utente, ad esempio "Utente01" o "Dominio01\Utente01", o immettere un oggetto PSCredential, ad esempio uno ottenuto dal cmdlet Get-Credential. Per impostazione predefinita, il cmdlet utilizza le credenziali dell'utente corrente.

Obbligatorio?	false
Posizione?	named
Valore predefinito	Current user.
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-FilePath <string>

Specifica il percorso (facoltativo) e il nome file del programma in esecuzione nel processo. Immettere il nome di un file eseguibile o di un documento, ad esempio un file con estensione txt o doc, associato a un programma nel computer. Questo parametro è obbligatorio.

Se si specifica solo un nome file, utilizzare il parametro WorkingDirectory per specificare il percorso.

Obbligatorio?	true
Posizione?	1
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-LoadUserProfile

Carica il profilo utente di Windows archiviato nella chiave del Registro di sistema HKEY_USERS per l'utente corrente. Il valore predefinito è FALSE.

Questo parametro non ha effetto sui profili di Windows PowerShell. (Vedere about_Profiles.)

Obbligatorio?	false
Posizione?	named
Valore predefinito	False
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-NoNewWindow

Impedisce l'esecuzione del processo in una nuova finestra. Per impostazione predefinita, il processo viene eseguito in una nuova finestra.

Obbligatorio?	false
Posizione?	named
Valore predefinito	False
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-PassThru

Restituisce un oggetto processo per ogni processo avviato dal cmdlet. Per impostazione predefinita, il cmdlet non genera alcun output.

Obbligatorio?	false
Posizione?	named
Valore predefinito	False
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-RedirectStandardError <string>

Invia qualsiasi errore generato dal processo a un file specificato. Immettere il percorso e il nome file. Per impostazione predefinita, gli errori vengono visualizzati nella console.

Obbligatorio?	false
Posizione?	named
Valore predefinito	Errors are displayed in the console
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-RedirectStandardInput <string>

Legge l'input dal file specificato. Immettere il percorso e il nome del file di input. Per impostazione predefinita, il processo ottiene l'input dalla tastiera.

Obbligatorio?	false
Posizione?	named
Valore predefinito	Keyboard
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-RedirectStandardOutput <string>

Invia l'output generato dal processo a un file specificato. Immettere il percorso e il nome file. Per impostazione predefinita, l'output viene visualizzato nella console.

Obbligatorio?	false
Posizione?	named
Valore predefinito	FALSE
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-UseNewEnvironment

Utilizzare le nuove variabili di ambiente specificate per il processo. Per impostazione predefinita, il processo avviato viene eseguito con le variabili di ambiente specificate per il computer e l'utente.

Obbligatorio?	false
Posizione?	named
Valore predefinito	False
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-Verb <string>

Specifica un verbo da utilizzare durante l'avvio del processo, ad esempio Edit, Open o Print.

Ogni tipo di file dispone di un set di verbi da utilizzare. Per trovare i verbi che è possibile utilizzare con il processo, utilizzare la proprietà Verbs dell'oggetto.

Obbligatorio?	false
Posizione?	named
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-Wait

Attende il completamento del processo specificato prima di accettare altro input. Questo parametro elimina il prompt dei comandi o mantiene la finestra fino al completamento del processo.

Obbligatorio?	false
Posizione?	named
Valore predefinito	False
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-WindowStyle <ProcessWindowStyle>

Specifica lo stato delle finestre utilizzate per il processo. I valori validi sono Normal, Hidden, Minimized e Maximized. Il valore predefinito è Normal.

Obbligatorio?	false
Posizione?	named
Valore predefinito	Normal
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-WorkingDirectory <string>

Specifica la posizione del file eseguibile o del documento in esecuzione nel processo. Il valore predefinito è la directory corrente.

Obbligatorio?	false
Posizione?	named
Valore predefinito	Current directory
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

<CommonParameters>

Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.

Input e output

Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.

Input	Nessuno Non è possibile reindirizzare l'input a Start-Process.
Output	Nessuno o System.Diagnostics.Process Quando si utilizza il parametro PassThru, Start-Process genera System.Diagnostics.Process. Negli altri casi, il cmdlet non restituisce alcun output.

Note

Questo cmdlet viene implementato tramite il metodo Start della classe System.Diagnostics,Process. Per ulteriori informazioni su questo metodo, vedere l'argomento relativo al metodo Process.Start in MSDN (Microsoft Developer Network) Library all'indirizzo https://go.microsoft.com/fwlink/?LinkId=143602 (le informazioni potrebbero essere in lingua inglese).

Esempio 1

C:\PS>start-process sort.exe

Descrizione
-----------
Questo comando avvia un processo che utilizza il file Sort.exe nella directory corrente. Il comando utilizza tutti i valori predefiniti, tra cui lo stile della finestra predefinito, la directory di lavoro e le credenziali.

Esempio 2

C:\PS>start-process myfile.txt -workingdirectory "C:\PS-Test" -verb Print

Descrizione
-----------
Questo comando avvia un processo che stampa il file C:\PS-Test\MyFile.txt.

Esempio 3

C:\PS>start-process Sort.exe -RedirectStandardInput Testsort.txt -RedirectStandardOutput Sorted.txt -RedirectStandardError SortError.txt -UseNewEnvironment

Descrizione
-----------
Questo comando avvia un processo che ordina gli elementi nel file Testsort.txt e restituisce gli elementi ordinati nei file Sorted.txt. Qualsiasi errore viene scritto nel file SortError.txt. 

Il parametro UseNewEnvironment specifica che il processo viene eseguito con le proprie variabili di ambiente.

Esempio 4

C:\PS>start-process notepad -wait -windowstyle Maximized

Descrizione
-----------
Questo comando avvia il processo Blocco note. Ingrandisce la finestra e la conserva fino al completamento del processo.

Vedere anche

Concetti

Start-Service
Get-Process
Stop-Process
Wait-Process
Debug-Process