Push-Location
将当前位置添加到位置列表(“堆栈”)的顶部。
语法
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。 |
输出 |
“无”或 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 堆栈即成为当前堆栈。