Get-Location

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

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

Syntax

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, assim como 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 o local 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 seu local 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 o local para vários caminhos diferentes em PSDrives diferentes.

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 mudar 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 do PowerShell especificada.

Por exemplo, se você estiver na Cert: unidade, poderá usar esse parâmetro para localizar seu C: local atual na unidade.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PSProvider

Obtém o local atual na unidade com suporte pelo provedor do 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 do Registro do PowerShell.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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 local diferente, use o parâmetro StackName . Para obter informações sobre pilhas de localização, consulte as Notas.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-StackName

Especifica, como uma matriz de cadeia de caracteres, as pilhas de local 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 local a pilha de local 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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Entradas

None

Não é possível 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 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. 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 espaço de execução atual do PowerShell.

Esse 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 última entrada e primeira saída 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 provedores em pilhas de localização. O PowerShell cria uma pilha de local padrão sem nome e você pode criar várias pilhas de local nomeadas. 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 local, 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 local nomeada, use o parâmetro StackName do Get-Location cmdlet.

  • Para criar uma nova pilha de local, 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 local a pilha de local 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 local nomeado 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 ("").