Get-Location
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 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 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 Stack e StackName de Get-Location
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 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 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 localizar sua localização 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 cadeia 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 tornar 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
Você não pode canalizar objetos para este cmdlet.
Saídas
Por padrão, esse cmdlet retorna um objeto PathInfo .
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 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 funcionar 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 doGet-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 tornar 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
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 (""
).