Compartir a través de

Remove-ItemProperty

  • Referencia
Módulo:
Microsoft.PowerShell.Management

Elimina la propiedad y su valor de un elemento.

Sintaxis

Remove-ItemProperty
      [-Path] <String[]>
      [-Name] <String[]>
      [-Force]
      [-Filter <String>]
      [-Include <String[]>]
      [-Exclude <String[]>]
      [-Credential <PSCredential>]
      [-InformationAction <ActionPreference>]
      [-InformationVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-ItemProperty
      -LiteralPath <String[]>
      [-Name] <String[]>
      [-Force]
      [-Filter <String>]
      [-Include <String[]>]
      [-Exclude <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

El cmdlet Remove-ItemProperty elimina una propiedad y su valor de un elemento. Puede usarlo para eliminar los valores del Registro y los datos que almacenan.

Ejemplos

Ejemplo 1: Eliminación de un valor del Registro

Este comando elimina el valor del Registro "SmpProperty" y sus datos, de la subclave "SmpApplication" de la clave del Registro de HKEY_LOCAL_MACHINE\Software.

Remove-ItemProperty -Path "HKLM:\Software\SmpApplication" -Name "SmpProperty"

Dado que el comando se emite desde una unidad del sistema de archivos (PS C:\>), incluye la ruta de acceso completa de la subclave "SmpApplication", incluida la unidad, HKLM:y la clave "Software".

Ejemplo 2: Eliminación de un valor del Registro de la ubicación HKCU

Estos comandos eliminan el valor del Registro "Options" y sus datos, de la subclave "MyApp" de "HKEY_CURRENT_USER\Software\MyCompany".

PS C:\> Set-Location HKCU:\Software\MyCompany\MyApp
PS HKCU:\Software\MyCompany\MyApp> Remove-ItemProperty -Path . -Name "Options" -Confirm

El primer comando usa el cmdlet Set-Location para cambiar la ubicación actual a la unidad HKEY_CURRENT_USER (HKCU:) y la subclave Software\MyCompany\MyApp.

El segundo comando usa Remove-ItemProperty para quitar el valor del Registro "Options" y sus datos, de la subclave "MyApp". Dado que se requiere ruta de acceso, el comando usa un punto (.) para indicar la ubicación actual. El parámetro Confirm solicita un mensaje de usuario antes de eliminar el valor.

Ejemplo 3: Eliminación de un valor del Registro mediante la canalización

Este comando elimina el valor del Registro "NoOfEmployees" y sus datos, de la clave del Registro HKLM\Software\MyCompany.

Get-Item -Path HKLM:\Software\MyCompany | Remove-ItemProperty -Name NoOfEmployees

El comando usa el cmdlet Get-Item para obtener un elemento que representa la clave del Registro. Usa un operador de canalización (|) para enviar el objeto a Remove-ItemProperty. A continuación, usa el parámetro Name de Remove-ItemProperty para especificar el nombre del valor del Registro.

Parámetros

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Credential

Nota

Este parámetro no es compatible con ningún proveedor instalado con PowerShell. Para suplantar a otro usuario o elevar las credenciales al ejecutar este cmdlet, use Invoke-Command.

Tipo:PSCredential
Posición:Named
Valor predeterminado:Current user
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Exclude

Especifica, como matriz de cadenas, un elemento o elementos que este cmdlet excluye en la operación. El valor de este parámetro especifica el parámetro Path. Escriba un elemento o patrón de ruta, 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.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:True

-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.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:True

-Force

Obliga al cmdlet a quitar una propiedad de 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.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Include

Especifica, como matriz de cadenas, un elemento o elementos que este cmdlet incluye en la operación. El valor de este parámetro especifica el parámetro Path. Escriba un elemento o patrón de ruta, 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.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:True

-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.

Tipo:String[]
Alias:PSPath, LP
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Name

Especifica los nombres de las propiedades que se van a quitar. Se permite el uso de caracteres comodín.

Tipo:String[]
Alias:PSProperty
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:True

-Path

Especifica la ruta de acceso del elemento cuyas propiedades se quitan. Se permite el uso de caracteres comodín.

Tipo:String[]
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:True

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

String

Puede canalizar una cadena que contenga una ruta de acceso, pero no una ruta de acceso literal, a este cmdlet.

Salidas

None

Este cmdlet no devuelve ninguna salida.

Notas

PowerShell incluye los siguientes alias para Remove-ItemProperty:

  • Todas las plataformas:

    • rp

  • En el proveedor del Registro de PowerShell, los valores del Registro se consideran propiedades de una clave del Registro o una subclave. Puede usar los cmdlets ItemProperty para administrar estos valores.

  • Remove-ItemProperty está diseñado para trabajar con los datos expuestos por cualquier proveedor. Para enumerar los proveedores disponibles en la sesión, escriba Get-PSProvider. Para obtener más información, consulte about_Providers.