Set-Location

Module:
Microsoft.PowerShell.Management Module

Définit l’emplacement de travail actuel à un emplacement spécifié.

Syntaxe

Path (Par défaut) 

Set-Location
    [[-Path] <String>]
    [-PassThru]
    [<CommonParameters>]

LiteralPath 

Set-Location
    -LiteralPath <String>
    [-PassThru]
    [<CommonParameters>]

Stack 

Set-Location
    [-PassThru]
    [-StackName <String>]
    [<CommonParameters>]

Description

L’applet Set-Location de commande définit l’emplacement de travail à un emplacement spécifié. Il peut s’agir d’un répertoire, d’un sous-répertoire, d’un emplacement de Registre ou d’un chemin d’accès de fournisseur.

PowerShell 6.2 a ajouté la prise en charge et -+ en tant que valeurs pour le paramètre Path . PowerShell conserve un historique des 20 derniers emplacements accessibles avec - et +. Cette liste est indépendante de la pile d’emplacements accessible à l’aide du paramètre StackName .

Exemples

Exemple 1 : Définir l’emplacement actuel

PS C:\> Set-Location -Path "HKLM:\"
PS HKLM:\>

Cette commande définit l’emplacement actuel à la racine du HKLM: lecteur.

Exemple 2 : Définir l’emplacement actuel et afficher cet emplacement

PS C:\> Set-Location -Path "Env:\" -PassThru

Path
----
Env:\

PS Env:\>

Cette commande définit l’emplacement actuel à la racine du Env: lecteur. Il utilise le paramètre PassThru pour diriger PowerShell pour renvoyer un objet PathInfo qui représente l’emplacement Env:\ .

Exemple 3 : Définir l’emplacement sur l’emplacement actuel dans le lecteur C :

PS C:\Windows\> Set-Location HKLM:\
PS HKLM:\> Set-Location C:
PS C:\Windows\>

La première commande définit l’emplacement à la racine du HKLM: lecteur dans le fournisseur de Registre. La deuxième commande définit l’emplacement sur l’emplacement actuel du C: lecteur dans le fournisseur FileSystem. Lorsque le nom du lecteur est spécifié dans le formulaire <DriveName>: (sans barre oblique inverse), l’applet de commande définit l’emplacement sur l’emplacement actuel dans PSDrive. Pour obtenir l’emplacement actuel dans la commande PSDrive utiliser Get-Location -PSDrive <DriveName> .

Exemple 4 : Définir l’emplacement actuel sur une pile nommée

PS C:\> Push-Location -Path 'C:\Program Files\PowerShell\' -StackName "Paths"
PS C:\Program Files\PowerShell\> Set-Location -StackName "Paths"
PS C:\Program Files\PowerShell\> Get-Location -Stack

Path
----
C:\

La première commande ajoute l’emplacement actuel à la pile Chemins d’accès. La deuxième commande rend la pile d’emplacements chemins d’accès à la pile d’emplacements actuelle. La troisième commande affiche les emplacements dans la pile d’emplacements actuelle.

Les *-Location applets de commande utilisent la pile d’emplacements actuelle, sauf si une autre pile d’emplacements est spécifiée dans la commande. Pour plus d’informations sur les piles d’emplacements, consultez les notes.

Exemple 5 : Naviguer dans l’historique des emplacements à l’aide de « + » ou « - »

PS C:\> Set-Location -Path $Env:SystemRoot
PS C:\Windows> Set-Location -Path Cert:\
PS Cert:\> Set-Location -Path HKLM:\
PS HKLM:\>

# Navigate back through the history using "-"
PS HKLM:\> Set-Location -Path -
PS Cert:\> Set-Location -Path -
PS C:\Windows>

# Navigate using the Set-Location alias "cd" and the implicit positional Path parameter
PS C:\Windows> cd -
PS C:\> cd +
PS C:\Windows> cd +
PS Cert:\>

L’utilisation de l’alias cd - ou cd + est un moyen simple de parcourir l’historique de votre emplacement dans votre terminal. Pour plus d’informations sur la navigation avec -/+, consultez le paramètre Path .

Paramètres

-LiteralPath

Spécifie un chemin d’accès de l’emplacement. La valeur du paramètre LiteralPath est utilisée exactement comme il est typé. Aucun caractère n'est interprété en tant que caractère générique. Si le chemin d’accès inclut des caractères d’échappement, mettez-le entre des guillemets simples. Les guillemets simples indiquent à PowerShell de ne pas interpréter de caractères comme séquences d’échappement.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:PSPath, DP

Jeux de paramètres

LiteralPath
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-PassThru

Renvoie un objet PathInfo qui représente l’emplacement. Par défaut, cette applet de commande ne génère aucune sortie.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Path

Spécifiez le chemin d’accès d’un nouvel emplacement de travail. Si aucun chemin d’accès n’est fourni, Set-Location la valeur par défaut est le répertoire de base de l’utilisateur actuel. Lorsque des caractères génériques sont utilisés, l’applet de commande choisit le conteneur (répertoire, clé de Registre, magasin de certificats) qui correspond au modèle générique. Si le modèle générique correspond à plusieurs conteneurs, l’applet de commande retourne une erreur.

