Push-Location

  • 参考
模块:
Microsoft.PowerShell.Management

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

语法

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

说明

该 Push-Location cmdlet 将 (“pushes”) 当前位置添加到位置堆栈中。 如果指定路径， 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 驱动器中使用 Location cmdlet (PSDrive) 。

示例 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 于和 $env:USERPROFILE。

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

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

参数

-LiteralPath

指定新位置的路径。 与 Path参数不同，LiteralPath 参数的值严格按照所键入的形式使用。 不会将任何字符解释为通配符。 如果路径包括转义符，请将其括在单引号中。 单引号告知 PowerShell 不要将任何字符解释为转义序列。

Type:String
Aliases:PSPath, LP
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

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

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

-Path

在此命令将当前位置添加（推入）到堆栈顶部之后，将把你的位置更改到由此路径指定的位置。 输入其提供程序支持此 cmdlet 的任何位置的路径。 允许使用通配符。 参数名为可选项。

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-StackName

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

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

注意

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

Type:String
Position:Named
Default value:Default stack
Required:False
Accept pipeline input:True
Accept wildcard characters:False

输入

String

可以通过管道将包含路径 (但不能通过文本路径) 传递给 Push-Location的字符串。

输出

None or System.Management.Automation.PathInfo

使用 PassThru 参数时， Push-Location 生成表示位置的 System.Management.Automation.PathInfo 对象。 否则，此 cmdlet 将不生成任何输出。

备注

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

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

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

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

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

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

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

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

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

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

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

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

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

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