Compartilhar via


Get-Location

Obtém informações sobre o local de trabalho atual.

Sintaxe

Get-Location [-PSDrive <string[]>] [-PSProvider <string[]>] [-UseTransaction] [<CommonParameters>]

Get-Location [-Stack] [-StackName <string[]>] [-UseTransaction] [<CommonParameters>]

Descrição

O cmdlet Get-Location obtém um objeto que representa o diretório atual, como o comando pwd (imprimir diretório de trabalho).

Quando você passa de uma unidade do Windows PowerShell para outra, o Windows PowerShell retém seu local em cada unidade. Use Get-Location para encontrar seu local em cada unidade.

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

Se você usar o cmdlet Push-Location para adicionar locais a uma pilha de caminhos, poderá usar o parâmetro Stack de Get-Location para exibir a pilha atual.

Parâmetros

-PSDrive <string[]>

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

Por exemplo, se você estiver na unidade Certificate:, use este parâmetro para encontrar seu local atual na unidade C:.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

true (ByPropertyName)

Aceitar caracteres curinga?

false

-PSProvider <string[]>

Obtém o local atual na unidade aceita pelo provedor especificado do Windows PowerShell.

Se o provedor especificado suportar mais de uma unidade, Get-Location retornará o local na unidade acessada mais recentemente.

Por exemplo, se você estiver na unidade C:, use este parâmetro para encontrar seu local atual nas unidades do provedor Registry do Windows PowerShell.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

true (ByPropertyName)

Aceitar caracteres curinga?

false

-Stack

Exibe os locais na pilha de caminhos padrão.

Para adicionar caminhos à pilha padrão, use o cmdlet Push-Location.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-StackName <string[]>

Exibe os locais nas pilhas de caminhos especificadas.

Para criar pilhas de caminhos, use o cmdlet Push-Location.

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

Nenhum

Você não pode canalizar a entrada para este cmdlet.

Saídas

Objetos PathInfo ou StackInfo

Se você usar parâmetros Stack ou StackName, Get-Location retornará um objeto StackInfo. Caso contrário, ele retornará um objeto PathInfo.

Observações

Os locais podem ser armazenados em uma pilha. O cmdlet Push-Location adiciona um local ao topo da pilha. O cmdlet Pop-Location obtém o local no topo da pilha.

A forma como os parâmetros PSProvider, PSDrive, Stack e StackName interage depende do provedor. Algumas combinações resultarão em erros, como a especificação de uma unidade e de um provedor que não exponha essa unidade. Caso nenhum parâmetro seja especificado, Get-Location retornará o objeto PathInfo para o provedor que contiver o local de trabalho atual.

O cmdlet Get-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>get-location

Path
----
C:\WINDOWS

Descrição
-----------
Esse comando exibe seu local na unidade atual do Windows PowerShell.

Por exemplo, se você estiver no diretório do Windows da unidade C:, ele exibe o caminho até esse diretório.





Exemplo 2

C:\PS>set-location

Descrição
-----------
Esses comandos demonstram o uso de Get-Location para exibir seu local atual em unidades diferentes do Windows PowerShell.

O primeiro comando usa o cmdlet Set-Location para definir o local atual como o subdiretório Windows da unidade C:.

    C:\PS> set-location C:\Windows

O segundo comando usa o cmdlet Set-Location para alterar o local para a chave do Registro HKLM:\Software\Microsoft. Quando você altera a um local na unidade HKLM:, o Windows PowerShell retém seu local na unidade C:. 

    PS C:\WINDOWS> set-location HKLM:\Software\Microsoft
    PS HKLM:\Software\Microsoft>

O terceiro comando usa o cmdlet Set-Location para alterar o local para a chave do Registro "HKCU:\Control Panel\Input Method".

    PS HKLM:\Software\Microsoft> set-location 'HKCU:\Control Panel\Input Method'
    PS HKCU:\Control Panel\Input Method>

O quarto comanda usa o cmdlet Get-Location para encontrar o local atual na unidade C:. Ele usa o parâmetro PSDrive para especificar a unidade.

    PS HKCU:\Control Panel\Input Method> get-location -psdrive c
    Path
    ----
    C:\WINDOWS

O quinto comando usa o cmdlet Set-Location para retornar à unidade C:. Embora o comando não especifique um subdiretório, o Windows PowerShell volta para o local salvo.

    PS HKCU:\Control Panel\Input Method> set-location C:
    PS C:\WINDOWS>

O sexto comando usa o cmdlet Get-Location para encontrar o local atual nas unidades suportadas pelo provedor Registry do Windows PowerShell. Get-Location retorna o local da unidade de Registro acessada mais recentemente, HKCU:.

    PS C:\WINDOWS> get-location -psprovider registry
    Path
    ----
    HKCU:\Control Panel\Input Method

Para ver o local atual na unidade HKLM:, é necessário usar o parâmetro PSDrive para especificar a unidade. O sétimo comando faz isto apenas:

    PS C:\WINDOWS> get-location -psdrive HKLM
    Path
    ----
    HKLM:\Software\Microsoft





Exemplo 3

C:\PS>set-location

Descrição
-----------
Esses comandos mostram como usar os parâmetros Stack e StackName de Get-Location para listar os caminhos nas pilhas de caminhos padrão e alternativa.

O primeiro comando define o local atual como sendo o diretório Windows na unidade C:.
    
    C:\PS> set-location C:\Windows 

O segundo comando usa o cmdlet Push-Location para enviar por push o local atual (C:\Windows) para a pilha de caminhos e mudar para o subdiretório System32. Como nenhuma pilha está especificada, o local atual é enviado por push para a pilha padrão.
    C:\WINDOWS>push-location System32

O terceiro comando envia por push o local atual (C:\Windows\System32) para a pilha Stack2 e muda altera o local para o subdiretório WindowsPowerShell.
    
    C:\Windows\System32>push-location WindowsPowerShell -stack Stack2

O quarto comando usa o cmdlet Get-Location para obter os caminhos na pilha de caminhos padrão.
    
    C:\WINDOWS\system32\WindowsPowerShell>get-location -stack

    Path
    ----
    C:\WINDOWS

O último comando usa o parâmetro StackName de Get-Location para obter os caminhos na pilha Stack2.
    
    C:\WINDOWS\system32\WindowsPowerShell>get-location -stackname Stack2

    Path
    ----
    C:\WINDOWS\system32





Exemplo 4

C:\PS>function prompt { 'PowerShell: ' + (get-location) + '> '}

PowerShell: C:\WINDOWS>

Descrição
-----------
Este exemplo mostra como personalizar o prompt do Windows PowerShell. A função que define o prompt inclui um comando Get-Location, que é executado sempre que o prompt aparece no console.

O formato do prompt padrão do Windows 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 aviso atual, digite o seguinte comando:
 
    get-content function:prompt

O comando começa com a palavra-chave "function" seguida pelo nome da função, "prompt". O corpo da função aparece entre chaves ( {} ). 

Esse comando define um novo prompt que começa com a cadeia de caracteres "PowerShell: ". Para acrescentar o local atual, ele usa um comando Get-Location, que é executado quando a função prompt é chamada. O prompt termina com a cadeia de caracteres "> ".





Consulte também

Conceitos

about_Providers
Pop-Location
Push-Location
Set-Location