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

Descripción
-----------
Este comando establece el valor de la propiedad IsReadOnly del archivo final.doc en true. 

El comando utiliza el cmdlet Set-ItemProperty para cambiar el valor de la propiedad del archivo final.doc. Usa el parámetro Path para especificar el archivo. Usa el parámetro Name para especificar el nombre de la propiedad y el parámetro Value para especificar el nuevo valor.

La variable automática $true representa un valor TRUE. Para obtener más información, vea about_Automatic_Variables.

El archivo es un objeto System.IO.FileInfo y la propiedad IsReadOnly es una de sus propiedades. Para ver todos los métodos y propiedades de un objeto FileInfo, canalice el archivo al cmdlet Get-Member. Por ejemplo, "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

Descripción
-----------
En este ejemplo, se muestra cómo utilizar Set-ItemProperty para crear una nueva entrada del Registro y asignar un valor a la entrada. Crea la entrada NoOfEmployees de la clave MyCompany en la clave HKLM\Software y establece su valor en 823.

Dado que se considera que las entradas del Registro son propiedades de las claves del Registro (que son elementos), se debe utilizar Set-ItemProperty para crear entradas del Registro y para establecer y cambiar sus valores.

El primer comando utiliza el cmdlet Set-ItemProperty para crear la entrada del Registro. Utiliza el parámetro Path para especificar la ruta de acceso a la unidad HKLM: y la clave Software\MyCompany. Utiliza el parámetro Name para especificar el nombre de la entrada y el parámetro Value para especificar un valor.

El segundo comando usa el cmdlet Get-ItemProperty para ver la nueva entrada del Registro. Si utiliza el cmdlet Get-Item o Get-ChildItem, las entradas no aparecerán porque son propiedades de una clave; no son elementos ni elementos secundarios.

El tercer comando cambia el valor de la entrada NoOfEmployees a 824.

También puede utilizar el cmdlet New-ItemProperty para crear la entrada del Registro y su valor, y a continuación, utilizar Set-ItemProperty para cambiar el valor.

Para obtener más información sobre la unidad HKLM:, escriba "get-help get-psdrive". Para obtener más información sobre cómo se utiliza Windows PowerShell para administrar el Registro, escriba "get-help registry".

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

Descripción
-----------
Estos comandos muestran cómo utilizar un operador de canalización (|) para enviar un elemento a Set-ItemProperty. 

La primera parte del comando usa el cmdlet Get-ChildItem para obtener un objeto que representa el archivo Weekly.txt. El comando utiliza un operador de canalización para enviar el objeto de archivo a Set-ItemProperty. El comando Set-ItemProperty utiliza los parámetros Name y Value para especificar la propiedad y su nuevo valor.

Este comando es equivalente a utilizar el parámetro InputObject para especificar el objeto que Get-ChildItem obtiene.