Pop-Location
Définit l'emplacement actuel sur le dernier emplacement placé sur la pile. Vous pouvez extraire l'emplacement à partir de la pile par défaut ou d'une pile créée à l'aide de l'applet de commande Push-Location.
Syntaxe
Pop-Location [-PassThru] [-StackName <string>] [-UseTransaction] [<CommonParameters>]
Description
L'applet de commande Pop-Location définit l'emplacement actuel sur le dernier emplacement placé sur la pile en utilisant l'applet de commande Push-Location. Vous pouvez extraire un emplacement à partir de la pile par défaut ou d'une pile créée à l'aide d'une commande Push-Location.
Paramètres
-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 |
-StackName <string>
Spécifie une autre pile. Pop-Location dépile le dernier emplacement qui y a été ajouté. Cette pile devient alors la pile actuelle.
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 |
None Vous ne pouvez pas diriger d'entrée vers Pop-Location. |
Sorties |
Aucun ou System.Management.Automation.PathInfo Lorsque vous utilisez le paramètre PassThru, Pop-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 à Pop-Location à l'aide de son alias intégré, « popd ». Pour plus d'informations, consultez about_Aliases.
L'applet de commande Pop-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>pop-location
Description
-----------
Cette commande définit l'emplacement sur le dernier emplacement ajouté à la pile actuelle.
Exemple 2
C:\PS>pop-location -stackname Stack2
Description
-----------
Cette commande définit l'emplacement sur le dernier emplacement ajouté à la pile Stack2.
Exemple 3
C:\PS>pushd HKLM:\Software\Microsoft\PowerShell
pushd Cert:\LocalMachine\TrustedPublisher
popd
popd
PS C:\> push-location HKLM:\Software\Microsoft\PowerShell
PS HKLM:\Software\Microsoft\PowerShell> push-location Cert:\LocalMachine\TrustedPublisher
PS cert:\LocalMachine\TrustedPublisher> popd
PS HKLM:\Software\Microsoft\PowerShell> popd
PS C:\ps-test>
Description
-----------
Ces commandes utilisent les applets de commande Push-Location et Pop-Location pour basculer entre des emplacements pris en charge par différents fournisseurs de Windows PowerShell. Les commandes utilisent l'alias « pushd » pour Push-Location et l'alias « popd » pour Pop-Location.
La première commande place l'emplacement du système de fichiers actuel sur la pile, puis bascule vers le lecteur HKLM pris en charge par le fournisseur Registry de Windows PowerShell. La deuxième commande place l'emplacement de Registre sur la pile, puis bascule vers un emplacement pris en charge par le fournisseur de certificats de Windows PowerShell.
Les deux dernières commandes retirent ces emplacements de la pile. La première commande « popd » retourne au lecteur Registry: et la deuxième commande retourne au lecteur de système de fichiers.