Push-Location

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

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

Командлет Push-Location добавляет ("отправляет") текущее расположение в стек расположений. Если указать путь, Push-Location отправляет текущее расположение в стек расположений, а затем изменяет текущее расположение на расположение, указанное путем. Командлет Pop-Location можно использовать для получения расположений из стека расположений.

По умолчанию командлет Push-Location отправляет текущее расположение в текущий стек расположений, но можно использовать параметр StackName для указания альтернативного стека расположений. Если стек не существует, Push-Location создает его.

Дополнительные сведения о стеках расположений см. в заметках.

Этот пример отправляет текущее расположение в стек расположений по умолчанию, а затем изменяет расположение на C:\Windows.

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

Этот пример отправляет текущее расположение в стек RegFunction и изменяет текущее расположение в HKLM:\Software\Policies расположении.

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

Командлеты location можно использовать в любом диске PowerShell (PSDrive).

Эта команда отправляет текущее расположение в стек по умолчанию. Он не изменяет расположение.

PS C:\> Push-Location

Эти команды показывают, как создать и использовать именованный стек расположений.

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

Первая команда отправляет текущее расположение в новый стек с именем Stack2, а затем изменяет текущее расположение в домашний каталог, представленный в команде символом тильды (~), который при использовании на дисках поставщика файловой системы эквивалентен $HOME.

Если Stack2 еще не существует в сеансе, Push-Location создает его. Вторая команда использует командлет Pop-Location, чтобы открыть исходное расположение (C:\) из стека Stack2. Без параметра StackNamePop-Location появится расположение из неназванного стека по умолчанию.

Дополнительные сведения о стеках расположений см. в заметках.

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Можно передать строку, содержащую путь (но не литеральный путь) к этому командлету.

По умолчанию этот командлет не возвращает выходные данные.

При использовании параметра PassThru этот командлет возвращает объект PathInfo, представляющий текущий путь после операции командлета.

PowerShell включает следующие псевдонимы для Push-Location:

• Все платформы:
  • pushd

PowerShell поддерживает несколько пространств выполнения для каждого процесса. Каждое рабочее пространство имеет собственный текущий каталог. Это не то же самое, что и [System.Environment]::CurrentDirectory. Это может быть проблема при вызове API .NET или выполнении собственных приложений, не предоставляя явные пути к каталогу.

Даже если командлеты расположения установили текущий каталог на уровне процесса, вы не можете зависеть от него, так как другое пространство выполнения может изменить его в любое время. Командлеты расположения следует использовать для выполнения операций на основе пути с помощью текущего рабочего каталога, относяющегося к текущему пространству выполнения.

Стек — это последний, первый список, в котором доступен только последний добавленный элемент. Вы добавляете элементы в стек в порядке их использования, а затем извлекаете их для использования в обратном порядке. PowerShell позволяет хранить расположения поставщиков в стеках расположений.

PowerShell создает неименованный стек расположений по умолчанию, и вы можете создать несколько именованных стеков расположений. Если имя стека не указано, PowerShell использует текущий стек расположений. По умолчанию неназванное расположение по умолчанию — это текущий стек расположений, но можно использовать командлет Set-Location для изменения текущего стека расположений.

Для управления стеками расположений используйте командлеты расположения PowerShell, как показано ниже.

• Чтобы добавить расположение в стек расположений, используйте командлет Push-Location.

• Чтобы получить расположение из стека расположений, используйте командлет Pop-Location.

• Чтобы отобразить расположения в текущем стеке расположений, используйте параметр Stack командлета Get-Location.

• Чтобы отобразить расположения в именованном стеке расположений, используйте параметр StackName командлета Get-Location.

• Чтобы создать стек расположений, используйте параметр StackName командлета Push-Location. Если указать стек, который не существует, Push-Location создает стек.

• Чтобы сделать стек расположения текущим стеком расположений, используйте параметр StackName командлета Set-Location.

Неименованный стек расположений по умолчанию полностью доступен только в том случае, если он является текущим стеком расположений. Если создать стек именованных расположений в текущем стеке расположений, вы больше не сможете использовать командлеты Push-Location или Pop-Location для добавления или получения элементов из стека по умолчанию или использования командлета Get-Location для отображения расположений в неназванном стеке. Чтобы сделать неименованный стек текущим стеком, используйте параметр StackName командлета Set-Location со значением $null или пустой строкой ("").

Вы также можете ссылаться на Push-Location по встроенному псевдониму, pushd. Дополнительные сведения см. в about_Aliases.

Командлет Push-Location предназначен для работы с данными, предоставляемыми любым провайдером. Чтобы вывести список поставщиков, доступных в сеансе, введите Get-PSProvider. Дополнительные сведения см. в разделе о поставщиках.