Clear-Item

Riferimento

Modulo:: Microsoft.PowerShell.Management

Cancella il contenuto di un elemento, ma non elimina l'elemento.

Sintassi

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

Descrizione

Il cmdlet Clear-Item cancella il contenuto di un elemento, ma non elimina l'elemento. Ad esempio, il cmdlet Clear-Item può eliminare il valore di una variabile, ma non elimina la variabile. Il valore usato per rappresentare un elemento cancellato è definito da ogni provider di PowerShell. Questo cmdlet è simile a Clear-Content, ma funziona su alias e variabili, anziché sui file.

Esempio

Esempio 1: Cancellare il valore di una variabile

Questo comando cancella il valore della variabile denominata TestVar1. La variabile rimane e è valida, ma il relativo valore è impostato su $null. Il nome della variabile è preceduto da Variable: per indicare il provider di variabili di PowerShell.

I comandi alternativi mostrano che, per ottenere lo stesso risultato, è possibile passare all'unità Variable: di PowerShell e quindi eseguire il comando Clear-Item.

Clear-Item Variable:TestVar1

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

Esempio 2: Cancellare tutte le voci del Registro di sistema

Questo comando cancella tutte le voci del Registro di sistema nella sottochiave "MyKey", ma solo dopo aver richiesto di confermare l'intento. Non elimina la sottochiave "MyKey" o influisce su altre chiavi o voci del Registro di sistema. È possibile usare i parametri di Includi e Exclude per identificare chiavi specifiche del Registro di sistema, ma non è possibile usarle per identificare le voci del Registro di sistema.

Per eliminare voci specifiche del Registro di sistema, usare il cmdlet Remove-ItemProperty.
Per eliminare il valore di una voce del Registro di sistema, utilizzare il Clear-ItemProperty cmdlet.

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

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:	SwitchParameter
Alias:	cf
Posizione:	Named
Valore predefinito:	False
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Credential

Nota

Questo parametro non è supportato da alcun provider installato con PowerShell. Per rappresentare un altro utente o elevare le credenziali quando si esegue questo cmdlet, usare Invoke-Command.

Tipo:	PSCredential
Posizione:	Named
Valore predefinito:	Current user
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-Exclude

Specifica, come matrice di stringhe, un elemento o elementi esclusi dal cmdlet nell'operazione. Il valore di questo parametro qualifica il parametro Path. Immettere un elemento o un modello di percorso, ad esempio *.txt. Sono consentiti i caratteri jolly. Il parametro Exclude è valido solo quando il comando include il contenuto di un elemento, come ad esempio C:\Windows\*, in cui il carattere jolly specifica il contenuto della directory C:\Windows.

Tipo:	String[]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	True

-Filter

Specifica un filtro per qualificare il parametro Path. Il provider di FileSystem è l'unico provider di PowerShell installato che supporta l'uso dei filtri. È possibile trovare la sintassi del linguaggio di filtro FileSystem in about_Wildcards. I filtri sono più efficienti rispetto ad altri parametri, perché il provider li applica quando il cmdlet ottiene gli oggetti anziché filtrare gli oggetti dopo il recupero.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	True

-Force

Indica che il cmdlet cancella gli elementi che altrimenti non possono essere modificati, ad esempio alias di sola lettura. Il cmdlet non può cancellare le costanti. L'implementazione varia da provider a provider. Per altre informazioni, vedere about_Providers. Il cmdlet non può eseguire l'override delle restrizioni di sicurezza, anche quando viene usato il parametro Force.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	False
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Include

Specifica, sotto forma di matrice di stringhe, un elemento o elementi che questo cmdlet include nell'operazione. Il valore di questo parametro qualifica il parametro Path. Immettere un elemento o un modello di percorso, ad esempio "*.txt". Sono consentiti i caratteri jolly. Il parametro Includi è effettivo solo quando il comando include il contenuto di un elemento, ad esempio C:\Windows\*, in cui il carattere jolly specifica il contenuto della directory C:\Windows.

Tipo:	String[]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	True

-LiteralPath

Specifica un percorso per una o più posizioni. Il valore di LiteralPath viene usato esattamente come viene tipizzato. Nessun carattere viene interpretato come caratteri jolly. Se il percorso include caratteri di escape, racchiuderlo tra virgolette singole. Le virgolette singole indicano a PowerShell di non interpretare alcun carattere come sequenze di escape.

Per altre informazioni, vedere about_Quoting_Rules.

Tipo:	String[]
Alias:	PSPath, LP
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-Path

Specifica il percorso degli elementi cancellati. Sono consentiti i caratteri jolly. Questo parametro è obbligatorio, ma il nome del parametro Path è facoltativo.

Tipo:	String[]
Posizione:	0
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	True

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:	SwitchParameter
Alias:	wi
Posizione:	Named
Valore predefinito:	False
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

Input

String

È possibile inviare tramite pipe una stringa di percorso a questo cmdlet.

Output

None

Questo cmdlet non restituisce alcun output.

Note

PowerShell include gli alias seguenti per Clear-Item:

Tutte le piattaforme:
- cli
Il cmdlet Clear-Item è supportato solo da diversi provider di PowerShell, inclusi i provider di alias, Environment, Function, Registrye Variable. Di conseguenza, è possibile usare Clear-Item per eliminare il contenuto degli oggetti negli spazi di denominazione del provider. Per elencare i provider disponibili nella sessione, digitare Get-PSProvider. Per altre informazioni, vedere about_Providers.
Non è possibile usare Clear-Item per eliminare il contenuto di un file, perché il provider FileSystem di PowerShell non supporta questo cmdlet. Per cancellare i file, usare il Clear-Content.

Condividi tramite