Elimina la propiedad y su valor de un elemento.
Sintaxis
Remove-ItemProperty [-LiteralPath] <string[]> [-Name] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>] Remove-ItemProperty [-Path] <string[]> [-Name] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]
Descripción
El cmdlet Remove-ItemProperty elimina una propiedad y su valor de un elemento. Puede usarlo para eliminar valores del Registro y los datos que contienen.
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. 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 |
-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 quitar una propiedad de un objeto al que el usuario no puede obtener 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[]>
Elimina únicamente los elementos especificados. 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 los nombres de las propiedades que se van a recuperar.
|
¿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 cuyas propiedades se van a quitar. Se permite el uso de caracteres comodín.
|
¿Requerido? |
true |
|
¿Posición? |
1 |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
true (ByValue, 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 solo 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 |
System.String Puede canalizar a Remove-ItemProperty una cadena que contiene una ruta de acceso (que no sea una ruta de acceso literal). |
|
Salidas |
Ninguno Este cmdlet no devuelve resultados. |
Notas
También puede hacer referencia a Remove-ItemProperty mediante su alias integrado, "rp". Para obtener más información, vea about_Alias.
En el proveedor Registry de Windows PowerShell, los valores del Registro se consideran propiedades de una clave o subclave del Registro. Puede usar los cmdlets ItemProperty para administrar estos valores.
El cmdlet Remove-ItemProperty está diseñado de modo que funcione 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>remove-itemproperty -path HKLM:\Software\SmpApplication -name SmpProperty Descripción ----------- Este comando elimina el valor del Registro SmpProperty, y sus datos, de la subclave SmpApplication de la clave del Registro HKEY_LOCAL_MACHINE\Software. Como el comando se emite desde una unidad del sistema de archivos (C:\PS>), incluye la ruta completa a la subclave SmpApplication, incluidas la unidad, HKLM:, y la clave Software. Usa el parámetro Name para identificar el valor del Registro que se va a eliminar.
Ejemplo 2
C:\PS>set-location HKCU:\Software\MyCompany\MyApp PS HKCU:\Software\MyCompany\MyApp> remove-itemproperty -path . -Name Options -confirm Descripción ----------- Estos comandos eliminan del Registro el valor Options y sus datos, de la subclave MyApp de HKEY_CURRENT_USER\Software\MyCompany. 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 el cmdlet Remove-Item para quitar del Registro el valor Options y sus datos, de la subclave MyApp. Como el parámetro Path es obligatorio, el comando usa un punto (.) para indicar la ubicación actual. Usa el parámetro Name para especificar el valor del Registro que se va a eliminar. Usa el parámetro Confirm para solicitar la confirmación del usuario antes de eliminar el valor.
Ejemplo 3
C:\PS>get-item -path HKLM:\Software\MyCompany | remove-itemproperty -name NoOfEmployees Descripción ----------- Este comando elimina el valor del Registro NoOfEmployees, y sus datos, de la clave del Registro HKLM\Software\MyCompany. El comando utiliza el cmdlet Get-Item para obtener un elemento que representa la clave del Registro. Utiliza un operador de canalización (|) para enviar el objeto al cmdlet Remove-ItemProperty. A continuación, usa el parámetro Name de Remove-ItemProperty para especificar el nombre del valor del Registro.
Vea también