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: 驱动器。





另请参阅

概念

about_providers
Get-Location
Pop-Location
Push-Location