Condividi tramite


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