Push-Location

Push-Location
    [[-Path] <String>]
    [-PassThru]
    [-StackName <String>]
    [-UseTransaction]
    [<CommonParameters>]

Push-Location
    [-LiteralPath <String>]
    [-PassThru]
    [-StackName <String>]
    [-UseTransaction]
    [<CommonParameters>]

L’applet de commande Push-Location ajoute (« push ») l’emplacement actuel sur une pile d’emplacements. Si vous spécifiez un chemin d’accès, Push-Location envoie (push) l’emplacement actuel sur une pile d’emplacements, puis remplace l’emplacement actuel par l’emplacement spécifié par le chemin d’accès. Vous pouvez utiliser l’applet de commande Pop-Location pour obtenir des emplacements à partir de la pile d’emplacements.

Par défaut, l’applet de commande Push-Location envoie (push) l’emplacement actuel sur la pile d’emplacements actuelle, mais vous pouvez utiliser le paramètre StackName pour spécifier une autre pile d’emplacements. Si la pile n’existe pas, Push-Location la crée.

Pour plus d’informations sur les piles d’emplacements, consultez les notes.

Cet exemple envoie (push) l’emplacement actuel sur la pile d’emplacements par défaut, puis remplace l’emplacement par C:\Windows.

PS C:\> Push-Location C:\Windows

Cet exemple envoie (push) l’emplacement actuel sur la pile RegFunction et remplace l’emplacement actuel par l’emplacement HKLM:\Software\Policies.

PS C:\> Push-Location HKLM:\Software\Policies -StackName RegFunction

Vous pouvez utiliser les applets de commande Location dans n’importe quel lecteur PowerShell (PSDrive).

Cette commande envoie (push) l’emplacement actuel sur la pile par défaut. Il ne modifie pas l’emplacement.

PS C:\> Push-Location

Ces commandes montrent comment créer et utiliser une pile d’emplacements nommés.

PS C:\> Push-Location ~ -StackName Stack2
PS C:\Users\User01> Pop-Location -StackName Stack2
PS C:\>

La première commande envoie (push) l’emplacement actuel sur une nouvelle pile nommée Stack2, puis remplace l’emplacement actuel par le répertoire de base, qui est représenté dans la commande par le symbole tilde (~) (identique à $env:USERPROFILE ou $HOME).

Si Stack2 n’existe pas déjà dans la session, Push-Location la crée. La deuxième commande utilise l’applet de commande Pop-Location pour afficher l’emplacement d’origine (PS C :\>) à partir de la pile Stack2. Sans le paramètre StackName, Pop-Location pop the location from the unnamed default stack.

Pour plus d’informations sur les piles d’emplacement, veuillez consulter la section Notes.

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.

Vous pouvez diriger une chaîne qui contient un chemin d’accès (mais pas un chemin littéral) pour Push-Location.

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.

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 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 Emplacement PowerShell, 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.

• 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, Push-Location 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 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 Push-Location ou Pop-Location applets de commande ajouter ou obtenir des éléments à partir de la pile par défaut ou utiliser Get-Location 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 de commande Set-Location avec une valeur de $null ou une chaîne vide ( » « ).

Vous pouvez également faire référence à Push-Location par son alias intégré, pushd. Pour plus d’informations, consultez about_Aliases.

L’applet de commande Push-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.