Push-Location

参考

模块:: Microsoft.PowerShell.Management

将当前位置添加到位置堆栈的顶部。

语法

Push-Location
    [[-Path] <String>]
    [-PassThru]
    [-StackName <String>]
    [<CommonParameters>]

Push-Location
    [-LiteralPath <String>]
    [-PassThru]
    [-StackName <String>]
    [<CommonParameters>]

说明

Push-Location cmdlet 将当前位置添加到位置堆栈中。如果指定路径，Push-Location 将当前位置推送到位置堆栈，然后将当前位置更改为路径指定的位置。可以使用 Pop-Location cmdlet 从位置堆栈获取位置。

默认情况下，Push-Location cmdlet 将当前位置推送到当前位置堆栈，但可以使用 StackName 参数指定备用位置堆栈。如果堆栈不存在，Push-Location 创建它。

有关位置堆栈的详细信息，请参阅备注。

示例

示例 1

本示例将当前位置推送到默认位置堆栈，然后将位置更改为 C:\Windows。

PS C:\> Push-Location C:\Windows

示例 2

本示例将当前位置推送到 RegFunction 堆栈，并将当前位置更改为 HKLM:\Software\Policies 位置。

PS C:\> Push-Location HKLM:\Software\Policies -StackName RegFunction

可以在任何 PowerShell 驱动器（PSDrive）中使用 Location cmdlet。

示例 3

此命令将当前位置推送到默认堆栈。它不会更改位置。

PS C:\> Push-Location

示例 4 - 创建和使用命名堆栈

这些命令演示如何创建和使用命名位置堆栈。

PS C:\> Push-Location ~ -StackName Stack2
PS C:\Users\User01> Pop-Location -StackName Stack2
PS C:\>

第一个命令将当前位置推送到名为 Stack2 的新堆栈上，然后将当前位置更改为主目录，该目录由波形符（~）表示，在 FileSystem 提供程序驱动器上使用时，该符号相当于 $HOME。

如果会话中尚不存在 Stack2，Push-Location 创建它。第二个命令使用 Pop-Location cmdlet 从 Stack2 堆栈弹出原始位置（C:\）。如果没有 StackName 参数，Pop-Location 将从未命名的默认堆栈弹出位置。

有关位置堆栈的详细信息，请参阅备注。

参数

-LiteralPath

指定新位置的路径。与 Path 参数不同，LiteralPath 参数的值与类型化完全相同。不会将任何字符解释为通配符。如果路径包含转义字符，请将它括在单引号中。单引号告知 PowerShell 不要将任何字符解释为转义序列。

类型:	String
别名:	PSPath, LP
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-PassThru

将表示位置的对象传递给管道。默认情况下，此 cmdlet 不生成任何输出。

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

-Path

将当前位置添加到堆栈顶部后，将此路径指定的位置更改为该位置（推送）。输入其提供程序支持此 cmdlet 的任何位置的路径。允许通配符。参数名称是可选的。

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

-StackName

指定将当前位置添加到的位置堆栈。输入位置堆栈名称。如果堆栈不存在，Push-Location 创建它。

如果没有此参数，Push-Location 将位置添加到当前位置堆栈。默认情况下，当前位置堆栈是 PowerShell 创建的未命名的默认位置堆栈。若要将位置堆栈设为当前位置堆栈，请使用 Set-Location cmdlet 的 StackName 参数。有关位置堆栈的详细信息，请参阅备注。

注意

Push-Location 无法向未命名的默认堆栈添加位置，除非它是当前位置堆栈。

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

输入

String

可以通过管道将包含路径（但不是文本路径）的字符串传递给此 cmdlet。

输出

None

默认情况下，此 cmdlet 不返回任何输出。

PathInfo

使用 PassThru 参数时，此 cmdlet 返回表示 cmdlet作后当前路径的 PathInfo 对象。

备注

PowerShell 包含以下 Push-Location别名：

所有平台：
- pushd

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

即使位置 cmdlet 确实设置了进程范围的当前目录，也不能依赖它，因为其他运行空间可能会随时更改它。应使用位置 cmdlet 使用特定于当前运行空间的当前工作目录执行基于路径的作。

堆栈是最后一个先出列表，其中仅可访问最近添加的项。按使用项的顺序将项添加到堆栈中，然后检索它们以反向顺序使用。 PowerShell 允许将提供程序位置存储在位置堆栈中。

PowerShell 将创建一个未命名的默认位置堆栈，你可以创建多个命名的位置堆栈。如果未指定堆栈名称，PowerShell 将使用当前位置堆栈。默认情况下，未命名的默认位置是当前位置堆栈，但你可以使用 Set-Location cmdlet 更改当前位置堆栈。

若要管理位置堆栈，请使用 PowerShell 位置 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 从默认堆栈添加或获取项，或使用 Get-Location cmdlet 显示未命名堆栈中的位置。若要使未命名的堆栈成为当前堆栈，请使用 Set-Location cmdlet 的 StackName 参数，其值为 $null 或空字符串（""）。

还可以通过其内置别名 pushd来引用 Push-Location。有关详细信息，请参阅 about_Aliases。

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

通过