Меняет текущее местоположение на местоположение, указанное в последней записи стека. Запись с местоположением может быть извлечена как из стека, заданного по умолчанию, так и из стека, созданного с помощью командлета Push-Location.

Синтаксис

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

Описание

The Pop-Location cmdlet changes the current location to the location most recently pushed onto the stack by using the Push-Location cmdlet. Запись с местоположением может быть извлечена как из стека, заданного по умолчанию, так и из стека, созданного с помощью команды Push-Location.

Параметры

-PassThru

Передает по конвейеру объект, представляющий местоположение. По умолчанию этот командлет не формирует никаких выходных данных.

Обязательно?	false
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-StackName <string>

Задает альтернативный стек. Командлет Pop-Location извлекает последнее добавленное местоположение из этого стека. Этот стек затем становится текущим.

Обязательно?	false
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	true (ByPropertyName)
Принимать подстановочные знаки?	false

-UseTransaction

Включает команду в активную транзакцию. Этот параметр допустим, только если транзакция выполняется. Дополнительные сведения см. в разделе about_Transactions.

Обязательно?	false
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

<CommonParameters>

Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.

Ввод и вывод

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

Входные данные

Нет

Данные невозможно передать командлету Pop-Location по конвейеру.

Выходные данные

Нет или System.Management.Automation.PathInfo

Если задан параметр PassThru, командлет Pop-Location создает объект System.Management.Automation.PathInfo, представляющий местоположение. В противном случае этот командлет не формирует никаких выходных данных.

Примечания

Командлет Pop-Location также можно вызывать с помощью встроенного псевдонима "popd". Дополнительные сведения см. в разделе About_Aliases.

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

Пример 1

C:\PS>pop-location

Описание
-----------
Эта команда меняет текущее местоположение на местоположение, указанное в последней записи текущего стека.

Пример 2

C:\PS>pop-location -stackname Stack2

Описание
-----------
Эта команда меняет текущее местоположение на местоположение, указанное в последней записи стека Stack2.

Пример 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>

Описание
-----------
В этих командах командлеты Push-Location и Pop-Location используются для перемещения между местоположениями, поддерживаемыми разными поставщиками Windows PowerShell. В указанных командах командлеты Push-Location и Pop-Location вызываются с помощью своих псевдонимов "pushd" и "popd", соответственно.

Первая команда помещает текущее местоположение файловой системы в стек и переходит на диск HKLM, поддерживаемый поставщиком реестра Windows PowerShell. Вторая команда помещает текущее местоположение реестра в стек и переходит к местоположению, поддерживаемому поставщиком сертификатов Windows PowerShell. 

Две последние команды извлекают целевые местоположения из стека. Первая команда "popd" возвращает к диску Registry, а вторая — к диску файловой системы.

Pop-Location