Elimina il contenuto di un elemento, ad esempio eliminando il testo da un file, ma non elimina l'elemento stesso.
Sintassi
Clear-Content [-LiteralPath] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>] Clear-Content [-Path] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]
Descrizione
Il cmdlet Clear-Content elimina il contenuto di un elemento, ad esempio eliminando il testo da un file, ma non elimina l'elemento stesso. Di conseguenza l'elemento esiste, ma è vuoto. Clear-Content è simile a Clear-Item, ma funziona sui file anziché su alias e variabili.
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 il contenuto del file anche se il file è di sola lettura. 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 i percorsi degli elementi il cui contenuto viene eliminato. 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 i percorsi degli elementi il cui contenuto viene eliminato. È consentito l'utilizzo di caratteri jolly. È necessario utilizzare percorsi di elementi, non di contenitori. È necessario, ad esempio, specificare un percorso di uno o più file, non di una directory. È 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 (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 |
Nessuno Non è possibile reindirizzare oggetti a Clear-Content. |
|
Output |
Nessuno Questo cmdlet non restituisce alcun oggetto. |
Note
È inoltre possibile fare riferimento a Clear-Content tramite il relativo alias predefinito "clc". Per ulteriori informazioni, vedere about_Aliases.
Se si omette il nome del parametro -Path, il valore di Path deve essere il primo parametro nel comando. Ad esempio, "clear-content c:\mydir\*.txt". Se si include il nome del parametro, è possibile elencare i parametri in qualsiasi ordine.
È possibile utilizzare Clear-Content con il provider File System di Windows PowerShell e con altri provider di modifica del contenuto. Per cancellare elementi che non sono considerati contenuto, ad esempio elementi gestiti dai provider Certificate o Registry di Windows PowerShell, utilizzare Clear-Item.
Il cmdlet Clear-Content è 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-content ..\SmpUsers\*\init.txt Descrizione ----------- Con questo comando viene eliminato tutto il contenuto dei file "init.txt" in tutte le sottodirectory della directory SmpUsers. I file non vengono eliminati, ma sono vuoti.
Esempio 2
C:\PS>clear-content -path * -filter *.log -force Descrizione ----------- Con questo comando viene eliminato il contenuto di tutti i file con estensione "log" nella directory corrente, inclusi quelli con attributo di sola lettura. L'asterisco (*) nel percorso rappresenta tutti gli elementi nella directory corrente. Il parametro Force applica il comando ai file di sola lettura. L'utilizzo di un filtro per limitare il comando ai file con estensione "log", invece di specificare "*.log" nel percorso, rende l'operazione più rapida.
Esempio 3
C:\PS>clear-content c:\Temp\* -Include Smp* -Exclude *2* -whatif Descrizione ----------- Questo comando richiede una previsione delle conseguenze dell'esecuzione del comando: "clear-content c:\temp\* -include smp* -exclude *2*". Nel risultato sono elencati i file che verrebbero cancellati, in questo caso i file nella directory Temp il cui nome inizia per "Smp" e non contiene "2". Per eseguire il comando, eseguirlo nuovamente senza il parametro Whatif.
Vedere anche