将当前位置添加到位置列表（“堆栈”）的顶部。
语法
Push-Location [[-LiteralPath] <string>] [-PassThru] [-StackName <string>] [-UseTransaction] [<CommonParameters>] Push-Location [[-Path] <string>] [-PassThru] [-StackName <string>] [-UseTransaction] [<CommonParameters>]
说明
Push-Location cmdlet 将当前位置添加（“推入”）到位置列表（称为“堆栈”）的顶部。您可以将当前位置推入到默认堆栈或您创建的堆栈中。如果指定了路径，则 Push-Location 将当前位置推入堆栈，然后将当前位置更改为由此路径指定的位置。您无法将除当前位置以外的位置推入堆栈。
参数
-LiteralPath <string>
指定新位置的路径。与 Path 参数不同，LiteralPath 参数的值严格按照其键入形式使用。不会将任何字符解释为通配符。如果路径包括转义符，请将其括在单引号中。单引号会告知 Windows PowerShell 不要将所有字符都解释为转义序列。
|
是否为必需？ |
false |
|
位置？ |
1 |
|
默认值 |
|
|
是否接受管道输入？ |
true (ByPropertyName) |
|
是否接受通配符？ |
false |
-PassThru
将表示位置的对象传递到管道。默认情况下，此 cmdlet 将不产生任何输出。
|
是否为必需？ |
false |
|
位置？ |
named |
|
默认值 |
|
|
是否接受管道输入？ |
false |
|
是否接受通配符？ |
false |
-Path <string>
在此命令将当前位置添加（推入）到堆栈顶部之后，将把您的位置更改到由此路径指定的位置。输入其提供程序支持此 cmdlet 的任何位置的路径。允许使用通配符。参数名（“Path”）为可选项。
|
是否为必需？ |
false |
|
位置？ |
1 |
|
默认值 |
|
|
是否接受管道输入？ |
true (ByValue, ByPropertyName) |
|
是否接受通配符？ |
false |
-StackName <string>
指定堆栈的名称。当前位置被推入此堆栈中，此堆栈即成为当前堆栈。如果此堆栈尚不存在，将创建它。
|
是否为必需？ |
false |
|
位置？ |
named |
|
默认值 |
|
|
是否接受管道输入？ |
true (ByPropertyName) |
|
是否接受通配符？ |
false |
-UseTransaction
将命令包含在活动事务中。仅当正在执行事务时，此参数才有效。有关详细信息，请参阅 about_Transactions。
|
是否为必需？ |
false |
|
位置？ |
named |
|
默认值 |
|
|
是否接受管道输入？ |
false |
|
是否接受通配符？ |
false |
<CommonParameters>
此 cmdlet 支持通用参数：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。有关详细信息，请参阅 about_Commonparameters.
输入和输出
输入类型是指可通过管道传递给 cmdlet 的对象的类型。返回类型是指 Cmdlet 所返回对象的类型。
|
输入 |
System.String 可以通过管道将包含路径（但不是文本路径）的字符串传递给 Push-Location。 |
|
输出 |
None 或 System.Management.Automation.PathInfo 如果使用 PassThru 参数，则 Push-Location 生成表示位置的 System.Management.Automation.PathInfo 对象。否则，此 cmdlet 将不产生任何输出。 |
说明
还可以使用 Push-Location 的内置别名“pushd”来对其进行引用。有关详细信息，请参阅 about_Aliases。
“堆栈”是一种“后进先出”(LIFO) 数据结构。它类似于一个垂直列表，其中只有顶部项才可以访问。您只能将项添加（“推入”）到堆栈顶部，并且只能从堆栈顶部检索（“弹出”）项。要访问顶部项下面的项，必须先检索其上面的所有项。
Push-Location cmdlet 用于处理由任何提供程序公开的数据。要列出会话中可用的提供程序，请键入“Get-PSProvider”。有关详细信息，请参阅 about_Providers。
示例 1
C:\PS>push-location C:\Windows 说明 ----------- 此命令将当前位置推入到默认堆栈中，然后将位置更改为 C:\Windows。
示例 2
C:\PS>push-location HKLM:\Software\Policies -stackname RegFunction 说明 ----------- 此命令将当前位置推入到 RegFunction 堆栈中，然后将当前位置更改为 HKLM:\Software\Policies 位置。此命令说明可以将 Push-Location 与 Windows PowerShell 注册表提供程序一起使用。
示例 3
C:\PS>push-location 说明 ----------- 此命令将当前位置推入到默认堆栈中。
示例 4
C:\PS>push-location ~ -stackname Stack2 说明 ----------- 此命令将当前位置推入到名为 Stack2 的新堆栈中，然后将当前位置更改为主目录 (%USERPROFILE%)，主目录在此命令中以颚化符 (~) 或 $home 表示。Stack2 堆栈即成为当前堆栈。
另请参阅