Get-Location

  • Referência
Módulo:
Microsoft.PowerShell.Management

Obtém informações sobre o local de trabalho atual ou uma pilha de locais.

Sintaxe

Get-Location
   [-PSProvider <String[]>]
   [-PSDrive <String[]>]
   [<CommonParameters>]
Get-Location
   [-Stack]
   [-StackName <String[]>]
   [<CommonParameters>]

Description

O Get-Location cmdlet obtém um objeto que representa o diretório atual, muito parecido com o comando print working directory (pwd).

Quando você se move entre unidades do PowerShell, o PowerShell mantém sua localização em cada unidade. Você pode usar esse cmdlet para encontrar sua localização em cada unidade.

Você pode usar esse cmdlet para obter o diretório atual em tempo de execução e usá-lo em funções e scripts, como em uma função que exibe o diretório atual no prompt do PowerShell.

Você também pode usar esse cmdlet para exibir os locais em uma pilha de locais. Para obter mais informações, consulte as Notas e as descrições dos parâmetros Stack e StackName .

Exemplos

Exemplo 1: Exibir a localização atual da unidade

Esse comando exibe sua localização na unidade atual do PowerShell.

PS C:\Windows> Get-Location

Path
----
C:\Windows

Por exemplo, se você estiver no Windows diretório da C: unidade, ele exibirá o caminho para esse diretório.

Exemplo 2: Exibir sua localização atual para diferentes unidades

Este exemplo demonstra o uso de Get-Location para exibir sua localização atual em diferentes unidades do PowerShell. Set-Location é usado para alterar o local para vários caminhos diferentes em diferentes PSDrives.

PS C:\> Set-Location C:\Windows
PS C:\Windows> Set-Location HKLM:\Software\Microsoft
PS HKLM:\Software\Microsoft> Set-Location "HKCU:\Control Panel\Input Method"
PS HKCU:\Control Panel\Input Method> Get-Location -PSDrive C

Path
----
C:\Windows

PS HKCU:\Control Panel\Input Method> Get-Location -PSDrive HKLM

Path
----
HKLM:\Software\Microsoft

PS HKCU:\Control Panel\Input Method> Set-Location C:
PS C:\Windows> Get-Location -PSProvider Registry

Path
----
HKCU:\Control Panel\Input Method

Exemplo 3: Obter locais usando pilhas

Este exemplo mostra como usar os parâmetros Stack e StackName de para listar os locais na pilha de locais atual e nas pilhas de Get-Location locais alternativos.

O Push-Location cmdlet é usado para mudar para três locais diferentes. O terceiro push usa um nome de pilha diferente. O parâmetro Stack de Get-Location exibe o conteúdo da pilha padrão. O parâmetro StackName de Get-Location exibe o conteúdo da pilha chamada Stack2.

PS C:\> Push-Location C:\Windows
PS C:\Windows>Push-Location System32
PS C:\Windows\System32>Push-Location WindowsPowerShell -StackName Stack2
C:\Windows\System32\WindowsPowerShell>Get-Location -Stack

Path
----
C:\Windows
C:\

C:\Windows\System32\WindowsPowerShell>Get-Location -StackName Stack2

Path
----
C:\Windows\System32

Exemplo 4: Personalizar o prompt do PowerShell

Este exemplo mostra como personalizar o prompt do PowerShell.

PS C:\>
function prompt { 'PowerShell: ' + (Get-Location) + '> '}
PowerShell: C:\>

A função que define o prompt inclui um Get-Location comando, que é executado sempre que o prompt aparece no console.

O formato do prompt padrão do PowerShell é definido por uma função especial chamada prompt. Você pode alterar o prompt em seu console criando uma nova função chamada prompt.

Para ver a função de prompt atual, digite o seguinte comando: Get-Content Function:\prompt

Parâmetros

-PSDrive

Obtém o local atual na unidade do PowerShell especificada.

Por exemplo, se você estiver na Cert: unidade, poderá usar esse parâmetro para encontrar sua localização atual na C: unidade.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-PSProvider

Obtém o local atual na unidade com suporte do provedor do PowerShell especificado. Se o provedor especificado der suporte a mais de uma unidade, esse cmdlet retornará o local na unidade acessada mais recentemente.

