Clear-Item (Microsoft.PowerShell.Management)

Clear-Item

Módulo:

Microsoft.PowerShell.Management

Borra el contenido de un elemento, pero no lo elimina.

Sintaxis

Clear-Item
     [-Path] <String[]>
     [-Force]
     [-Filter <String>]
     [-Include <String[]>]
     [-Exclude <String[]>]
     [-Credential <PSCredential>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Clear-Item
     -LiteralPath <String[]>
     [-Force]
     [-Filter <String>]
     [-Include <String[]>]
     [-Exclude <String[]>]
     [-Credential <PSCredential>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Descripción

El cmdlet Clear-Item borra el contenido de un elemento, pero no lo elimina. Por ejemplo, el cmdlet Clear-Item puede eliminar el valor de una variable, pero no elimina la variable. El valor que solía representar un elemento compensado lo define cada proveedor de PowerShell. Este cmdlet es similar a Clear-Content, pero funciona con alias y variables, en lugar de archivos.

Ejemplos

Ejemplo 1: borrar el valor de una variable

Este comando borra el valor de la variable denominada TestVar1. La variable permanece y es válida, pero su valor se establece en $null. El nombre de la variable tiene el prefijo Variable: para indicar el proveedor de variables de PowerShell.

Los comandos alternativos muestran que, para obtener el mismo resultado, puede cambiar a la unidad Variable: de PowerShell y luego ejecutar el comando Clear-Item.

Clear-Item Variable:TestVar1

Set-Location Variable:
PS Variable:\> Clear-Item TestVar1

Ejemplo 2: borrar todas las entradas del registro

Este comando borra todas las entradas del registro en la subclave "MyKey", pero solo después de solicitarle que confirme su intención. No elimina la subclave "MyKey" ni afecta ninguna otra clave o entrada de registro. Puede utilizar los parámetros Incluir y Excluir para identificar claves de registro concretas, pero no puede utilizarlas para identificar entradas de registro.

• Para eliminar entradas de registro concretas, utilice el cmdlet Remove-ItemProperty.
• Para eliminar el valor de una entrada del registro, utilice el cmdlet Clear-ItemProperty.

Clear-Item HKLM:\Software\MyCompany\MyKey -Confirm

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

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

Indica que el cmdlet borra elementos que de otro modo no se pueden cambiar, como los alias de solo lectura. El cmdlet no puede borrar constantes. La implementación varía de un proveedor a otro. Para obtener más información, consulte about_Providers. El cmdlet no puede anular las restricciones de seguridad, incluso cuando se utiliza el parámetro Force.

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

-Path

Especifica la ruta a los elementos que se borran. Se permiten caracteres comodín. Este parámetro es obligatorio, pero el nombre del parámetro Ruta es opcional.

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 de ruta a este cmdlet.

Salidas

Ninguno

Este cmdlet no devuelve ningún resultado.

Notas

PowerShell incluye los siguientes alias para Clear-Item:

• Todas las plataformas:

  cli

• El cmdlet Clear-Item solo es compatible con varios proveedores de PowerShell, incluidos Alias, Environment, Function, Registro y proveedores de Variables. Como tal, puede utilizar Clear-Item para eliminar el contenido de los elementos en los espacios de nombres del proveedor. Para enumerar los proveedores disponibles en su sesión, escriba Get-PsProvider. Para obtener más información, consulte about_Providers.

• No puede utilizar Clear-Item para eliminar el contenido de un archivo porque el proveedor de PowerShell FileSystem no admite este cmdlet. Para borrar archivos, utilice Clear-Content.