Remove-ItemProperty
Elimina una propiedad y su valor de un elemento.
Syntax
Remove-ItemProperty
[-Path] <String[]>
[-Name] <String[]>
[-Force]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]
Remove-ItemProperty
-LiteralPath <String[]>
[-Name] <String[]>
[-Force]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]
Description
El Remove-ItemProperty
cmdlet 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 "HKEY_LOCAL_MACHINE\Software".
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".
Usa el parámetro Name para identificar el valor del Registro que se va a eliminar.
Remove-ItemProperty -Path "HKLM:\Software\SmpApplication" -Name "SmpProperty"
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".
El primer comando usa el Set-Location
cmdlet 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 la ruta de acceso es necesaria, el comando usa un punto ('.') para indicar la ubicación actual.
Usa Name para especificar el valor del Registro que se va a eliminar.
Usa el parámetro Confirm para solicitar un mensaje de usuario antes de eliminar el valor.
PS C:\> Set-Location HKCU:\Software\MyCompany\MyApp
PS HKCU:\Software\MyCompany\MyApp> Remove-ItemProperty -Path . -Name "Options" -Confirm
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".
El comando usa el Get-Item
cmdlet 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.
Get-Item -Path HKLM:\Software\MyCompany | Remove-ItemProperty -Name NoOfEmployees
Parámetros
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | PSCredential |
Position: | Named |
Default value: | Current user |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Exclude
Especifica los elementos que este cmdlet omite. El valor de este parámetro califica el parámetro Path . Escriba un elemento de ruta de acceso o un patrón, como "*.txt". Se permite el uso de caracteres comodín.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Filter
Especifica un filtro en el formato o idioma 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 cuando el cmdlet obtiene los objetos en lugar de que PowerShell filtre los objetos una vez recuperados.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 en función del proveedor. Para obtener más información, consulte about_Providers.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 califica el parámetro Path . Escriba un elemento de ruta de acceso o un patrón, como "*.txt". Se permite el uso de caracteres comodín.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-LiteralPath
Especifica la ruta de acceso a la ubicación actual de la propiedad. A diferencia del parámetro Path , el valor de LiteralPath se usa exactamente como se escribe. Ninguno de los caracteres se interpreta como caracteres comodín. Si la ruta de acceso contiene caracteres de escape, escríbalos entre comillas simples. Las comillas simples indican a PowerShell que no interprete ningún carácter como secuencias de escape.
Type: | String[] |
Aliases: | PSPath |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Especifica los nombres de las propiedades que se van a quitar. Se permite el uso de caracteres comodín.
Type: | String[] |
Aliases: | PSProperty |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Path
Especifica la ruta de acceso del elemento cuyas propiedades se quitan. Se permite el uso de caracteres comodín.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-UseTransaction
Incluye el comando en la transacción activa. Este parámetro solo es válido cuando hay una transacción en curso. Para obtener más información, consulte about_Transactions.
Type: | SwitchParameter |
Aliases: | usetx |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
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 ningún resultado.
Notas
Windows PowerShell incluye los siguientes alias para Remove-ItemProperty
:
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.
Vínculos relacionados
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de