New-ItemProperty

Sintaxis

Path (valor predeterminado)

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

LiteralPath

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

Description

Ejemplos

Ejemplo 1: Agregar una entrada del Registro

New-ItemProperty -Path "HKLM:\Software\MyCompany" -Name "NoOfEmployees" -Value 822
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

Ejemplo 2: Agregar una entrada del Registro a una clave

Get-Item -Path "HKLM:\Software\MyCompany" | New-ItemProperty -Name NoOfLocations -Value 3

Ejemplo 3: Creación de un valor multistring en el Registro mediante un Here-String

$newValue = New-ItemProperty -Path "HKLM:\SOFTWARE\ContosoCompany\" -Name 'HereString' -PropertyType MultiString -Value @"
This is text which contains newlines
It can also contain "quoted" strings
"@
$newValue.multistring

This is text which contains newlines
It can also contain "quoted" strings

Ejemplo 4: Creación de un valor multistring en el Registro mediante una matriz

$newValue = New-ItemProperty -Path "HKLM:\SOFTWARE\ContosoCompany\" -Name 'MultiString' -PropertyType MultiString -Value ('a','b','c')
$newValue.multistring[0]

a

Parámetros

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades de parámetro

Conjuntos de parámetros

-Credential

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

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

Propiedades de parámetro

Conjuntos de parámetros

-Exclude

Especifica, como matriz de cadenas, un elemento o elementos que este cmdlet excluye en la operación. El valor de este parámetro define el parámetro Path. Escriba un elemento de ruta o patrón, como *.txt. Se permite el uso de caracteres comodín. El parámetro Exclude solo es efectivo cuando el comando incluye el contenido de un elemento, como C:\Windows\*, donde el carácter comodín especifica el contenido del directorio C:\Windows.

Propiedades de parámetro

Conjuntos de parámetros

-Filter

Especifica un filtro para calificar el parámetro Path. El proveedor de FileSystem es el único proveedor de PowerShell instalado que admite el uso de filtros. Puede encontrar la sintaxis del lenguaje de filtro de FileSystem en about_Wildcards. Los filtros son más eficaces que otros parámetros, ya que el proveedor los aplica cuando el cmdlet obtiene los objetos en lugar de que PowerShell filtre los objetos una vez recuperados.

Propiedades de parámetro

Conjuntos de parámetros

-Force

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

Propiedades de parámetro

Conjuntos de parámetros

-Include

Especifica, como matriz de cadenas, un elemento o elementos que este cmdlet incluye en la operación. El valor de este parámetro define el parámetro Path. Escriba un elemento de ruta o patrón, como *.txt. Se permite el uso de caracteres comodín. El parámetro Include solo es efectivo cuando el comando incluye el contenido de un elemento, como C:\Windows\*, donde el carácter comodín especifica el contenido del directorio C:\Windows.

Propiedades de parámetro

Conjuntos de parámetros

-LiteralPath

Especifica una ruta de acceso a una o varias ubicaciones. El valor de LiteralPath se usa tal como está escrito. Ninguno de los caracteres se interpreta como caracteres comodín. Si la ruta de acceso incluye caracteres de escape, escríbala entre comillas simples ('). Las comillas simples indican a PowerShell que no interprete ningún carácter como secuencias de escape.

Para obtener más información, consulte sobre_las_normas_de_citación.

Propiedades de parámetro

Conjuntos de parámetros

-Name

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

Propiedades de parámetro

Conjuntos de parámetros

-Path

Especifica la ruta de acceso del elemento. Se permite el uso de caracteres comodín. Este parámetro identifica el elemento al que este cmdlet agrega la nueva propiedad.

Propiedades de parámetro

Conjuntos de parámetros

-PropertyType

Se trata de un parámetro dinámico que el proveedor del Registro pone a disposición. El proveedor del Registro de y este parámetro solo están disponibles en Windows.

Especifica el tipo de propiedad que agrega este cmdlet. Los valores aceptables para este parámetro son:

• String: especifica una cadena terminada en NULL. Se usa para los valores de REG_SZ.
• ExpandString: especifica una cadena terminada en NULL que contiene referencias no expandidas a variables de entorno que se expanden cuando se recupera el valor. Se utiliza para los valores de REG_EXPAND_SZ.
• Binary: especifica datos binarios en cualquier formato. Se usa para los valores de REG_BINARY.
• DWord: especifica un número binario de 32 bits. Se utiliza para los valores REG_DWORD.
• MultiString: Especifica una matriz de cadenas terminadas en nulo, finalizadas con dos caracteres nulos. Se utiliza para los valores de REG_MULTI_SZ.
• Qword: especifica un número binario de 64 bits. Se utiliza para valores de REG_QWORD.
• Unknown: indica un tipo de datos del Registro no admitido, como valores REG_RESOURCE_LIST.

Propiedades de parámetro

Conjuntos de parámetros

-Value

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

Propiedades de parámetro

Conjuntos de parámetros

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Propiedades de parámetro

Conjuntos de parámetros

CommonParameters

Entradas

None

Salidas

PSCustomObject

Notas

Vínculos relacionados

• Clear-ItemProperty
• Copy-ItemProperty
• Get-ItemProperty
• Move-ItemProperty
• Remove-ItemProperty
• Rename-ItemProperty
• Set-ItemProperty
• Acerca de los Proveedores