Partilhar via

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[]>]
   [-UseTransaction]
   [<CommonParameters>]
Get-Location
   [-Stack]
   [-StackName <String[]>]
   [-UseTransaction]
   [<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 localizar seu local 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

Este comando exibe seu local 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 unidades diferentes

Este exemplo demonstra o uso de Get-Location para exibir seu local atual em diferentes unidades do PowerShell. Set-Location é usado para alterar a localização 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 local atual e pilhas de Get-Location locais alternativos.

O Push-Location cmdlet é usado para alterar em 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 no 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 PowerShell especificada.

Por exemplo, se estiver na Cert: unidade, pode utilizar este parâmetro para encontrar a C: sua localização atual na unidade.

Tipo:String[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-PSProvider

Obtém o local atual na unidade suportada pelo provedor PowerShell especificado. Se o provedor especificado oferecer 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 localizar seu local atual nas unidades do provedor de Registro do PowerShell.

Tipo:String[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais: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 localização, consulte as Notas.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-StackName

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

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

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

Tipo:String[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais: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.

Tipo:SwitchParameter
Aliases:usetx
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

None

Não é possível canalizar objetos para este 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 .

Notas

O Windows PowerShell inclui os seguintes aliases para Get-Location:

  • gl
  • pwd

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

Este cmdlet foi projetado para trabalhar 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 como 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 os usa e, em seguida, recupera-os para uso na ordem inversa. O PowerShell permite armazenar locais de provedores em pilhas de locais. O 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 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 Set-Location cmdlet para alterar a pilha de local atual.

Para gerenciar pilhas de locais, 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 parâmetro Stack do Get-Location 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 criará a pilha.

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

A pilha de local padrão sem nome é totalmente acessível somente quando é a pilha de local atual. Se você tornar uma pilha de local nomeada a pilha de local 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 ("").