Compartilhar via

Get-Location

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

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

Sintaxe

Get-Location
   [-PSProvider <String[]>]
   [-PSDrive <String[]>]
   [-UseTransaction]
   [<CommonParameters>]
Get-Location
   [-Stack]
   [-StackName <String[]>]
   [-UseTransaction]
   [<CommonParameters>]

Description

O cmdlet Get-Location 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 Windows PowerShell, o Windows PowerShell mantém sua localização em cada unidade. Você pode usar esse cmdlet para encontrar 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 Windows 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

PS C:\> Get-Location
Path
----
C:\WINDOWS

Este comando exibe sua localização na unidade atual do Windows PowerShell.

Por exemplo, se você estiver no diretório do Windows da unidade C:, ele exibirá o caminho para esse diretório.

Exemplo 2: Exibir o local atual para unidades diferentes

The first command uses the **Set-Location** cmdlet to set the current location to the Windows subdirectory of the C: drive.
PS C:\> Set-Location C:\Windows

The second command uses the **Set-Location** cmdlet to change the location to the HKLM:\Software\Microsoft registry key. When you change to a location in the HKLM: drive, Windows PowerShell retains your location in the C: drive.
PS C:\>
PS C:\WINDOWS> Set-Location HKLM:\Software\Microsoft
PS HKLM:\Software\Microsoft>

The third command uses the **Set-Location** cmdlet to change the location to the HKCU:\Control Panel\Input Method registry key.
PS C:\>
PS HKLM:\Software\Microsoft> Set-Location "HKCU:\Control Panel\Input Method"
PS HKCU:\Control Panel\Input Method>

The fourth command uses the **Get-Location** cmdlet to find the current location on the C: drive. It uses the *PSDrive* parameter to specify the drive.
PS C:\>
PS HKCU:\Control Panel\Input Method> Get-Location -PSDrive C



Path
----
C:\WINDOWS

The fifth command uses the **Set-Location** cmdlet to return to the C: drive. Even though the command does not specify a subdirectory, Windows PowerShell returns you to the saved location.
PS C:\>
PS HKCU:\Control Panel\Input Method> Set-Location C:
PS C:\WINDOWS>

The sixth command uses the **Get-Location** cmdlet to find the current location in the drives supported by the Windows PowerShell registry provider. **Get-Location** returns the location of the most recently accessed registry drive, HKCU.
PS C:\>
PS C:\WINDOWS> Get-Location -PSProvider registry




Path
----
HKCU:\Control Panel\Input Method

To see the current location in the HKLM: drive, you need to use the *PSDrive* parameter to specify the drive. The seventh command does just this:
PS C:\>
PS C:\WINDOWS> Get-Location -PSDrive HKLM



Path
----
HKLM:\Software\Microsoft

Este exemplo demonstra o uso de Get-Location para exibir sua localização atual em diferentes unidades do Windows PowerShell.

Exemplo 3: listar os locais na pilha de localização atual e pilhas de localização alternativas

The first command sets the current location to the Windows directory on the C: drive.
PS C:\> Set-Location C:\Windows

The second command uses the **Push-Location** cmdlet to push the current location (C:\Windows) onto the current location stack and change to the System32 subdirectory. Because no stack is specified, the current location is pushed onto the current location stack. By default, the current location stack is the unnamed default location stack.
C:\WINDOWS> Push-Location System32

The third command uses the *StackName* parameter of the **Push-Location** cmdlet to push the current location (C:\Windows\System32) onto the Stack2 stack and to change the current location to the WindowsPowerShell subirectory. If the Stack2 stack does not exist, **Push-Location** creates it.
C:\Windows\System32> Push-Location WindowsPowerShell -StackName Stack2

The fourth command uses the *Stack* parameter of the **Get-Location** cmdlet to get the locations in the current location stack. By default, the current stack is the unnamed default location stack.
C:\WINDOWS\system32\WindowsPowerShell> Get-Location -Stack
Path
----
C:\WINDOWS

The fifth command uses the *StackName* parameter of the **Get-Location** cmdlet to get the locations in the Stack2 stack.
PS C:\>
C:\WINDOWS\system32\WindowsPowerShell>get-location -stackname Stack2



Path
----
C:\WINDOWS\system32

Este comando 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. Para obter mais informações sobre pilhas de localização, consulte as Anotações.

Exemplo 4: Personalizar o prompt do Windows PowerShell

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

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 prompt atual, digite o seguinte comando: Get-Content Function:prompt

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

Este 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 de prompt é chamada. O prompt termina com a cadeia de caracteres "> ".

Parâmetros

-PSDrive

Especifica o local atual na unidade especificada do Windows PowerShell que esse cmdlet obtém na operação.

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

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-PSProvider

Especifica o local atual na unidade compatível com o provedor do Windows PowerShell que esse cmdlet obtém na operação.

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 unidade C:, poderá usar esse parâmetro para encontrar seu local atual nas unidades do provedor Windows PowerShellRegistry.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Stack

Indica que esse cmdlet exibe os locais na pilha de localização atual.

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.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-StackName

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

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 parâmetro Set-Location. Para obter informações sobre pilhas de localização, consulte as Anotações.

Esse cmdlet não pode exibir os locais na pilha padrão sem nome, a menos que seja a pilha atual.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-UseTransaction

Inclui o comando na transação ativa. Esse parâmetro só é válido quando uma transação está em andamento. Para obter mais informações, consulte about_Transactions.

Tipo:SwitchParameter
Aliases:usetx
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 StackInfo. Caso contrário, ele retornará um objeto PathInfo.

Observações

  • 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, Stacke StackName interagem depende 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 os usa e os recupera para uso na ordem inversa. O Windows PowerShell permite armazenar locais do provedor em pilhas de localização. O Windows 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 Windows 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 cmdlet Set-Location para alterar a pilha de localização atual.

    Para gerenciar pilhas de localização, use os cmdlets do Windows PowerShellLocation, da seguinte maneira.

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

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

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

    • Para criar uma nova pilha de localização, use o parâmetro StackName do cmdlet push-location. 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 cmdlet Set-Location.

    A pilha de localização padrão sem nome só é totalmente acessível quando é a pilha de localização atual. Se você fizer uma pilha de localização nomeada a pilha de localização atual, não poderá mais usar o de Localização Por Push ou adicionar ou obter itens da pilha padrão ou usar esse comando cmdlet para exibir os locais na pilha sem nome. Para tornar a pilha sem nome a pilha atual, use o parâmetro StackName do cmdlet Set-Location com um valor de $null ou uma cadeia de caracteres vazia ("").