Share via

Get-Location

  • 参考
模块:
Microsoft.PowerShell.Management

获取有关当前工作位置或某个位置堆栈的信息。

语法

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

说明

cmdlet Get-Location 获取表示当前目录的对象，这与打印工作目录 (pwd) 命令很类似。

在 PowerShell 驱动器之间移动时，PowerShell 会保留每个驱动器中的位置。 可以使用此 cmdlet 查找每个驱动器中的位置。

可以使用此 cmdlet 在运行时获取当前目录，并在函数和脚本中使用它，例如在 PowerShell 提示符中显示当前目录的函数中。

还可以使用此 cmdlet 在位置堆栈中显示位置。 有关详细信息，请参阅 说明以及 Stack 和 StackName 参数的说明。

示例

示例 1：显示当前驱动器位置

此命令显示当前 PowerShell 驱动器中的位置。

PS C:\Windows> Get-Location

Path
----
C:\Windows

例如，如果位于 Windows 驱动器的 C: 目录中，则它将显示该目录的路径。

示例 2：显示不同驱动器的当前位置

此示例演示如何使用 Get-Location 在不同的 PowerShell 驱动器中显示当前位置。 Set-Location 用于将位置更改为不同 PSDrive 上的多个不同路径。

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

示例 3：使用堆栈获取位置

此示例演示如何使用 的 Stack 和 StackName 参数 Get-Location 列出当前位置堆栈和备用位置堆栈中的位置。

cmdlet Push-Location 用于更改为三个不同的位置。 第三次推送使用不同的堆栈名称。 的 Get-LocationStack 参数显示默认堆栈的内容。 的 Get-LocationStackName 参数显示名为 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

示例 4：自定义 PowerShell 提示符

此示例演示如何自定义 PowerShell 提示符。

PS C:\>
function prompt { 'PowerShell: ' + (Get-Location) + '> '}
PowerShell: C:\>

定义提示的函数包含一个 Get-Location 命令，每当提示出现在控制台中时，该命令将运行。

默认 PowerShell 提示符的格式由名为 prompt的特殊函数定义。 可以通过创建名为 prompt的新函数来更改控制台中的提示。

若要查看当前提示函数，请键入以下命令： Get-Content Function:\prompt

参数

-PSDrive

获取指定 PowerShell 驱动器中的当前位置。

例如，如果你位于驱动器中 Cert: ，则可以使用此参数在驱动器中 C: 查找当前位置。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PSProvider

获取指定的 PowerShell 提供程序支持的驱动器中的当前位置。 如果指定的提供程序支持多个驱动器，则此 cmdlet 将返回最近访问的驱动器上的位置。

例如，如果你位于驱动器中 C: ，则可以使用此参数在 PowerShell 注册表 提供程序的驱动器中查找当前位置。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Stack

指示此 cmdlet 显示添加到当前位置堆栈的位置。 可以使用 cmdlet 将位置添加到堆栈 Push-Location 。

若要显示其他位置堆栈中的位置，请使用 StackName 参数。 有关位置堆栈的信息，请参阅 说明。

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

-StackName

以字符串数组的形式指定命名位置堆栈。 输入一个或多个位置堆栈名称。

若要显示当前位置堆栈中的位置，请使用 Stack 参数。 若要使位置堆栈成为当前位置堆栈，请使用 Set-Location cmdlet。

此 cmdlet 无法显示未命名的默认堆栈中的位置，除非它是当前堆栈。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

输入

None

不能通过管道将对象传递给此 cmdlet。

输出

PathInfo

默认情况下，此 cmdlet 返回 PathInfo 对象。

PathInfoStack

使用 Stack 或 StackName 参数时，此 cmdlet 将返回 PathInfoStack 对象。

备注

PowerShell 包含以下别名 Get-Location：

  • 所有平台：

    • gl
    • pwd

PowerShell 支持每个进程多个运行空间。 每个运行空间都有自己的 当前目录。 这与 [System.Environment]::CurrentDirectory不同。 调用 .NET API 或运行本机应用程序而不提供显式目录路径时，此行为可能是一个问题。 cmdlet Get-Location 返回当前 PowerShell 运行空间的当前目录。

此 cmdlet 用于处理由任何提供程序公开的数据。 若要列出会话中的提供程序，请键入 Get-PSProvider。 有关详细信息，请参阅 about_Providers。

PSProvider、PSDrive、Stack 和 StackName 参数的交互方式取决于提供程序。 某些组合将会导致错误，例如，指定驱动器以及没有公开该驱动器的提供程序。 如果未指定参数，此 cmdlet 将返回包含当前工作位置的提供程序的 PathInfo 对象。

堆栈是一个后进先出列表，其中仅可访问最近添加的项。 采用要使用项的顺序将这些项添加到堆栈，然后采用相反顺序检索这些项以供使用。 PowerShell 允许将提供程序位置存储在位置堆栈中。 PowerShell 创建未命名的默认位置堆栈，你可以创建多个命名位置堆栈。 如果未指定堆栈名称，PowerShell 将使用当前位置堆栈。 默认情况下，未命名的默认位置是当前位置堆栈，但你可以使用 Set-Location cmdlet 更改当前位置堆栈。

若要管理位置堆栈，请使用 PowerShell *-Location cmdlet，如下所示。

  • 若要将位置添加到位置堆栈，请使用 Push-Location cmdlet。

  • 若要从位置堆栈获取位置，请使用 Pop-Location cmdlet。

  • 若要显示当前位置堆栈中的位置，请使用 cmdlet 的 Get-LocationStack 参数。 若要显示命名位置堆栈中的位置，请使用 cmdlet 的 Get-LocationStackName 参数。

  • 若要创建新的位置堆栈，请使用 cmdlet 的 Push-LocationStackName 参数。 如果指定的堆栈不存在， Push-Location 将创建堆栈。

  • 若要使位置堆栈成为当前位置堆栈，请使用 cmdlet 的 Set-LocationStackName 参数。

未命名的默认位置堆栈仅在其是当前位置堆栈时处于完全可访问状态。 如果将命名位置堆栈设置为当前位置堆栈，则不能再使用 Push-Location 或 Pop-Location cmdlet 添加或获取默认堆栈中的项，也不能使用此 cmdlet 显示未命名堆栈中的位置。 若要使未命名的堆栈成为当前堆栈，请使用值为 $null 的 cmdlet 的 Set-LocationStackName 参数或空字符串 ("") 。