Ajoute l'emplacement actuel au sommet d'une liste d'emplacements (appelée « pile »).
Syntaxe
Push-Location [[-LiteralPath] <string>] [-PassThru] [-StackName <string>] [-UseTransaction] [<CommonParameters>] Push-Location [[-Path] <string>] [-PassThru] [-StackName <string>] [-UseTransaction] [<CommonParameters>]
Description
L'applet de commande Push-Location ajoute (« place ») l'emplacement actuel au sommet d'une liste d'emplacements appelée « pile ». Vous pouvez placer l'emplacement actuel sur une pile par défaut ou sur une pile que vous créez. Si vous spécifiez un chemin d'accès, Push-Location place l'emplacement actuel sur la pile, puis bascule vers l'emplacement actuel par le chemin d'accès. Vous ne pouvez placer un emplacement sur la pile que s'il s'agit de l'emplacement actuel.
Paramètres
-LiteralPath <string>
Spécifie le chemin d'accès au nouvel emplacement. Contrairement au paramètre Path, la valeur du paramètre LiteralPath est utilisée exactement telle que vous la tapez. 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 à Windows PowerShell qu'aucun caractère ne doit être interprété en tant que séquence d'échappement.
|
Obligatoire ? |
false |
|
Position ? |
1 |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
true (ByPropertyName) |
|
Accepter les caractères génériques ? |
false |
-PassThru
Passe un objet représentant l'emplacement au pipeline. Par défaut, cette applet de commande ne génère aucune sortie.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-Path <string>
Définit votre emplacement sur l'emplacement spécifié par ce chemin d'accès après avoir (ajouté) placé l'emplacement actuel au sommet de la pile. Entrez un chemin d'accès à n'importe quel emplacement dont le fournisseur prend en charge cette applet de commande. Les caractères génériques sont autorisés. Le nom de paramètre (« Path ») est facultatif.
|
Obligatoire ? |
false |
|
Position ? |
1 |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
true (ByValue, ByPropertyName) |
|
Accepter les caractères génériques ? |
false |
-StackName <string>
Spécifie le nom de la pile. L'emplacement actuel est placé sur cette pile et la pile devient la pile actuelle. Si la pile n'existe pas, elle est créée.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
true (ByPropertyName) |
|
Accepter les caractères génériques ? |
false |
-UseTransaction
Inclut la commande dans la transaction active. Ce paramètre est valide uniquement lorsqu'une transaction est en cours. Pour plus d'informations, consultez about_Transactions.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
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 |
System.String Vous pouvez diriger une chaîne qui contient un chemin d'accès (mais pas un chemin d'accès littéral) vers Push-Location. |
|
Sorties |
Aucun ou System.Management.Automation.PathInfo Lorsque vous utilisez le paramètre PassThru, Push-Location génère un objet System.Management.Automation.PathInfo qui représente l'emplacement. Sinon, cette applet de commande ne génère aucune sortie. |
Remarques
Vous pouvez également faire référence à Push-Location à l'aide de son alias intégré, « pushd ». Pour plus d'informations, consultez about_Aliases.
Une « pile » est une structure de données de type « dernier entré premier sorti » (LIFO, Last-In First-Out). Elle est comparable à une liste verticale dans laquelle seul l'élément situé tout en haut est accessible. Vous ne pouvez ajouter (« placer ») des éléments qu'au sommet de la pile et vous ne pouvez récupérer (« dépiler ») que l'élément situé au sommet de la pile. Pour obtenir les éléments qui se trouvent sous le sommet de la pile, vous devez récupérer tous les éléments qui se trouvent au-dessus.
L'applet de commande Push-Location est conçue pour utiliser 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, consultez about_Providers.
Exemple 1
C:\PS>push-location C:\Windows Description ----------- Cette commande place l'emplacement actuel sur la pile par défaut, puis définit l'emplacement sur C:\Windows.
Exemple 2
C:\PS>push-location HKLM:\Software\Policies -stackname RegFunction Description ----------- Cette commande place l'emplacement actuel sur la pile RegFunction, puis le bascule vers l'emplacement HKLM:\Software\Policies. Cette commande montre que vous pouvez utiliser Push-Location avec le fournisseur Registry de Windows PowerShell.
Exemple 3
C:\PS>push-location Description ----------- Cette commande place l'emplacement actuel sur la pile par défaut.
Exemple 4
C:\PS>push-location ~ -stackname Stack2 Description ----------- Cette commande place l'emplacement actuel sur une nouvelle pile nommée Stack2, puis le bascule vers le répertoire de base (%USERPROFILE%) qui est représenté par le symbole de tilde (~) ou $home dans la commande. La pile Stack2 devient alors la pile actuelle.
Voir aussi