Búsqueda de sitios web

Eliminar propiedad del elemento (Microsoft.PowerShell.Management)

Remove-ItemProperty

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

Descripción

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

Ejemplos

Ejemplo 1: eliminar un valor de registro

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

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

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

Ejemplo 2: eliminar un valor de registro de la ubicación de HKCU

Estos comandos eliminan el valor de registro "Opciones" 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 utiliza el cmdlet Set-Location para cambiar la ubicación actual a la unidad HKEY_CURRENT_USER (HKCU:) y el Software\ Subclave MiEmpresa\MiAplicación.

El segundo comando utiliza Remove-ItemProperty para eliminar el valor del registro "Opciones" y sus datos de la subclave "MyApp". Como se requiere Ruta, el comando utiliza un punto (.) para indicar la ubicación actual. El parámetro Confirmar solicita un mensaje al usuario antes de eliminar el valor.

Ejemplo 3: eliminar un valor de registro mediante la canalización

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

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

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

Parámetros

-Confirm

Le solicita confirmación antes de ejecutar el cmdlet.

Tipo :

SwitchParameter

Alias:

cf

Posición:

Nombrado

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 hacerse pasar por otro usuario o elevar sus credenciales al ejecutar este cmdlet, use Invoke-Command.

Tipo :

PSCredencial

Posición:

Nombrado

Valor predeterminado:

Usuario actual

Requerido:

False

Aceptar entrada de canalización:

True

Aceptar caracteres comodín:

False

-Exclude

Especifica, como una matriz de cadenas, uno o más elementos que este cmdlet excluye en la operación. El valor de este parámetro califica el parámetro Path. Introduzca un elemento o patrón de ruta, como *.txt. Se permiten caracteres comodín. El parámetro Excluir es efectivo solo cuando el comando incluye el contenido de un elemento, como C:\Windows\*, donde el carácter comodín especifica el contenido del C:\Windows.

Tipo :

String[]

Posición:

Nombrado

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 FileSystem es el único proveedor de PowerShell instalado que admite el uso de filtros. Puede encontrar la sintaxis del idioma de filtro FileSystem en about_Wildcards. Los filtros son más eficientes que otros parámetros, porque el proveedor los aplica cuando el cmdlet obtiene los objetos en lugar de que PowerShell filtre los objetos después de recuperarlos.

Tipo :

String

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

True

-Force

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

Tipo :

SwitchParameter

Posición:

Nombrado

Valor predeterminado:

False

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

-Include

Especifica, como una matriz de cadenas, uno o varios elementos que este cmdlet incluye en la operación. El valor de este parámetro califica el parámetro Path. Introduzca un elemento de ruta o patrón, como "*.txt". Se permiten caracteres comodín. El parámetro Incluir es efectivo solo cuando el comando incluye el contenido de un elemento, como C:\Windows\*, donde el carácter comodín especifica el contenido del C:\Windows.

Tipo :

String[]

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

True

-LiteralPath

Especifica una ruta a una o más ubicaciones. El valor de LiteralPath se utiliza exactamente tal como se escribe. Ningún carácter se interpreta como comodín. Si la ruta incluye caracteres de escape, escríbala entre comillas simples. Las comillas simples le indican a PowerShell que no interprete ningún carácter como secuencia de escape.

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

Tipo :

String[]

Alias:

PSPath, LP

Posición:

Nombrado

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 eliminarán. Se permiten 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 del elemento cuyas propiedades se están eliminando. Se permiten 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 se ejecuta el cmdlet. El cmdlet no se ejecuta.

Tipo :

SwitchParameter

Alias:

wi

Posición:

Nombrado

Valor predeterminado:

False

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

Entradas

Cadena

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

Salidas

Ninguno

Este cmdlet no devuelve ningún resultado.

Notas

PowerShell incluye los siguientes alias para Remove-ItemProperty:

  • Todas las plataformas:

      rp

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

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

Artículos relacionados