Démarre un ou plusieurs processus sur l'ordinateur local.
Syntaxe
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>]
Description
Démarre un ou plusieurs processus sur l'ordinateur local. Pour spécifier le programme qui s'exécute dans le processus, entrez un fichier exécutable, un fichier de script ou un fichier qui peut s'ouvrir à l'aide d'un programme sur l'ordinateur. Si vous spécifiez un fichier non exécutable, Start-Process démarre le programme qui est associé à ce fichier, à la manière de l'applet de commande Invoke-Item.
Vous pouvez utiliser les paramètres de Start-Process pour spécifier des options (chargement d'un profil utilisateur, démarrage du processus dans une nouvelle fenêtre ou utilisation d'autres informations d'identification, par exemple).
Paramètres
-ArgumentList <string[]>
Spécifie des paramètres ou des valeurs de paramètre à utiliser lors du démarrage du processus. Le nom du paramètre (« Arguments ») est facultatif.
|
Obligatoire ? |
false |
|
Position ? |
2 |
|
Valeur par défaut |
aucun |
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-Credential <PSCredential>
Spécifie un compte d'utilisateur qui a l'autorisation d'exécuter cette action. Tapez un nom d'utilisateur, tel que « User01 » ou « Domain01\User01 », ou entrez un objet PSCredential, tel que celui généré par l'applet de commande Get-Credential. Par défaut, l'applet de commande utilise les informations d'identification de l'utilisateur actuel.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
Current user. |
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-FilePath <string>
Spécifie le chemin d'accès (facultatif) et le nom de fichier du programme qui s'exécute dans le processus. Entrez le nom d'un fichier exécutable ou d'un document (fichier .txt ou .doc, par exemple) qui est associé à un programme sur l'ordinateur. Ce paramètre est obligatoire.
Si vous ne spécifiez qu'un nom de fichier, utilisez le paramètre WorkingDirectory pour spécifier le chemin d'accès.
|
Obligatoire ? |
true |
|
Position ? |
1 |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-LoadUserProfile
Charge le profil utilisateur Windows stocké dans la clé de Registre HKEY_USERS pour l'utilisateur actuel. La valeur par défaut est FALSE.
Ce paramètre n'affecte pas les profils Windows PowerShell. (Consultez about_Profiles.)
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
False |
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-NoNewWindow
Empêche le processus de s'exécuter dans une nouvelle fenêtre. Par défaut, le processus s'exécute dans une nouvelle fenêtre.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
False |
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-PassThru
Retourne un objet processus pour chaque processus démarré par l'applet de commande. Par défaut, cette applet de commande ne génère aucune sortie.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
False |
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-RedirectStandardError <string>
Envoie les erreurs générées par le processus à un fichier que vous spécifiez. Entrez le chemin d'accès et le nom du fichier. Par défaut, les erreurs s'affichent dans la console.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
Errors are displayed in the console |
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-RedirectStandardInput <string>
Lit l'entrée à partir du fichier spécifié. Entrez le chemin d'accès et le nom du fichier d'entrée. Par défaut, le processus obtient son entrée à partir du clavier.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
Keyboard |
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-RedirectStandardOutput <string>
Envoie la sortie générée par le processus à un fichier que vous spécifiez. Entrez le chemin d'accès et le nom du fichier. Par défaut, la sortie s'affiche dans la console.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
FALSE |
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-UseNewEnvironment
Utilisez les nouvelles variables d'environnement spécifiées pour le processus. Par défaut, le processus démarré s'exécute avec les variables d'environnement spécifiées pour l'ordinateur et l'utilisateur.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
False |
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-Verb <string>
Spécifie un verbe à utiliser au démarrage du processus (Edit, Open ou Print, par exemple).
Chaque type de fichier possède un jeu de verbes que vous pouvez utiliser. Pour rechercher les verbes qui peuvent être utilisés avec le processus, utilisez la propriété Verbs de l'objet.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-Wait
Attend la fin de l'exécution du processus spécifié avant d'accepter une autre entrée. Ce paramètre supprime l'invite de commandes ou conserve la fenêtre tant que l'exécution du processus n'est pas terminée.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
False |
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-WindowStyle <ProcessWindowStyle>
Spécifie l'état des fenêtres utilisées pour le processus. Les valeurs valides sont Normal, Hidden, Minimized et Maximized. La valeur par défaut est Normal.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
Normal |
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-WorkingDirectory <string>
Spécifie l'emplacement du fichier exécutable ou du document qui s'exécute dans le processus. L'emplacement par défaut est le répertoire actif.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
Current directory |
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.
Entrées et sorties
Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.
|
Entrées |
None Vous ne pouvez pas diriger d'entrée vers Start-Process. |
|
Sorties |
Aucun ou System.Diagnostics.Process Lorsque vous utilisez le paramètre PassThru, Start-Process génère un objet System.Diagnostics.Process. Sinon, cette applet de commande ne retourne aucune sortie. |
Remarques
Cette applet de commande est implémentée à l'aide de la méthode Start de la classe System.Diagnostics.Process. Pour plus d'informations sur cette méthode, consultez « Méthode Process.Start » (page éventuellement en anglais) dans MSDN Library, à l'adresse https://go.microsoft.com/fwlink/?LinkId=143602.
Exemple 1
C:\PS>start-process sort.exe Description ----------- Cette commande démarre un processus qui utilise le fichier Sort.exe dans le répertoire actif. La commande utilise toutes les valeurs par défaut, y compris le style de fenêtre par défaut, le répertoire de travail et les informations d'identification.
Exemple 2
C:\PS>start-process myfile.txt -workingdirectory "C:\PS-Test" -verb Print Description ----------- Cette commande démarre un processus qui imprime le fichier C:\PS-Test\MyFile.txt.
Exemple 3
C:\PS>start-process Sort.exe -RedirectStandardInput Testsort.txt -RedirectStandardOutput Sorted.txt -RedirectStandardError SortError.txt -UseNewEnvironment Description ----------- Cette commande démarre un processus qui trie les éléments figurant dans le fichier Testsort.txt et retourne les éléments triés dans les fichiers Sorted.txt. Les erreurs sont écrites dans le fichier SortError.txt. Le paramètre UseNewEnvironment indique que le processus s'exécute avec ses propres variables d'environnement.
Exemple 4
C:\PS>start-process notepad -wait -windowstyle Maximized Description ----------- Cette commande démarre le processus Notepad. Elle agrandit la fenêtre et la conserve tant que l'exécution du processus n'est pas terminée.
Voir aussi