PowerShell Set-Item

PowerShell Set-Item cmdlet 用于将项目的值更改为命令中指定的值。它更改变量或注册表项的值。 Windows PowerShell FileSystem 提供程序不支持此 cmdlet。 在注册表驱动器（例如 HKLM: 和 HKCU:）中，它会更改注册表项的默认值中的数据。

语法

参数

-Path

-Path 参数用于指定项目位置的路径。 接受通配符。

-LiteralPath

-LiteralPath 参数用于指定一个或多个位置的路径。此参数的值将完全按照其输入进行使用。 如果路径包含转义字符，请将其用引号引起来。 没有字符被解释为通配符。 单引号告诉 Windows PowerShell 不应将任何字符解释为转义序列。

-Force

-Force 参数允许 cmdlet 设置无法更改的项目，例如变量或只读别名。 即使使用 -Force 参数，Set-Item cmdlet 也无法覆盖安全权限。

-PassThru

-PassThru 参数用于将表示项目的对象传递给管道。 默认情况下，set-item cmdlet 不会生成任何输出。

-Filter

-Filter 参数用于指定一个筛选器来限定 -Path 参数。 FileSystem 提供程序是唯一支持使用筛选器的 PowerShell 提供程序。 此参数更有效，因为提供程序在 cmdlet 获取对象时应用筛选器，而不是让 Powershell 在访问对象后筛选对象。

-Value

-Value 参数用于指定项目的新值。

-Exclude

此 cmdlet 在操作中排除的项目指定为字符串数组。 -Exclude 参数的值限定 -Path 参数。 输入模式或路径元素，例如 *.txt。 接受通配符。 -Exclude 参数仅在 cmdlet 包含项目的内容时有效，例如 C:\*，通配符 '*' 用于指定 C: 目录的内容。

-Include

此 cmdlet 在操作中包含的项目指定为字符串数组。 -Include 参数的值限定 -Path 参数。 输入模式或路径元素，例如 *.txt。 允许使用通配符。 它仅在 cmdlet 包含项目的内容时有效，例如 C:\*，通配符 '*' 用于指定 C: 目录的内容。

-WhatIf

-WhatIf 参数用于显示如果执行 cmdlet 会发生什么情况。 不运行 cmdlet。

-Confirm

-Confirm 参数在运行 cmdlet 之前提示确认。

<Commonparameters>

此 cmdlet 支持以下常见参数，它们的别名列在括号中

• Debug (db)
• Verbose (vb)
• PipelineVariable (pv)
• ErrorAction (ea)
• ErrorVariable (ev)
• OutVariable (ov)
• OutBuffer (ob)
• WarningAction (wa)
• WarningVariable (wv)

示例

示例 1：创建别名

此示例中的 cmdlet 用于为 Notepad 创建别名。

示例 2：修改提示符函数

此示例中的 cmdlet 用于更改提示符函数，使其在路径之前显示时间。