Set-Location
将当前工作位置设置为指定的位置。
语法
Set-Location [-LiteralPath] <string> [-PassThru] [-UseTransaction] [<CommonParameters>]
Set-Location [[-Path] <string>] [-PassThru] [-UseTransaction] [<CommonParameters>]
Set-Location [-StackName <string>] [-PassThru] [-UseTransaction] [<CommonParameters>]
说明
Set-Location cmdlet 将工作位置设置为指定的位置。该位置可以是目录、子目录、注册表位置或其他位置堆栈。
参数
-LiteralPath <string>
指定位置的路径。LiteralPath 参数的值严格按照所键入的形式使用。不会将任何字符解释为通配符。如果路径包括转义符,请将其括在单引号中。单引号会告知 Windows PowerShell 不要将所有字符都解释为转义序列。
是否为必需? |
true |
位置? |
1 |
默认值 |
|
是否接受管道输入? |
true (ByPropertyName) |
是否接受通配符? |
false |
-PassThru
将表示位置的对象传递到管道。默认情况下,此 cmdlet 将不产生任何输出。
是否为必需? |
false |
位置? |
named |
默认值 |
|
是否接受管道输入? |
false |
是否接受通配符? |
false |
-Path <string>
此参数用于指定新工作位置的路径。
是否为必需? |
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 可以通过管道将包含路径(但不是文本路径)的字符串传递给 Set-Location。 |
输出 |
“无”或 System.Management.Automation.PathInfo 当您使用 PassThru 参数时,Set-Location 会生成代表该位置的 System.Management.Automation.PathInfo 对象。否则,此 cmdlet 将不产生任何输出。 |
说明
Set-Location cmdlet 用于处理由任何提供程序公开的数据。要列出会话中可用的提供程序,请键入“Get-PSProvider”。有关详细信息,请参阅 about_Providers。
示例 1
C:\PS>set-location HKLM:
说明
-----------
此命令将当前位置设置为所指定的位置;在此示例中,即为 HKLM 提供程序。
示例 2
C:\PS>set-location env: -passthru
Path
----
Env:\
说明
-----------
此命令将当前位置设置为所指定的位置;在此示例中,即为环境变量提供程序。
示例 3
C:\PS>set-location C:
说明
-----------
此命令将当前位置设置为所指定的位置;在此示例中,即为文件系统提供程序中的 C: 驱动器。