Condividi tramite

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]
     [-UseTransaction]
     [<CommonParameters>]
Clear-Item
     -LiteralPath <String[]>
     [-Force]
     [-Filter <String>]
     [-Include <String[]>]
     [-Exclude <String[]>]
     [-Credential <PSCredential>]
     [-WhatIf]
     [-Confirm]
     [-UseTransaction]
     [<CommonParameters>]

Descrizione

Il Clear-Item cmdlet cancella il contenuto di un elemento, ma non elimina l'elemento. Ad esempio, il Clear-Item cmdlet può eliminare il valore di una variabile, ma non elimina la variabile. Il valore usato per rappresentare un elemento cancellato viene definito da ogni provider di PowerShell. Questo cmdlet è simile a Clear-Content, ma funziona su alias e variabili, anziché su 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à PowerShell Variable: e quindi eseguire il Clear-Item comando.

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 la finalità. Non elimina la sottochiave "MyKey" né influisce su altre chiavi o voci del Registro di sistema. È possibile usare i parametri Include ed Exclude per identificare chiavi del Registro di sistema specifiche, ma non è possibile usarli per identificare le voci del Registro di sistema.

  • Per eliminare voci specifiche del Registro di sistema, usare il Remove-ItemProperty cmdlet .
  • Per eliminare il valore di una voce del Registro di sistema, usare il Clear-ItemProperty cmdlet .
Clear-Item HKLM:\Software\MyCompany\MyKey -Confirm

Parametri

-Confirm

Richiede la conferma dell'utente prima di eseguire il cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:PSCredential
Position:Named
Default value:Current user
Required:False
Accept pipeline input:True
Accept wildcard characters: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 criterio di percorso, ad esempio *.txt. I caratteri jolly sono consentiti. Il parametro Exclude è valido solo quando il comando include il contenuto di un elemento, ad esempio C:\Windows\*, dove il carattere jolly specifica il contenuto della C:\Windows directory.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Filter

Specifica un filtro per qualificare il parametro Path . Il provider FileSystem è l'unico provider di PowerShell installato che supporta l'uso dei filtri. È possibile trovare la sintassi per il 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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Force

Indica che il cmdlet cancella gli elementi che non possono altrimenti essere modificati, ad esempio alias di sola lettura. Il cmdlet non può cancellare le costanti. L'implementazione varia a seconda del 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 .

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Include

Specifica, come matrice di stringhe, un elemento o elementi inclusi nel cmdlet nell'operazione. Il valore di questo parametro qualifica il parametro Path. Immettere un elemento o un criterio di percorso, ad esempio "*.txt". I caratteri jolly sono consentiti. Il parametro Include è valido solo quando il comando include il contenuto di un elemento, ad esempio C:\Windows\*, dove il carattere jolly specifica il contenuto della C:\Windows directory.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-LiteralPath

Specifica un percorso di una o più posizioni. Il valore di LiteralPath viene usato esattamente come viene digitato. Nessun carattere viene interpretato come carattere 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.

Type:String[]
Aliases:PSPath
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Path

Specifica il percorso degli elementi da cancellare. I caratteri jolly sono consentiti. Questo parametro è obbligatorio, ma il nome del parametro Path è facoltativo.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-UseTransaction

Include il comando nella transazione attiva. Questo parametro è valido solo quando è in corso una transazione. Per altre informazioni, vedere about_Transactions.

Type:SwitchParameter
Aliases:usetx
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

String

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

Output

None

Questo cmdlet non genera alcun output.

Note

  • Il Clear-Item cmdlet è supportato solo da diversi provider di PowerShell, inclusi i provider Alias, Environment, Function, Registry e Variable . Di conseguenza, è possibile usare Clear-Item per eliminare il contenuto degli elementi negli spazi dei nomi 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 .Clear-Content