Pop-Location
Définit l'emplacement actuel sur le dernier emplacement placé sur la pile.
Syntax
Pop-Location
[-PassThru]
[-StackName <String>]
[<CommonParameters>]
Description
L’applet Pop-Location
de commande remplace l’emplacement actuel par l’emplacement le plus récemment envoyé sur la pile à l’aide de l’applet Push-Location
de commande. Vous pouvez afficher un emplacement à partir de la pile par défaut ou d’une pile que vous créez à l’aide d’une Push-Location
commande.
Exemples
Exemple 1 : Passer à l’emplacement le plus récent
PS C:\> Pop-Location
Cette commande définit l'emplacement sur le dernier emplacement ajouté à la pile active.
Exemple 2 : Passer à l’emplacement le plus récent dans une pile nommée
PS C:\> Pop-Location -StackName "Stack2"
Cette commande définit l'emplacement sur le dernier emplacement ajouté à la pile d'emplacements Stack2.
Pour plus d’informations sur les piles d’emplacements, consultez notes.
Exemple 3 : Passer d’un emplacement à l’autre pour différents fournisseurs
PS C:\> pushd HKLM:\Software\Microsoft\PowerShell
PS HKLM:\Software\Microsoft\PowerShell> pushd Cert:\LocalMachine\TrustedPublisher
PS cert:\LocalMachine\TrustedPublisher> popd
PS HKLM:\Software\Microsoft\PowerShell> popd
PS C:\>
Ces commandes utilisent les applets de Push-Location
commande et Pop-Location
pour se déplacer entre des emplacements pris en charge par différents fournisseurs PowerShell. Les commandes utilisent l’alias pushd
pour Push-Location
et l’alias popd
pour Pop-Location
.
La première commande envoie (push) l’emplacement actuel du système de fichiers sur la pile et se déplace vers le lecteur HKLM pris en charge par le fournisseur PowerShell Registry.
La deuxième commande envoie (push) l’emplacement du Registre sur la pile et se déplace vers un emplacement pris en charge par le fournisseur de certificats PowerShell.
Les deux dernières commandes extraient ces emplacements de la pile. La première popd
commande retourne au lecteur du Registre, et la deuxième commande retourne au lecteur du système de fichiers.
Paramètres
-PassThru
Transmet un objet qui représente l’emplacement au pipeline. Par défaut, cette applet de commande ne génère aucun résultat.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-StackName
Spécifie la pile d'emplacements à partir de laquelle l'emplacement est extrait. Entrez un nom de pile d'emplacements.
Sans ce paramètre, Pop-Location
affiche un emplacement à partir de la pile d’emplacements actuelle. Par défaut, la pile d’emplacements actuelle est la pile d’emplacements par défaut sans nom que PowerShell crée. Pour faire d’une pile d’emplacements la pile d’emplacements actuelle, utilisez le paramètre StackName de l’applet Set-Location
de commande. Pour plus d’informations sur les piles d’emplacements, consultez notes.
Pop-Location
impossible d’afficher un emplacement à partir de la pile par défaut sans nom, sauf s’il s’agit de la pile d’emplacements actuelle.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Entrées
None
Vous ne pouvez pas diriger d’objets vers cette applet de commande.
Sorties
None
Par défaut, cette applet de commande ne retourne aucune sortie.
Lorsque vous utilisez le paramètre PassThru , cette applet de commande retourne un objet PathInfo représentant le chemin d’accès actuel après l’opération de l’applet de commande.
Notes
PowerShell inclut les alias suivants pour Pop-Location
:
- Toutes les plateformes :
popd
PowerShell prend en charge plusieurs runspaces par processus. Chaque runspace a son propre répertoire actif.
Ce n’est pas la même chose 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’annuaire 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 runspace 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’espace d’exécution actuel.
Une pile est une liste de derniers entrants dans laquelle seul l’élément le plus récemment ajouté est accessible. Vous ajoutez des éléments à une pile dans l'ordre dans lequel vous les utilisez, puis les récupérez pour une utilisation dans l'ordre inverse. PowerShell vous permet de stocker des emplacements de fournisseur dans des piles d’emplacements.
PowerShell crée une pile d’emplacements par défaut sans nom et 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 de Set-Location
commande pour modifier la pile d’emplacements actuelle.
Pour gérer les piles d’emplacements, utilisez les applets de commande PowerShell *-Location
, 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 de
Pop-Location
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 l’applet
Get-Location
de commande.Pour créer une pile d’emplacements, utilisez le paramètre StackName de l’applet
Push-Location
de commande. Si vous spécifiez une pile qui n’existe pas,Push-Location
crée la pile.Pour faire d’une pile d’emplacements la pile d’emplacements actuelle, utilisez le paramètre StackName de l’applet
Set-Location
de commande.
La pile d'emplacements par défaut sans nom n'est entièrement accessible que s'il s'agit de la pile d'emplacements active.
Si vous faites d’une pile d’emplacements nommés la pile d’emplacements actuelle, vous ne pouvez plus utiliser les Push-Location
applets de commande ou Pop-Location
pour ajouter ou obtenir des éléments de la pile par défaut ou utiliser l’applet Get-Location
de commande pour afficher les emplacements dans la pile sans nom. Pour que la pile sans nom soit la pile actuelle, utilisez le paramètre StackName de l’applet Set-Location
de $Null
commande avec la valeur ou une chaîne vide (""
).
Vous pouvez également faire référence à par Pop-Location
son alias intégré, popd
. Pour plus d’informations, consultez about_Aliases.
Pop-Location
est conçu 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, consultez about_Providers.