Pop-Location

Altera o local atual para o local colocado mais recentemente na pilha. Você pode retirar o local da pilha padrão ou de uma pilha que criada com o cmdlet Push-Location.

Sintaxe

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

Descrição

O cmdlet Pop-Location altera o local atual para o local colocado mais recentemente na pilha usando o cmdlet Push-Location. Você pode retirar o local da pilha padrão ou de uma pilha criada com um comando Push-Location.

Parâmetros

-PassThru

Passa um objeto que representa o local para o pipeline. Por padrão, este cmdlet não gera nenhuma saída.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-StackName <string>

Especifica uma pilha alternativa. Pop-Location retira o local adicionado mais recentemente dessa pilha. Essa pilha, então, se torna a pilha atual.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	true (ByPropertyName)
Aceitar caracteres curinga?	false

-UseTransaction

Inclui o comando na transação ativa. Este parâmetro é válido apenas quando uma transação está em andamento. Para obter mais informações, consulte about_Transactions.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

<CommonParameters>

Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.

Entradas e saídas

O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.

Entradas

None

Não é possível enviar a entrada para Pop-Location.

Saídas

None ou System.Management.Automation.PathInfo

Quando você usa o parâmetro PassThru, o Pop-Location gera um objeto System.Management.Automation.PathInfo que representa o local. Caso contrário, esse cmdlet não gera nenhuma saída.

Observações

Você também pode fazer referência a Pop-Location usando seu alias interno, "popd". Para obter mais informações, consulte about_Aliases.

O cmdlet Pop-Location foi desenvolvido para funcionar com os dados expostos por qualquer provedor. Para listar os provedores disponíveis em sua sessão, digite "Get-PSProvider". Para obter mais informações, consulte about_Providers.

Exemplo 1

C:\PS>pop-location

Descrição
-----------
Esse comando altera o seu local para o local colocado mais recentemente na pilha atual.

Exemplo 2

C:\PS>pop-location -stackname Stack2

Descrição
-----------
Esse comando altera o seu local para o local colocado mais recentemente na pilha Stack2.

Exemplo 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>

Descrição
-----------
Esses comandos usam os cmdlets Push-Location e Pop-Location para moverem-se entre locais com suporte em diferentes provedores do Windows PowerShell. Eles usam o alias "pushd" para Push-Location e o alias "popd" para Pop-Location.

O primeiro comando coloca o local atual do sistema de arquivos na pilha e move para a unidade HKLM com suporte do provedor Registry do Windows PowerShell. O segundo comando coloca o local do Registro na pilha e move para um local com suporte do provedor de certificados do Windows PowerShell. 

Os dois últimos comandos retiram esses locais da pilha. O primeiro comando "popd" retorna para a unidade Registry: e o segundo retorna para a unidade do sistema de arquivos.