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 "> ".