HOWTO · PowerShell

Changer le répertoire de travail dans PowerShell

Cet article explique comment modifier correctement votre répertoire de travail dans Windows PowerShell et comment il se différencie de sa syntaxe d'invite de commande héritée.

Sur cette page

Utilisez l’applet de commande PowerShell Set-Location pour changer l’emplacement courant. Ses alias cd et chdir fonctionnent aussi, mais le nom complet de l’applet est plus explicite dans les scripts et les exemples. L’emplacement peut être un répertoire sur le lecteur courant ou un chemin sur un autre lecteur. Les exemples ci-dessous utilisent $HOME, que PowerShell définit comme le répertoire personnel de l’utilisateur courant.

Modifier le répertoire de travail avec Set-Location

Exécutez cet exemple pour définir le répertoire personnel comme emplacement courant :

Le code et les libellés ou sorties affichés dans cette section restent en anglais.

Set-Location -Path $HOME

Set-Location change l’emplacement courant de la session PowerShell. -Path indique la destination ; pour un chemin simple, ce paramètre peut être omis, mais le préciser rend le rôle de la commande plus clair. Cette commande ne lance pas un nouveau shell et ne change pas l’emplacement des autres programmes en cours d’exécution. L’exécution PowerShell fournie s’est terminée avec succès et n’a produit aucune sortie standard pour cet exemple. Le bloc de code et les libellés ou sorties qu’il affiche restent en anglais.

Changer de lecteur et de répertoire

PowerShell peut passer à un répertoire situé sur un autre lecteur avec une seule commande Set-Location. Par exemple, Set-Location -Path 'D:\Work' sélectionne ce chemin si le lecteur D: et le répertoire sont disponibles dans l’environnement PowerShell courant. Un lecteur peut être un lecteur du système de fichiers, comme C:, ou un autre lecteur exposé par un fournisseur PowerShell ; la destination doit exister et être accessible.

L’invite de commandes traite le changement de lecteur différemment. Exécuter cd D:\Work alors que le lecteur actif est C: modifie le répertoire mémorisé pour D:, mais ne fait pas de D: le lecteur actif. Dans l’invite de commandes, passez au lecteur avec D:, puis changez de répertoire avec cd \Work. Cette différence concerne l’invite de commandes ; dans PowerShell, utilisez Set-Location avec le chemin de destination pour changer de lecteur et de répertoire en une seule fois. Ces formes de l’invite de commandes sont expliquées dans le texte, car les exemples exécutables de cet article ciblent PowerShell.

Gérer les chemins contenant des espaces

Mettez un chemin entre guillemets si le nom d’un répertoire contient des espaces, afin que PowerShell le traite comme un seul argument. Les guillemets simples et doubles conviennent tous deux pour un chemin littéral. Par exemple, utilisez Set-Location -Path 'C:\Program Files' ou Set-Location -Path "C:\Program Files". Les guillemets simples sont pratiques lorsque le chemin doit être interprété littéralement ; les guillemets doubles permettent aussi à PowerShell de développer les variables présentes dans la chaîne. Le guide sur les chemins contenant des espaces n’est pas disponible en français. Remplacez le chemin d’exemple par un répertoire qui existe sur votre système.

Récupérer le nouvel emplacement avec -PassThru

En temps normal, Set-Location change l’emplacement de la session sans renvoyer d’objet d’emplacement. Ajoutez -PassThru si la commande suivante a besoin de cet objet, par exemple pour lire sa propriété Path ou le stocker dans une variable. Cela peut éviter d’appeler Get-Location séparément lorsque l’objet est immédiatement utile. Le bloc de code et les libellés ou sorties qu’il affiche restent en anglais.

$newLocation = Set-Location -Path $HOME -PassThru
$newLocation.Path
/root

La deuxième ligne lit le chemin dans l’objet d’emplacement renvoyé. Lors de l’exécution PowerShell fournie, cet exemple a affiché le chemin indiqué. Comme $HOME dépend de l’utilisateur courant et du système, votre chemin peut être différent. -PassThru est facultatif : utilisez Get-Location lorsque vous souhaitez consulter l’emplacement courant indépendamment, et n’ajoutez -PassThru que si l’objet renvoyé est utile aux commandes suivantes.

Utiliser les alias de Set-Location

PowerShell définit cd et chdir comme alias de Set-Location ; sl est un autre alias. Pour les commandes interactives, ces formes courtes peuvent être pratiques. Le nom complet de l’applet est généralement plus facile à reconnaître pour une autre personne qui lit un script ; considérez donc sl comme un raccourci facultatif, et non comme une commande au comportement différent. Toutes ces formes changent l’emplacement PowerShell courant et acceptent les mêmes chemins de destination, y compris ceux qui contiennent des espaces et sont placés entre guillemets.