New-ItemProperty

Crea una nueva propiedad para un elemento y establece su valor. Por ejemplo, puede utilizar New-ItemProperty para crear y cambiar datos y valores del Registro, que son propiedades de una clave del Registro.

Sintaxis

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

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

Descripción

El cmdlet New-ItemProperty crea una nueva propiedad para un elemento especificado y establece su valor. Normalmente, este cmdlet se utiliza para crear nuevos valores del Registro, porque los valores del Registro son propiedades de un elemento de clave del Registro.

Este cmdlet no agrega propiedades a un objeto. Para agregar una propiedad a una instancia de un objeto, utilice el cmdlet Add-Member. Para agregar una propiedad a todos los objetos de un tipo determinado, edite el archivo Types.ps1xml.

Parámetros

-Credential <PSCredential>

Especifica una cuenta de usuario con permiso para realizar esta acción. El valor predeterminado es el usuario actual.

Escriba un nombre de usuario, como "Usuario01" o "Dominio01\Usuario01", o bien, escriba un objeto PSCredential, como uno generado por el cmdlet Get-Credential. Si escribe un nombre de usuario se le pedirá una contraseña.

Este parámetro no es compatible con los proveedores que se instalan con Windows PowerShell.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	true (ByPropertyName)
¿Aceptar caracteres comodín?	false

-Exclude <string[]>

Omite los elementos especificados. Se permite el uso de caracteres comodín.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-Filter <string>

Especifica un filtro en el formato o lenguaje del proveedor. El valor de este parámetro califica el parámetro Path.

La sintaxis del filtro, incluido el uso de caracteres comodín, depende del proveedor. Los filtros son más eficaces que otros parámetros, ya que el proveedor los aplica al recuperar los objetos en lugar de hacer que Windows PowerShell filtre los objetos después de recuperarlos.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-Force

Permite al cmdlet crear una propiedad en un objeto al que el usuario no puede tener acceso de ningún otro modo. La implementación varía según el proveedor. Para obtener más información, vea about_Providers.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-Include <string[]>

El valor de este parámetro califica el parámetro Path. Escriba un patrón o un elemento de la ruta de acceso, como "*.txt". Se permite el uso de caracteres comodín.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-LiteralPath <string[]>

Especifica la ruta de la propiedad del elemento. El valor de LiteralPath se usa literalmente como se escribe. Ningún carácter se interpretará como un carácter comodín. Si la ruta incluye caracteres de escape, escríbala entre comillas simples. Las comillas simples indican a Windows PowerShell que no debe interpretar los caracteres como secuencias de escape.

¿Requerido?	true
¿Posición?	1
Valor predeterminado
¿Aceptar canalización?	true (ByPropertyName)
¿Aceptar caracteres comodín?	false

-Name <string>

Especifica un nombre para la nueva propiedad. Si la propiedad es una entrada del Registro, este parámetro especifica el nombre de la entrada.

¿Requerido?	true
¿Posición?	2
Valor predeterminado
¿Aceptar canalización?	true (ByPropertyName)
¿Aceptar caracteres comodín?	false

-Path <string[]>

Especifica la ruta de acceso al elemento. Este parámetro identifica el elemento al que se agregará la nueva propiedad.

¿Requerido?	true
¿Posición?	1
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-PropertyType <string>

Especifica el tipo de propiedad que se agregará.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	true (ByPropertyName)
¿Aceptar caracteres comodín?	false

-Value <Object>

Especifica el valor de la propiedad. Si la propiedad es una entrada del Registro, este parámetro especifica el valor de la entrada.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	true (ByPropertyName)
¿Aceptar caracteres comodín?	false

-Confirm

Solicita confirmación antes de ejecutar el comando.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-WhatIf

Describe lo que ocurriría si ejecutara el comando sin ejecutarlo realmente.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-UseTransaction

Incluye el comando en la transacción activa. Este parámetro sólo es válido cuando hay una transacción en curso. Para obtener más información, vea about_Transactions.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

<CommonParameters>

Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.

Entradas y salidas

El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.

Entradas	Ninguno No se puede canalizar la entrada a New-ItemProperty.
Salidas	System.Management.Automation.PSCustomObject New-ItemProperty devuelve un objeto personalizado que contiene la nueva propiedad.

Notas

El cmdlet New-ItemProperty está diseñado para funcionar con los datos expuestos por cualquier proveedor. Para mostrar los proveedores que están disponibles en la sesión, escriba "Get-PSProvider". Para obtener más información, vea about_Providers.

Ejemplo 1

C:\PS>new-itemproperty -path HKLM:\Software\MyCompany -name NoOfEmployees -value 822

C:\PS> get-itemproperty 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 : 822

Descripción
-----------
Este comando agrega una nueva entrada del Registro, NoOfEmployees, a la clave MyCompany del subárbol HKLM:\Software.

El primer comando utiliza el parámetro Path para especificar la ruta de acceso a la clave del Registro MyCompany. Utiliza el parámetro Name para especificar un nombre para la entrada y el parámetro Value para especificar su valor.

El segundo comando usa el cmdlet Get-ItemProperty para ver la nueva entrada del Registro.

Ejemplo 2

C:\PS>get-item -path HKLM:\Software\MyCompany | new-Itemproperty -name NoOfLocations -value 3

Descripción
-----------
Este comando agrega una nueva entrada del Registro a una clave del Registro. Para especificar la clave, utiliza un operador de canalización (|) para enviar un objeto que representa la clave al cmdlet New-ItemProperty.

La primera parte del comando utiliza el cmdlet Get-Item para obtener la clave del Registro MyCompany. El operador de canalización (|) envía los resultados del comando al cmdlet New-ItemProperty, que agrega la nueva entrada del Registro, NoOfLocations, y su valor, 3, a la clave MyCompany.

Este comando funciona porque la característica de enlace de parámetros de Windows PowerShell asocia la ruta de acceso del objeto RegistryKey que Get-Item devuelve al parámetro LiteralPath de New-ItemProperty. Para obtener más información, vea about_Pipelines.

Vea también

Conceptos

about_Providers
Clear-ItemProperty
Copy-ItemProperty
Move-ItemProperty
Rename-ItemProperty
Get-ItemProperty
Set-ItemProperty
Remove-ItemProperty