PowerShell conserve un historique des 20 derniers emplacements que vous avez définis. Si la valeur du paramètre Path est le - caractère, le nouvel emplacement de travail sera l’emplacement de travail précédent dans l’historique (s’il existe). De même, si la valeur est le + caractère, le nouvel emplacement de travail sera l’emplacement de travail suivant dans l’historique (s’il existe). Ceci est similaire à l’utilisation Pop-Location et Push-Location sauf que l’historique est une liste, pas une pile et est implicitement suivi, pas contrôlé manuellement. Il n’existe aucun moyen d’afficher la liste d’historiques.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:True
DontShow:False

Jeux de paramètres

Path
Position:0
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-StackName

Spécifie un nom de pile d’emplacements existant que cette applet de commande rend la pile d’emplacements actuelle. Entrez un nom de pile d’emplacements. Pour indiquer la pile d’emplacements par défaut sans nom, tapez $null ou une chaîne vide ("").

L’utilisation de ce paramètre ne modifie pas l’emplacement actuel. Elle modifie uniquement la pile utilisée par les *-Location applets de commande. Les *-Location applets de commande agissent sur la pile actuelle, sauf si vous utilisez le paramètre StackName pour spécifier une autre pile. Pour plus d’informations sur les piles d’emplacements, consultez les notes.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

Stack
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

String

Vous pouvez diriger une chaîne qui contient un chemin d’accès, mais pas un chemin littéral, vers cette applet de commande.

Sorties

None

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

PathInfo

Lorsque vous utilisez le paramètre PassThru avec Path ou LiteralPath, cette applet de commande retourne un objet PathInfo représentant le nouvel emplacement.

PathInfoStack

Lorsque vous utilisez le paramètre PassThru avec StackName, cette applet de commande retourne un objet PathInfoStack représentant le nouveau contexte de pile.

Notes

PowerShell inclut les alias suivants pour Set-Location:

  • Toutes les plateformes :
    • cd
    • chdir
    • sl

PowerShell prend en charge plusieurs runspaces par processus. Chaque instance d’exécution a son propre répertoire actif . Ce n’est pas le même que [System.Environment]::CurrentDirectory. Ce comportement peut être un problème lors de l’appel d’API .NET ou de l’exécution d’applications natives sans fournir de chemins d’accès de répertoire explicites.

Même si les applets de commande d’emplacement ont défini le répertoire actif à l’échelle du processus, vous ne pouvez pas en dépendre, car un autre espace d’exécution peut le modifier à tout moment. Vous devez utiliser les applets de commande d’emplacement pour effectuer des opérations basées sur le chemin à l’aide du répertoire de travail actuel spécifique à l’instance d’exécution actuelle.

L’applet de commande Set-Location est conçue pour fonctionner avec les données exposées par n’importe quel fournisseur. Pour répertorier les fournisseurs disponibles dans votre session, tapez Get-PSProvider. Pour plus d’informations, voir about_Providers.

Une pile est une liste de dernière entrée et de première sortie dans laquelle seul l’élément ajouté le plus récemment est accessible. Vous ajoutez des éléments à une pile dans l’ordre dans lequel vous les utilisez, puis récupérez-les pour une utilisation dans l’ordre inverse. PowerShell vous permet de stocker des emplacements de fournisseur dans les piles d’emplacements. PowerShell crée une pile d’emplacements par défaut sans nom. Vous pouvez créer plusieurs piles d’emplacements nommés. Si vous ne spécifiez pas de nom de pile, PowerShell utilise la pile d’emplacements actuelle. Par défaut, l’emplacement par défaut sans nom est la pile d’emplacements actuelle, mais vous pouvez utiliser l’applet Set-Location de commande pour modifier la pile d’emplacements actuelle.

Pour gérer les piles d’emplacements, utilisez les *-Location applets de commande, comme suit :

  • Pour ajouter un emplacement à une pile d’emplacements, utilisez l’applet de Push-Location commande.

  • Pour obtenir un emplacement à partir d’une pile d’emplacements, utilisez l’applet Pop-Location de commande.

  • Pour afficher les emplacements dans la pile d’emplacements actuelle, utilisez le paramètre Stack de l’applet Get-Location de commande. Pour afficher les emplacements dans une pile d’emplacements nommée, utilisez le paramètre StackName de Get-Location.

  • Pour créer une pile d’emplacements, utilisez le paramètre StackName de Push-Location. Si vous spécifiez une pile qui n’existe pas, Push-Location crée la pile.

  • Pour créer une pile d’emplacements, utilisez le paramètre StackName de Set-Location.

La pile d’emplacements par défaut sans nom est entièrement accessible uniquement lorsqu’il s’agit de la pile d’emplacements actuelle. Si vous créez une pile d’emplacements nommés dans la pile d’emplacements actuelle, vous ne pouvez plus utiliser les applets de commande ou Pop-Location les Push-Location applets de commande pour ajouter ou obtenir des éléments à partir de la pile par défaut ou utiliser l’applet Get-Location de commande pour afficher les emplacements dans la pile sans nom. Pour rendre la pile sans nom dans la pile actuelle, utilisez le paramètre StackName de l’applet Set-Location de commande avec une valeur ou $null une chaîne vide ("").