Adiciona o local atual no início de uma lista de locais (uma "pilha").
Sintaxe
Push-Location [[-LiteralPath] <string>] [-PassThru] [-StackName <string>] [-UseTransaction] [<CommonParameters>] Push-Location [[-Path] <string>] [-PassThru] [-StackName <string>] [-UseTransaction] [<CommonParameters>]
Descrição
O cmdlet Push-Location adiciona ("envia por push") o local atual no início de uma lista de locais, chamada de "pilha". É possível enviar por push o local atual para uma pilha padrão ou para uma pilha criada por você. Caso você especifique um caminho, Push-Location coloca o local atual na pilha e então altera o local atual para o local especificado pelo caminho. Você não pode colocar um local na pilha, a menos que ele seja o local atual.
Parâmetros
-LiteralPath <string>
Especifica o caminho até o novo local. Ao contrário do parâmetro Path, o valor do parâmetro LiteralPath é usado exatamente como é digitado. Nenhum caractere será interpretado como curinga. Se o caminho incluir caracteres de escape, coloque-os entre aspas simples. As aspas simples dizem ao Windows PowerShell para não interpretar quaisquer caracteres que tenham sequências de escape.
|
Necessário? |
false |
|
Posição? |
1 |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
true (ByPropertyName) |
|
Aceitar caracteres curinga? |
false |
-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 |
-Path <string>
Altera o seu local para o especificado por esse caminho depois que ele adiciona (empurra) o local atual ao topo da pilha. Digite um caminho para qualquer local cujo provedor suporte esse cmdlet. Os caracteres curinga são permitidos. O nome do parâmetro ("Path") é opcional.
|
Necessário? |
false |
|
Posição? |
1 |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
true (ByValue, ByPropertyName) |
|
Aceitar caracteres curinga? |
false |
-StackName <string>
Especifica o nome de uma pilha. O local atual é colocado na pilha, e ela se torna a pilha atual. Se a pilha ainda não existir, ela será criada.
|
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 |
System.String Você pode enviar uma cadeia de caracteres que contém um caminho (mas não um caminho literal) para Push-Location. |
|
Saídas |
None ou System.Management.Automation.PathInfo Quando você usa o parâmetro PassThru, o Push-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 Push-Location usando seu alias interno, "pushd". Para obter mais informações, consulte about_Aliases.
Uma "pilha" é uma estrutura de dados UEPS ("último a entrar, primeiro a sair"). Ela é semelhante a uma lista vertical na qual somente o item superior está acessível. Você pode adicionar ("enviar por push") itens à parte de cima da pilha e só pode recuperar ("retirar") itens da parte de cima da pilha. Para obter aos itens na parte de baixo, você deve recuperar todos os itens acima deles.
O cmdlet Push-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>push-location C:\Windows Descrição ----------- Esse comando coloca o local atual na pilha padrão e então altera o local para C:\Windows.
Exemplo 2
C:\PS>push-location HKLM:\Software\Policies -stackname RegFunction Descrição ----------- Esse comando coloca o local atual na pilha RegFunction e altera o local atual para HKLM:\Software\Policies. Esse exemplo mostra que você pode usar Push-Location com o provedor de Registro do Windows PowerShell.
Exemplo 3
C:\PS>push-location Descrição ----------- Esse comando coloca o local atual na pilha padrão.
Exemplo 4
C:\PS>push-location ~ -stackname Stack2 Descrição ----------- Esse comando coloca o local atual na nova pilha, chamada Stack2, e então altera o local atual para o diretório inicial (%USERPROFILE%), que é representado no comando pelo símbolo til (~) ou por $home. Agora, Stack2 se tornou a pilha atual.
See Also