PowerShell set-item实例

本文概述

• 句法
• 参数
• 例子

PowerShell Set-Item cmdlet将项目的值更改为命令中指定的值。它更改变量或注册表项的值。 Windows PowerShell文件系统提供程序不支持此cmdlet。在注册表驱动器中, 例如HKLM：和HKCU：它会更改注册表项默认值中的数据。

句法

Set-Item
[-Path<String[]>]
[-Force] 
[-PassThru] 
[-Filter <String[]>]
[-Value<Object>] 
[-Exclude <String[]>]
[-Include <String[]>]
[-Credential <PSCredential>] 
[-WhatIf] 
[-Confirm]
[<CommonParameters>]

Set-Item
[[-Value] <Object>]
[-LiteralPath <string[]>]
[-Force] 
[-PassThru] 
[-Filter <string>] 
[-Include <string[]>]
[-Exclude <string[]>] 
[-Credential <pscredential>] 
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]

参数

-路径

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

文学路径

-LiteralPath参数用于指定一个或多个位置的路径。此参数的值与键入时完全一样。如果路径包含转义字符, 则将其用引号引起来。没有字符被解释为通配符。单引号告诉Windows PowerShell, 它不应将任何字符解释为转义序列。

-力

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

直通

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

-过滤

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

-值

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

-排除

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

-包括

此cmdlet包括在操作中的项目被指定为字符串数组。 -Include参数的值限定-Path参数。输入模式或路径元素, 例如* .txt。允许使用通配符。仅当cmdlet包含项目的内容(例如C：\ *)时, 此命令才有效。通配符’*’用于指定C：目录的内容。

-如果

-WhatIf参数用于显示如果执行cmdlet将发生的情况。该cmdlet没有运行。

-确认

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

<通用参数>

此cmdlet支持以下常用参数, 其别名在括号中列出：

• 调试(db)
• 详细(vb)
• PipelineVariable(PV)
• ErrorAction(ea)
• ErrorVariable(主页)
• OutVariable(ov)
• 缓冲区溢出(ob)
• 警告动作(wa)
• WarningVariable(wv)

例子

示例1：创建别名

此示例中的cmdlet用于为记事本创建别名。

示例2：修改提示功能

此示例中的cmdlet用于更改提示功能, 以便显示路径之前的时间。