Partilhar via

Pop-Location

Módulo:
Microsoft.PowerShell.Management Module

Altera o local atual para o local mais recentemente empurrado para a pilha.

Sintaxe

Default (Predefinição) 

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

Description

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

Exemplos

Exemplo 1: Alterar para a localização mais recente

PS C:\> Pop-Location

Este comando altera a sua localização para a localização adicionada mais recentemente à pilha atual.

Exemplo 2: Alterar para o local mais recente em uma pilha nomeada

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

Este comando altera sua localização para o local adicionado mais recentemente à pilha de localização Stack2.

Para obter mais informações sobre pilhas de localização, consulte as Notas.

Exemplo 3: Mover-se entre locais para provedores diferentes

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:\>

Esses comandos usam os cmdlets Push-Location e Pop-Location para mover entre locais suportados por diferentes provedores do Windows PowerShell. Os comandos usam o pushd alias para Push-Location e o popd alias para Pop-Location.

O primeiro comando envia o local atual do sistema de arquivos para a pilha e se move para a unidade HKLM suportada pelo provedor de Registro do Windows PowerShell.

O segundo comando envia o local do Registro para a pilha e se move para um local suportado pelo provedor de certificados do Windows PowerShell.

Os dois últimos comandos colocam esses locais fora da pilha. O primeiro comando popd retorna à unidade do Registro e o segundo comando retorna à unidade do sistema de arquivos.

Parâmetros

-PassThru

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-StackName

Especifica a pilha de locais a partir da qual o local é exibido. Insira um nome de pilha de localização.

Sem esse parâmetro, Pop-Location exibe um local da pilha de localização atual. Por padrão, a pilha de local atual é a pilha de local padrão sem nome que o Windows PowerShell cria. Para tornar uma pilha de localização a pilha de localização atual, use o parâmetro StackName de Set-Location.

de Localização Pop, não pode exibir um local da pilha padrão sem nome, a menos que seja a pilha de local atual.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-UseTransaction

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False
Aliases:Usetx

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

None

Não é possível canalizar a entrada para este cmdlet.

Saídas

None, System.Management.Automation.PathInfo

Este cmdlet gera um objeto System.Management.Automation.PathInfo que representa o local, se você especificar o parâmetro PassThru. Caso contrário, esse cmdlet não gerará nenhuma saída.

Notas

  • Uma pilha é uma lista de último a entrar, primeiro a sair, na qual apenas o item adicionado mais recentemente pode ser acessado. Você adiciona itens a uma pilha na ordem em que os usa e, em seguida, recupera-os para uso na ordem inversa. O Windows PowerShell permite armazenar locais de provedores em pilhas de locais.
  • O Windows PowerShell permite armazenar locais de provedores em pilhas de locais. O Windows PowerShell cria uma pilha de local padrão sem nome e você pode criar várias pilhas de locais nomeados. Se você não especificar um nome de pilha, o Windows PowerShell usará a pilha de local atual. Por padrão, o local padrão sem nome é a pilha de local atual, mas você pode usar o cmdlet Set-Location para alterar a pilha de local atual.
  • Para gerenciar pilhas de localização, use os cmdlets do Windows PowerShellLocation, da seguinte maneira:
  • Para adicionar um local a uma pilha de locais, use o cmdlet Push-Location.
  • Para obter um local de uma pilha de locais, use o cmdlet Pop-Location.
  • Para exibir os locais na pilha de locais atual, use o parâmetro Stack do cmdlet Get-Location.
  • Para exibir os locais em uma pilha de locais nomeados, use o parâmetro StackName do cmdlet Get-Location.
  • Para criar uma nova pilha de locais, use o parâmetro StackName do cmdlet Push-Location. Se você especificar uma pilha que não existe, Push-Location criará a pilha.
  • Para tornar uma pilha de locais a pilha de locais atual, use o parâmetro StackName do cmdlet Set-Location.
  • A pilha de local padrão sem nome está totalmente disponível somente quando é a pilha de local atual. Se você fizer de uma pilha de local nomeada a pilha de localização atual, não poderá mais usar Push-Location ou cmdlets Pop-Location adicionar ou obter itens da pilha padrão ou usar um comando Get-Location para exibir os locais na pilha sem nome. Para tornar a pilha sem nome a pilha atual, use o parâmetro StackName de Set-Location com um valor de $Null ou uma cadeia de caracteres vazia ("").
  • Você também pode se referir a Pop-Location por seu alias interno, popd. Para obter mais informações, consulte about_Aliases.
  • de Localização Pop, foi projetado para trabalhar 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.