Get-Location

参考

模块:: Microsoft.PowerShell.Management

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

语法

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

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

说明

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

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

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

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

示例

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

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

PS C:\Windows> Get-Location

Path
----
C:\Windows

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

示例 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 列出当前位置堆栈和备用位置堆栈中的位置。

Push-Location cmdlet 用于更改为三个不同的位置。第三个推送使用不同的堆栈名称。 Get-Location 的 Stack 参数显示默认堆栈的内容。 Get-Location 的 StackName 参数显示名为 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: 驱动器中找到当前位置。

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-PSProvider

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

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

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-Stack

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

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

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-StackName

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

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

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

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

输入

None

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

输出

PathInfo

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

PathInfoStack

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

备注

PowerShell 包含以下 Get-Location别名：

所有平台：
- gl
- pwd

PowerShell 支持每个进程的多个运行空间。每个 runspace 都有自己的 当前目录。这与 [System.Environment]::CurrentDirectory不同。调用 .NET API 或运行本机应用程序而不提供显式目录路径时，此行为可能是一个问题。 Get-Location cmdlet 返回当前 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。
若要显示当前位置堆栈中的位置，请使用 Get-Location cmdlet 的 Stack 参数。若要显示命名位置堆栈中的位置，请使用 Get-Location cmdlet 的 StackName 参数。
若要创建新的位置堆栈，请使用 Push-Location cmdlet 的 StackName 参数。如果指定不存在的堆栈，Push-Location 创建堆栈。
若要将位置堆栈设为当前位置堆栈，请使用 Set-Location cmdlet 的 StackName 参数。

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

通过