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 pwd (diretório de trabalho de impressão).

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 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 localização. Para obter mais informações, consulte as Anotações e as descrições dos parâmetros Stack e StackName .

Exemplos

Exemplo 1: exibir o local da unidade atual

Esse 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 o local atual para unidades diferentes

Este exemplo demonstra o uso para Get-Location exibir sua localização 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 Get-LocationStack e StackName para listar os locais na pilha de localização atual e pilhas de localização alternativas.

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 exibe Get-Location o conteúdo da pilha padrão. O parâmetro StackName exibe Get-Location 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 encontrar o local atual na C: 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 compatível com o 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 o 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 localização atual. Você pode adicionar locais às pilhas usando o Push-Location cmdlet.

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

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

-StackName

Especifica, como uma matriz de cadeias de caracteres, as pilhas de localização nomeadas. Insira um ou mais nomes de pilha de locais.

Para exibir os locais na pilha de localização atual, use o parâmetro Stack . Para fazer uma pilha de localização a pilha de localização 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 redirecionar a entrada para este cmdlet.

Saídas

System.Management.Automation.PathInfo or System.Management.Automation.PathInfoStack

Se você usar os parâmetros Stack ou StackName , esse cmdlet retornará um objeto PathInfoStack . Caso contrário, ele retornará um objeto PathInfo .

Observações

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 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 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 ú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 do provedor em pilhas de localização. O PowerShell cria uma pilha de localização padrão sem nome e você pode criar várias pilhas de localização nomeadas. Se você não especificar um nome de pilha, o PowerShell usará a pilha de localização atual. Por padrão, o local padrão sem nome é a pilha de localização atual, mas você pode usar o Set-Location cmdlet para alterar a pilha de localização atual.

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

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

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

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

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

  • Para fazer uma pilha de localização a pilha de localização 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ê fizer uma pilha de localização nomeada a pilha de localização atual, não poderá mais usar os Push-Location cmdlets ou Pop-Location 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 ou uma cadeia de $null caracteres vazia ("").