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

Описание
-----------
Эта команда присваивает свойству IsReadOnly файла final.doc значение "true". 

Команда изменяет значение свойства файла final.doc с помощью командлета Set-ItemProperty. Для задания файла используется параметр Path. Параметр Name используется для задания имени свойства, а параметр Value — для задания нового значения.

Автоматическая переменная $true представляет значение TRUE. Дополнительные сведения см. в разделе about_Automatic_Variables.

Файл является объектом System.IO.FileInfo, и IsReadOnly — лишь одно из его свойств. Чтобы просмотреть все свойства и методы объекта FileInfo, передайте файл по конвейеру командлету Get-Member. Например: "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 для создания новой записи в реестре и присвоения этой записи значения. В нем создается запись NoOfEmployees в разделе MyCompany, который находится в разделе HKLM\Software, и этой записи присваивается значение 823.

Поскольку записи реестра рассматриваются как свойства разделов реестра (которые представляют собой элементы), командлет Set-ItemProperty можно использовать для создания записей реестра, а также для задания и изменения их значений.

Первая команда с помощью командлета Set-ItemProperty создает запись реестра. Для задания пути к диску HKLM: и разделу Software\MyCompany используется параметр Path. Параметр Name используется для задания имени записи, а параметр Value — для задания значения.

Вторая команда с помощью командлета Get-ItemProperty отображает новую запись реестра. Просмотреть записи с помощью командлета Get-Item или Get-ChildItem нельзя, поскольку записи являются свойствами раздела, а не элементами или дочерними элементами.

Третья команда изменяет значение записи NoOfEmployees на 824.

Также можно создать запись реестра и ее значение с помощью командлета New-ItemProperty, а затем с помощью командлета 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 для получения объекта, представляющего файл Weekly.txt. С помощью оператора конвейера объект файла пересылается командлету Set-ItemProperty. Параметры Name и Value команды Set-ItemProperty используются для задания свойства и его нового значения.

Эта команда эквивалентна использованию параметра InputObject для задания объекта, получаемого командлетом Get-ChildItem.