Set-ItemProperty

Set-ItemProperty [-LiteralPath] <string[]> -InputObject <psobject> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]

Set-ItemProperty [-Path] <string[]> -InputObject <psobject> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]

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

Set-ItemProperty [-Path] <string[]> [-Name] <string> [-Value] <Object> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]

C:\PS>set-itemproperty -path c:\GroupFiles\final.doc -name IsReadOnly -value $true

说明
-----------
此命令将 final.doc 文件的 IsReadOnly 参数的值设置为 true。

此命令使用 Set-ItemProperty cmdlet 来更改 final.doc 文件的属性值。它使用 Path 参数来指定文件，使用 Name 参数指定属性的名称，并使用 Value 参数指定属性的新值。

$true 自动变量表示值 TRUE。有关详细信息，请参阅 about_Automatic_Variables。

该文件是一个 System.IO.FileInfo 对象，IsReadOnly 只是该文件的一个属性。若要查看 FileInfo 对象的所有属性和方法，请通过管道将该文件传递给 Get-Member cmdlet。例如，“final.doc | get-member”。

C:\PS>set-itemproperty -path HKLM:\Software\MyCompany -name NoOfEmployees -value 823

C:\PS>get-itemproperty -path HKLM:\Software\MyCompany

PSPath        : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\software\mycompany
PSParentPath  : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\software
PSChildName   : mycompany
PSDrive       : HKLM
PSProvider    : Microsoft.PowerShell.Core\Registry
NoOfLocations : 2
NoOfEmployees : 823

C:\PS>set-itemproperty -path HKLM:\Software\MyCompany -name NoOfEmployees -value 824
C:\PS>get-itemproperty -path HKLM:\Software\MyCompany


PSPath        : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\software\mycompany
PSParentPath  : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\software
PSChildName   : mycompany
PSDrive       : HKLM
PSProvider    : Microsoft.PowerShell.Core\Registry
NoOfLocations : 2
NoOfEmployees : 824

说明
-----------
此示例演示如何使用 Set-ItemProperty 创建新的注册表条目并为该条目赋值。它在 HKLM\Software 项的 MyCompany 项中创建 NoOfEmployees 条目，并将该条目的值设置为 823。

因为注册表条目被视为是注册表项（项目）的属性，所以应使用 Set-ItemProperty 来创建注册表条目以及设定和更改它们的值。

第一条命令使用 Set-ItemProperty cmdlet 创建该注册表条目。它使用 Path 参数指定 HKLM: 驱动器和 Software\MyCompany 项的路径，使用 Name 参数指定该条目的名称，使用 Value 参数指定该条目的值。

第二条命令使用 Get-ItemProperty cmdlet 查看新的注册表条目。如果使用 Get-Item 或 Get-ChildItem cmdlet，则不会出现注册表条目，因为它们是项属性，而不是项或子项。

第三条命令将 NoOfEmployees 条目的值更改为 824。

也可以使用 New-ItemProperty cmdlet 创建注册表条目及其值，然后再使用 Set-ItemProperty 更改该值。

有关 HKLM: 驱动器的详细信息，请键入“get-help get-psdrive”。有关使用 Windows PowerShell 管理注册表的详细信息，请键入“get-help registry”。

C:\PS>get-childitem weekly.txt | set-itemproperty -name IsReadOnly -value $true

说明
-----------
这些命令演示如何使用管道运算符 (|) 将项发送给 Set-ItemProperty。

此命令的第一部分使用 Get-ChildItem cmdlet 获取一个表示 Weekly.txt 文件的对象。此命令使用管道运算符将该文件对象发送给 Set-ItemProperty。Set-ItemProperty 命令使用 Name 和 Value 参数分别指定属性及其新值。

此命令与使用 InputObject 参数指定 Get-ChildItem 所获取的对象是等效的。