Elimina il contenuto di un elemento, senza eliminare l'elemento stesso.
Sintassi
Clear-Item [-LiteralPath] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>] Clear-Item [-Path] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]
Descrizione
Con il cmdlet Clear-Item viene eliminato il valore di un elemento, senza eliminare l'elemento stesso. Ad esempio, Clear-Item consente di eliminare il valore di una variabile, ma non la variabile stessa. Il valore utilizzato per rappresentare un elemento cancellato viene definito da ogni provider di Windows PowerShell. Clear-Item è simile a Clear-Content, ma funziona su alias e variabili anziché su file.
Parametri
-Credential <PSCredential>
Specifica un account utente con autorizzazione per l'esecuzione di questa azione. Il valore predefinito è l'utente corrente.
Digitare un nome utente, ad esempio "Utente01" o "Dominio01\Utente01", o immettere un oggetto PSCredential, ad esempio uno generato dal cmdlet Get-Credential. Se si digita un nome utente, viene richiesta una password.
Questo parametro non è supportato dai provider installati con Windows PowerShell.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByPropertyName) |
|
Accettare caratteri jolly? |
false |
-Exclude <string[]>
Omette gli elementi specificati. Il valore di questo parametro qualifica il parametro Path. Immettere un criterio o un elemento del percorso, ad esempio "*.txt". È consentito l'utilizzo di caratteri jolly.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-Filter <string>
Specifica un filtro nel formato o nel linguaggio del provider. Il valore di questo parametro qualifica il parametro Path. La sintassi del filtro, incluso l'utilizzo dei caratteri jolly, dipende dal provider. I filtri sono più efficienti rispetto ad altri parametri, perché il provider li applica al momento del recupero degli oggetti, anziché utilizzare Windows PowerShell per filtrare gli oggetti dopo il recupero.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-Force
Consente al cmdlet di cancellare elementi che non possono essere modificati in altro modo, ad esempio alias in sola lettura. Il cmdlet non può cancellare le costanti. L'implementazione varia a seconda del provider. Per ulteriori informazioni, vedere about_Providers. Quando si utilizza il parametro Force, il cmdlet non può ignorare le limitazioni di sicurezza.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-Include <string[]>
Cancella unicamente gli elementi specificati. Il valore di questo parametro qualifica il parametro Path. Immettere un criterio o un elemento del percorso, ad esempio "*.txt". È consentito l'utilizzo di caratteri jolly.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-LiteralPath <string[]>
Specifica il percorso degli elementi che vengono cancellati. A differenza di Path, il valore di LiteralPath viene utilizzato così come viene digitato. Nessun carattere viene interpretato come carattere jolly. Se il percorso include caratteri di escape, è necessario racchiuderli tra virgolette singole tramite le quali si comunica a Windows PowerShell di non interpretare alcun carattere come sequenza di escape.
|
Obbligatorio? |
true |
|
Posizione? |
1 |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByPropertyName) |
|
Accettare caratteri jolly? |
false |
-Path <string[]>
Specifica il percorso degli elementi che vengono cancellati. È consentito l'utilizzo di caratteri jolly. Questo parametro è obbligatorio, ma il nome del parametro ("Path") è facoltativo.
|
Obbligatorio? |
true |
|
Posizione? |
1 |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByValue, ByPropertyName) |
|
Accettare caratteri jolly? |
false |
-Confirm
Chiede una conferma prima di eseguire il comando.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-WhatIf
Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-UseTransaction
Include il comando nella transazione attiva. Questo parametro è valido solo quando è in corso una transazione. Per ulteriori informazioni, vedere about_Transactions.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
<CommonParameters>
Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.
Input e output
Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.
|
Input |
System.String È possibile reindirizzare una stringa di percorso a Clear-Item. |
|
Output |
Nessuno Questo cmdlet non restituisce alcun oggetto. |
Note
Il cmdlet Clear-Item è supportato solo da vari provider di Windows PowerShell, inclusi i provider Alias, Environment, Function, Registry e Variable. È pertanto possibile utilizzare Clear-Item per eliminare il contenuto di elementi negli spazi dei nomi del provider.
Non è possibile utilizzare Clear-Item per eliminare il contenuto di un file, perché il provider FileSystem di Windows PowerShell non supporta questo cmdlet. Per cancellare i file, utilizzare Clear-Content.
È inoltre possibile fare riferimento a Clear-Item tramite il relativo alias predefinito "cli". Per ulteriori informazioni, digitare "Get-Help about_Aliases".
Il cmdlet Clear-Item è progettato per l'utilizzo di dati esposti da qualsiasi provider. Per elencare i provider disponibili nella sessione, digitare "Get-PsProvider". Per ulteriori informazioni, vedere about_Providers.
Esempio 1
C:\PS>clear-item Variable:TestVar1
Descrizione
-----------
Con questo comando verrà eliminato il valore della variabile Testvar1. La variabile non viene eliminata e rimane valida, ma il relativo valore viene impostato su null.
Il nome della variabile è preceduta da "Variable:" per indicare il provider Variable di Windows PowerShell. Per ottenere lo stesso risultato, è possibile passare prima allo spazio dei nomi del provider Variable di Windows PowerShell e quindi eseguire il comando Clear-Item.
PS C:> Set-location Variable:
PS Variable:\> clear-item Testvar1
Esempio 2
C:\PS>clear-item Alias:log* -include *1* -exclude *3* -whatif What if: Performing operation "Clear Item" on Target "Item: log1". Descrizione ----------- Con questo comando viene chiesto a Windows PowerShell quali conseguenze avrebbe l'esecuzione del comando "clear-item alias:log* -include *1* -exclude *3". Si riceve la risposta che l'esecuzione del comando comporta l'eliminazione del valore alias log1: Questo comando non avrebbe alcuno effetto sugli alias log, log2 o log13. Poiché il provider di Alias non permette un alias senza un valore, quando si cancella un alias, si elimina anche l'alias.
Esempio 3
C:\PS>clear-item registry::HKLM\Software\MyCompany\MyKey -confirm Descrizione ----------- Con questo comando vengono eliminate tutte le voci del Registro di sistema nella sottochiave MyKey, ma solo dopo la richiesta di conferma. Il comando non elimina la sottochiave MyKey né ha effetto su altre chiavi o voci del Registro di sistema. È possibile utilizzare i parametri Include ed Exclude per identificare determinate chiavi del Registro di sistema, ma non per identificare voci del Registro di sistema. Per eliminare determinate voci del Registro di sistema, utilizzare Remove-ItemProperty. Per eliminare il valore di una voce del Registro di sistema, utilizzare Clear-ItemProperty.
Vedere anche