Push-Location 帮助信息

如下说明是翻译 : help Push-Location 产生的帮助信息 .

译者 : Edengundam( 马涛 )

 

Push-Location

 

大纲

将当前路径压入栈 (stack) 中 .

 

语法

Push-Location [[-path] <string>] [-stackName <string>] [-passThru] [<CommonParameters>]

 

Push-Location [[-literalPath] <string>] [-stackName <string>] [-passThru] [<CommonParameters>]

 

详细描述

Push-Location cmdlet 将当前路径压入默认栈或您所创建的栈中 . 如果您指定了路径 , Push-Location 将当前路径压入栈中 , 然后转换到您指定的路径上 . 你不能将非当前路径压入栈中 .

 

参数

 

-path <string>

在将当前路径压入栈的顶端之后 , 改变当前位置为此参数指定的位置 . 输入一个支持此 cmdlet 的供应程序中的位置 . 允许使用通配符 . 参数名称 ("-Path") 为可选项 .

 

强制参数 ?	false
参数位置 ?	1
默认值	< 注意 : 如果不指定使用当前工作栈 >
允许从管道绑定输入 ?	true ( 根据值 , 根据属性名 )
允许通配符扩展 ?	true

 

-stackName <string>

指定栈的名称 . 当前路径将被压入此栈中 , 此栈将会成为当前栈 ( 默认栈 ). 如果栈还不存在 , 将会被创建 .

 

强制参数 ?	false
参数位置 ?	named
默认值
允许从管道绑定输入 ?	true ( 根据属性名 )
允许通配符扩展 ?	false

 

-passThru <SwitchParameter>

输出此命令创建的对象到管道中 . 默认情况下 , 此命令不会将对象输出到管道 .

 

强制参数 ?	false
参数位置 ?	named
默认值	False
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

 

-literalPath <string>

指定新位置的路径 . 与 Path 不同 , LiteralPath 的值被直接使用 , 不会对任何通配符进行解释 . 如果路径中包含了转义字符 , 需要将路径用单引号保护 . 单引号指示 Windows PowerShell 不对字符串中的转义字符进行处理 . 

强制参数 ?	false
参数位置 ?	1
默认值
允许从管道绑定输入 ?	true ( 根据属性名 )
允许通配符扩展 ?	false

 

< 公共参数 >

此命令支持公共参数 : -Verbose, -Debug, -ErrorAction, -ErrorVariable, and -OutVariable. 更多信息 , 输入 , "get-help about_commonparameters".

 

注意

 

更多信息 , 输入 "Get-Help Push-Location -detailed". 需要技术信息 , 输入 "Get-Help Push-Location -full".

 

如果需要为该命令提供多个参数 , 请使用逗号进行分隔 . 例如 , "<parameter-name> <value1>, <value2>".

 

你可以使用 Push-Location 内建别名 "pushd". 需要更多信息 , 查看 About_Alias .

 

例 1

 

C:/PS>push-location C:/Windows

 

此命令将当前位置压入默认栈 , 然后改变位置到 C:/Windows.

 

例 2

 

C:/PS>push-location HKLM:/Software/Policies -stackname RegFunction

 

此命令将当前位置压入 RegFunction 栈中 , 并改变当前位置为 HKLM:/Software/Policies. 此命令揭示了您可以在 Windows PowerShell 注册表供应程序中使用 Push-Location.

 

例 3

 

C:/PS>push-location

 

此命令将当前位置压入默认栈 .

 

例 4

 

C:/PS>push-location ~ -stackname Stack2

 

此命令将当前位置压入名叫 Stack2 的新的栈中 , 然后改变位置为用户默认路径 (%USERPROFILE%), 此路径在命令中通过 tilde 符号 (~) 或 $home 表示 . Stack2 栈现在成为当前栈 ( 默认栈 ).

 

相关链接

Pop-Location

Set-Location

Get-Location