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 自動變數代表 NULL 值。如需詳細資訊，請參閱 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。

因為登錄項目被視為登錄機碼 (即項目 (Item)) 的屬性，所以您要使用 Set-ItemProperty 建立登錄項目 (Entry) 並建立與變更項目的值。

第一個命令使用 Set-ItemProperty Cmdlet 建立登錄項目。該命令使用 Path 參數指定 HKLM: 的路徑與 Software\MyCompany 機碼。該命令使用 Name 參數指定項目名稱，並且使用 Value 參數指定項目的值。

第二個命令使用 Get-ItemProperty Cmdlet 檢視新登錄項目。如果您使用 Get-Item 或 Get-ChildItem Cmdlet，因為這些項目 (Entry) 屬於機碼的屬性，而非項目 (Item) 或子項目，所以不會顯示這些項目 (Entry)。

第三個命令會將 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 取得的物件相同。