Start-Process

Syntaxe

Start-Process
     [-FilePath] <string>
     [[-ArgumentList] <string[]>]
     [-Credential <pscredential>]
     [-WorkingDirectory <string>]
     [-LoadUserProfile]
     [-NoNewWindow]
     [-PassThru]
     [-RedirectStandardError <string>]
     [-RedirectStandardInput <string>]
     [-RedirectStandardOutput <string>]
     [-WindowStyle <ProcessWindowStyle>]
     [-Wait]
     [-UseNewEnvironment]
     [-Environment <hashtable>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-Process
     [-FilePath] <string>
     [[-ArgumentList] <string[]>]
     [-WorkingDirectory <string>]
     [-PassThru]
     [-Verb <string>]
     [-WindowStyle <ProcessWindowStyle>]
     [-Wait]
     [-Environment <hashtable>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

L’applet Start-Process de commande démarre un ou plusieurs processus sur l’ordinateur local. Par défaut, Start-Process crée un processus qui hérite de toutes les variables d’environnement définies dans le processus actuel.

Pour spécifier le programme qui s’exécute dans le processus, entrez un fichier exécutable ou un fichier de script, ou un fichier qui peut être ouvert à l’aide d’un programme sur l’ordinateur. Si vous spécifiez un fichier non exécutable, Start-Process démarre le programme associé au fichier, similaire à l’applet Invoke-Item de commande.

Vous pouvez utiliser les paramètres de Start-Process spécifier des options, telles que le chargement d’un profil utilisateur, le démarrage du processus dans une nouvelle fenêtre ou l’utilisation d’autres informations d’identification.

Exemples

Exemple 1 : Démarrer un processus qui utilise des valeurs par défaut

Cet exemple démarre un processus qui utilise le Sort.exe fichier dans le dossier actif. La commande utilise toutes les valeurs par défaut, notamment le style de fenêtre par défaut, le dossier de travail et les informations d’identification.

Start-Process -FilePath "sort.exe"

Exemple 2 : Imprimer un fichier texte

Cet exemple démarre un processus qui imprime le C:\PS-Test\MyFile.txt fichier.

Start-Process -FilePath "myfile.txt" -WorkingDirectory "C:\PS-Test" -Verb Print

Exemple 3 : Démarrer un processus pour trier les éléments dans un nouveau fichier

Cet exemple démarre un processus qui trie les éléments dans le TestSort.txt fichier et retourne les éléments triés dans les Sorted.txt fichiers. Toutes les erreurs sont écrites dans le SortError.txt fichier. Le paramètre UseNewEnvironment spécifie que le processus s’exécute avec ses propres variables d’environnement.

$processOptions = @{
    FilePath = "sort.exe"
    RedirectStandardInput = "TestSort.txt"
    RedirectStandardOutput = "Sorted.txt"
    RedirectStandardError = "SortError.txt"
    UseNewEnvironment = $true
}
Start-Process @processOptions

Cet exemple utilise la mise en forme pour passer des paramètres à l’applet de commande. Pour plus d’informations, consultez about_Splatting.

Exemple 4 : Démarrer un processus dans une fenêtre agrandie

Cet exemple démarre le Notepad.exe processus. Elle agrandit la fenêtre et la conserve tant que l'exécution du processus n'est pas terminée.

Start-Process -FilePath "notepad" -Wait -WindowStyle Maximized

Exemple 5 : Démarrer PowerShell en tant qu’administrateur

Cet exemple démarre PowerShell à l’aide de l’option Exécuter en tant qu’administrateur .

Start-Process -FilePath "powershell" -Verb RunAs

Exemple 6 : Utilisation de verbes différents pour démarrer un processus

Cet exemple montre comment rechercher les verbes qui peuvent être utilisés lors du démarrage d’un processus. Les verbes disponibles sont déterminés par l’extension de nom de fichier du fichier qui s’exécute dans le processus.

$startExe = New-Object System.Diagnostics.ProcessStartInfo -Args powershell.exe
$startExe.verbs

open
runas
runasuser

L’exemple utilise New-Object pour créer un objet System.Diagnostics.ProcessStartInfo pour powershell.exe, le fichier qui s’exécute dans le processus PowerShell. La propriété Verbs de l’objet ProcessStartInfo montre que vous pouvez utiliser les verbes et RunAs Open avec powershell.exe, ou avec n’importe quel processus qui exécute un .exe fichier.

Exemple 7 : Spécification d’arguments au processus

Les deux commandes démarrent l’interpréteur de commandes Windows, en émettant une dir commande sur le Program Files dossier. Étant donné que ce nom de dossier contient un espace, la valeur doit être entourée de guillemets échapés. Notez que la première commande spécifie une chaîne en tant qu’ArgumentList. La deuxième commande est un tableau de chaînes.

Start-Process -FilePath "$env:comspec" -ArgumentList "/c dir `"%SystemDrive%\Program Files`""
Start-Process -FilePath "$env:comspec" -ArgumentList "/c","dir","`"%SystemDrive%\Program Files`""

Exemple 8 : Créer un processus détaché sur Linux

Sur Windows, Start-Process crée un processus indépendant qui reste en cours d’exécution indépendamment de l’interpréteur de commandes de lancement. Sur les plateformes non-Windows, le processus nouvellement démarré est attaché à l’interpréteur de commandes lancé. Si l’interpréteur de commandes de lancement est fermé, le processus enfant est arrêté.

Pour éviter de mettre fin au processus enfant sur des plateformes de type Unix, vous pouvez combiner Start-Process avec nohup. L’exemple suivant lance une instance en arrière-plan de PowerShell sur Linux qui reste active même après avoir fermé la session de lancement. La nohup commande collecte la sortie dans le fichier nohup.out dans le répertoire actif.

# Runs for 2 minutes and appends output to ./nohup.out
Start-Process nohup 'pwsh -noprofile -c "1..120 | % { Write-Host . -NoNewline; sleep 1 }"'

Dans cet exemple, Start-Process exécute la commande Linux nohup , qui se lance pwsh en tant que processus détaché. Pour plus d’informations, consultez l’article nohup sur Wikipédia.

Exemple 9 : Substitution d’une variable d’environnement pour un processus

Par défaut, lorsque vous utilisez Start-Process, le nouveau processus est créé avec les mêmes variables d’environnement que la session active. Vous pouvez utiliser le paramètre Environnement pour remplacer les valeurs de ces variables.

Dans cet exemple, la variable FOO d’environnement est ajoutée à la session avec foo la valeur.

L’exemple s’exécute Start-Process trois fois, retournant la valeur de FOO chaque fois. La première commande ne remplace pas la variable d’environnement. Dans la deuxième commande, FOO est définie sur bar. Dans la troisième commande, FOO est définie sur $null, ce qui le supprime.

$env:FOO = 'foo'
Start-Process pwsh -NoNewWindow -ArgumentList '-c', '$env:FOO'
Start-Process pwsh -NoNewWindow -ArgumentList '-c', '$env:FOO' -Environment @{
    FOO  = 'bar'
}
Start-Process pwsh -NoNewWindow -ArgumentList '-c', '$env:FOO' -Environment @{
    FOO  = $null
}

foo
bar

Paramètres

-ArgumentList

-Confirm

-Credential

-Environment

-FilePath

-LoadUserProfile

-NoNewWindow

-PassThru

-RedirectStandardError

-RedirectStandardInput

-RedirectStandardOutput

-UseNewEnvironment

-Verb

-Wait

-WhatIf

-WindowStyle

-WorkingDirectory

Entrées

None

Vous ne pouvez pas diriger les objets vers cette applet de commande.

Sorties

None

Par défaut, cette applet de commande ne retourne aucune sortie.

Process

Lorsque vous utilisez le paramètre PassThru , cette applet de commande retourne un objet Process .

Notes

PowerShell inclut les alias suivants pour Start-Process:

• Toutes les plateformes
  • saps
• Windows
  • start

Les commandes natives sont des fichiers exécutables installés dans le système d’exploitation. Ces exécutables peuvent être exécutés à partir de n’importe quel interpréteur de commandes, comme PowerShell. En général, vous exécutez la commande exactement comme vous le feriez dans bash ou cmd.exe. L’applet Start-Process de commande peut être utilisée pour exécuter toutes les commandes natives, mais ne doit être utilisée que lorsque vous devez contrôler la façon dont la commande est exécutée.

Start-Process est utile pour exécuter des programmes GUI sur des plateformes non Windows. Par exemple, exécutez Start-Process gedit pour lancer l’éditeur de texte graphique commun aux environnements de bureau GNOME.

Par défaut, Start-Process lance un processus de façon asynchrone. Le contrôle est retourné instantanément à PowerShell même si le nouveau processus est toujours en cours d’exécution.

• Sur le système local, le processus lancé vit indépendamment du processus d’appel.
• Sur un système distant, le nouveau processus est arrêté lorsque la session distante se termine immédiatement après la Start-Process commande. Par conséquent, vous ne pouvez pas utiliser Start-Process dans une session distante s’attendant à ce que le processus lancé expire la session.

Si vous devez utiliser Start-Process dans une session distante, appelez-le avec le paramètre Wait . Vous pouvez également utiliser d’autres méthodes pour créer un processus sur le système distant.

Lorsque vous utilisez le paramètre Wait , Start-Process attend que l’arborescence de processus (le processus et tous ses descendants) se termine avant de retourner le contrôle. Cela est différent du comportement de l’applet Wait-Process de commande, qui attend uniquement que les processus spécifiés se terminent.

Sur Windows, le cas Start-Process d’usage le plus courant consiste à utiliser le paramètre Wait pour bloquer la progression jusqu’à ce que le nouveau processus se termine. Sur le système non-Windows, cela est rarement nécessaire, car le comportement par défaut pour les applications en ligne de commande est équivalent à Start-Process -Wait.

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 Process.Start, méthode.

Liens associés

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