Partager via


Pop-Location

Remplace l’emplacement actuel par l’emplacement le plus récemment envoyé sur la pile.

Syntaxe

Pop-Location
   [-PassThru]
   [-StackName <String>]
   [-UseTransaction]
   [<CommonParameters>]

Description

L’applet de commande pop-location modifie l’emplacement actuel par l’emplacement le plus récemment envoyé sur la pile à l’aide de l’applet de commande Push-Location. Vous pouvez afficher un emplacement à partir de la pile par défaut ou d’une pile que vous créez à l’aide d’une commande Push-Location.

Exemples

Exemple 1 : Passer à l’emplacement le plus récent

PS C:\> Pop-Location

Cette commande remplace votre emplacement par l’emplacement récemment ajouté à la pile actuelle.

Exemple 2 : Passer à l’emplacement le plus récent dans une pile nommée

PS C:\> Pop-Location -StackName "Stack2"

Cette commande remplace votre emplacement par l’emplacement récemment ajouté à la pile d’emplacements Stack2.

Pour plus d’informations sur les piles d’emplacements, consultez les 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 commande Push-Location et Pop-Location pour passer d’un emplacement à l’autre pris en charge par différents fournisseurs Windows PowerShell. Les commandes utilisent l’alias envoyé (push) pour d’emplacement push et l’alias de pop-location pour .

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 de Registre Windows PowerShell.

La deuxième commande envoie (push) l’emplacement du Registre sur la pile et passe à un emplacement pris en charge par le fournisseur de certificats Windows PowerShell.

Les deux dernières commandes affichent ces emplacements hors 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 aucune sortie.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-StackName

Spécifie la pile d’emplacements à partir de laquelle l’emplacement est dépilé. Entrez un nom de pile d’emplacements.

Sans ce paramètre, emplacement contextuel 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 non nommée créée par Windows PowerShell. Pour créer une pile d’emplacements, utilisez le paramètre StackName de Set-Location .

'emplacement contextuel ne peut pas 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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
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.

Type:SwitchParameter
Alias:usetx
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

None

Vous ne pouvez pas diriger l’entrée vers cette applet de commande.

Sorties

None, System.Management.Automation.PathInfo

Cette applet de commande génère un objet System.Management.Automation.PathInfo qui représente l’emplacement, si vous spécifiez le paramètre PassThru. Sinon, cette applet de commande ne génère aucune sortie.

Notes

  • 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. Windows PowerShell vous permet de stocker les emplacements des fournisseurs dans les piles d’emplacements.
  • Windows PowerShell vous permet de stocker les emplacements des fournisseurs dans les piles d’emplacements. Windows 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, Windows 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 commande Set-Location pour modifier la pile d’emplacements actuelle.
  • Pour gérer les piles d’emplacements, utilisez les applets de commande Windows PowerShellLocation, comme suit :
  • Pour ajouter un emplacement à une pile d’emplacements, utilisez l’applet de commande Push-Location.
  • Pour obtenir un emplacement à partir d’une pile d’emplacements, utilisez l’applet de commande Pop-Location.
  • Pour afficher les emplacements dans la pile d’emplacements actuelle, utilisez le paramètre Stack de l’applet de commande Get-Location .
  • Pour afficher les emplacements dans une pile d’emplacements nommés, utilisez le paramètre StackName de l’applet de commande Get-Location Get-Location.
  • Pour créer une pile d’emplacements, utilisez le paramètre StackName de l’applet de commande Push-Location. Si vous spécifiez une pile qui n’existe pas, 'emplacement push crée la pile.
  • Pour créer une pile d’emplacements, utilisez le paramètre StackName de l’applet de commande Set-Location .
  • La pile d’emplacements par défaut sans nom est entièrement disponible uniquement lorsqu’elle est 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 d’emplacement push ou applets de commande Pop-Location ajouter ou obtenir des éléments à partir de la pile par défaut ou utiliser une commande Get-Location pour afficher les emplacements dans la pile non nommée. Pour rendre la pile sans nom dans la pile actuelle, utilisez le paramètre StackName de set-Location avec une valeur de $Null ou une chaîne vide ( » « ).
  • Vous pouvez également faire référence à pop-Location par 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.