Por exemplo, se você estiver na C: unidade, poderá usar esse parâmetro para encontrar sua localização atual nas unidades do provedor do Registro do PowerShell.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Stack

Indica que esse cmdlet exibe os locais adicionados à pilha de locais atual. Você pode adicionar locais a pilhas usando o Push-Location cmdlet.

Para exibir os locais em uma pilha de locais diferente, use o parâmetro StackName . Para obter informações sobre pilhas de locais, consulte as Notas.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-StackName

Especifica, como uma matriz de cadeia de caracteres, as pilhas de locais nomeadas. Insira um ou mais nomes de pilha de locais.

Para exibir os locais na pilha de locais atual, use o parâmetro Stack . Para tornar uma pilha de locais a pilha de locais atual, use o Set-Location cmdlet.

Esse cmdlet não pode exibir os locais na pilha padrão sem nome, a menos que seja a pilha atual.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Entradas

None

Você não pode canalizar objetos para esse cmdlet.

Saídas

PathInfo

Por padrão, esse cmdlet retorna um objeto PathInfo .

PathInfoStack

Quando você usa os parâmetros Stack ou StackName , esse cmdlet retorna um objeto PathInfoStack .

Observações

O PowerShell inclui os seguintes aliases para Get-Location:

  • Todas as plataformas:

    • gl
    • pwd

O PowerShell dá suporte a vários runspaces por processo. Cada runspace tem seu próprio diretório atual. Isso não é o mesmo que [System.Environment]::CurrentDirectory. Esse comportamento pode ser um problema ao chamar APIs do .NET ou executar aplicativos nativos sem fornecer caminhos de diretório explícitos. O Get-Location cmdlet retorna o diretório atual do runspace atual do PowerShell.

Esse cmdlet foi projetado para funcionar com os dados expostos por qualquer provedor. Para listar os provedores em sua sessão, digite Get-PSProvider. Para obter mais informações, consulte about_Providers.

As maneiras pelas quais os parâmetros PSProvider, PSDrive, Stack e StackName interagem dependem do provedor. Algumas combinações resultarão em erros, como especificar uma unidade e um provedor que não expõe essa unidade. Se nenhum parâmetro for especificado, esse cmdlet retornará o objeto PathInfo para o provedor que contém o local de trabalho atual.

Uma pilha é uma lista de último a entrar, primeiro a sair, na qual apenas o item adicionado mais recentemente está acessível. Você adiciona itens a uma pilha na ordem em que as usará e as recupera para uso na ordem inversa. O PowerShell permite armazenar locais de provedor em pilhas de locais. O PowerShell cria uma pilha de locais padrão sem nome e você pode criar várias pilhas de locais nomeados. Se você não especificar um nome de pilha, o PowerShell usará a pilha de local atual. Por padrão, o local padrão sem nome é a pilha de locais atual, mas você pode usar o Set-Location cmdlet para alterar a pilha de locais atual.

Para gerenciar pilhas de localização, use os cmdlets do PowerShell *-Location , da seguinte maneira.

  • Para adicionar um local a uma pilha de locais, use o Push-Location cmdlet.

  • Para obter um local de uma pilha de locais, use o Pop-Location cmdlet.

  • Para exibir os locais na pilha de locais atual, use o Get-Location parâmetro Stack do cmdlet. Para exibir os locais em uma pilha de locais nomeados, use o parâmetro StackName do Get-Location cmdlet.

  • Para criar uma nova pilha de locais, use o parâmetro StackName do Push-Location cmdlet. Se você especificar uma pilha que não existe, Push-Location o criará a pilha.

  • Para tornar uma pilha de locais a pilha de locais atual, use o parâmetro StackName do Set-Location cmdlet.

A pilha de locais padrão sem nome é totalmente acessível somente quando é a pilha de locais atual. Se você tornar uma pilha de locais nomeada a pilha de locais atual, não poderá mais usar os Push-Location cmdlets ou Pop-Location para adicionar ou obter itens da pilha padrão ou usar esse cmdlet para exibir os locais na pilha sem nome. Para tornar a pilha sem nome a pilha atual, use o parâmetro StackName do Set-Location cmdlet com um valor de ou uma cadeia de $null caracteres vazia ("").