Clear-Content

  • Riferimento
Modulo:
Microsoft.PowerShell.Management

Elimina il contenuto di un elemento, ma non l'elemento.

Sintassi

Clear-Content
     [-Path] <String[]>
     [-Filter <String>]
     [-Include <String[]>]
     [-Exclude <String[]>]
     [-Force]
     [-Credential <PSCredential>]
     [-WhatIf]
     [-Confirm]
     [-UseTransaction]
     [-Stream <String>]
     [<CommonParameters>]
Clear-Content
     -LiteralPath <String[]>
     [-Filter <String>]
     [-Include <String[]>]
     [-Exclude <String[]>]
     [-Force]
     [-Credential <PSCredential>]
     [-WhatIf]
     [-Confirm]
     [-UseTransaction]
     [-Stream <String>]
     [<CommonParameters>]
Clear-Content
     [-Path] <String[]>
     [-Filter <String>]
     [-Include <String[]>]
     [-Exclude <String[]>]
     [-Force]
     [-Credential <PSCredential>]
     [-WhatIf]
     [-Confirm]
     [-UseTransaction]
     [<CommonParameters>]
Clear-Content
     -LiteralPath <String[]>
     [-Filter <String>]
     [-Include <String[]>]
     [-Exclude <String[]>]
     [-Force]
     [-Credential <PSCredential>]
     [-WhatIf]
     [-Confirm]
     [-UseTransaction]
     [<CommonParameters>]

Descrizione

Il Clear-Content cmdlet elimina il contenuto di un elemento, ad esempio l'eliminazione del testo da un file, ma non elimina l'elemento. Di conseguenza, l'elemento esiste, ma è vuoto. Clear-Content è simile a Clear-Item, ma funziona sugli elementi con contenuto, anziché su elementi con valori.

Esempio

Esempio 1: Eliminare tutto il contenuto da una directory

Clear-Content "..\SmpUsers\*\init.txt"

Questo comando elimina tutto il contenuto dai init.txt file in tutte le sottodirectory della SmpUsers directory. I file non vengono eliminati, ma sono vuoti.

Esempio 2: Eliminare il contenuto di tutti i file con un carattere jolly

Clear-Content -Path "*" -Filter "*.log" -Force

Questo comando elimina il contenuto di tutti i file nella directory corrente con l'estensione .log del nome file, inclusi i file con l'attributo di sola lettura. L'asterisco (*) nel percorso rappresenta tutti gli elementi nella directory corrente. Il parametro Force rende effettivo il comando nei file di sola lettura. L'uso di un filtro per limitare il comando ai file con l'estensione .log del nome file anziché specificare *.log nel percorso rende l'operazione più veloce.

Esempio 3: Cancellare tutti i dati da un flusso

In questo esempio viene illustrato come il Clear-Content cmdlet cancella il contenuto da un flusso di dati alternativo lasciando intatto il flusso.

Il primo comando usa il Get-Content cmdlet per ottenere il contenuto del Zone.Identifier flusso nel Copy-Script.ps1 file scaricato da Internet.

Il secondo comando usa il Clear-Content cmdlet per cancellare il contenuto.

Il terzo comando ripete il primo comando. Verifica che il contenuto sia cancellato, ma il flusso rimane. Se il flusso è stato eliminato, il comando genererà un errore.

È possibile usare un metodo come questo per cancellare il contenuto di un flusso di dati alternativo. Tuttavia, non è il metodo consigliato per eliminare i controlli di sicurezza che bloccano i file scaricati da Internet. Se si verifica che un file scaricato sia sicuro, usare il Unblock-File cmdlet .

Get-Content C:\Test\Copy-Script.ps1 -Stream Zone.Identifier

[ZoneTransfer]
ZoneId=3

Clear-Content C:\Test\Copy-Script.ps1 -Stream Zone.Identifier
Get-Content C:\Test\Copy-Script.ps1 -Stream Zone.Identifier

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, stringhe che questo cmdlet omette dal percorso al contenuto. Il valore di questo parametro qualifica il parametro Path . Immettere un elemento o un modello di percorso, ad esempio *.txt. I caratteri jolly sono consentiti.

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

-Filter

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'uso dei caratteri jolly, dipende dal provider. I filtri sono più efficienti rispetto ad altri parametri, perché il provider li applica durante il recupero degli oggetti, invece di 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

Forza l'esecuzione del comando senza chiedere conferma all'utente.

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

-Include

Specifica, come matrice di stringhe, contenuto che il cmdlet cancella. Il valore di questo parametro qualifica il parametro Path . Immettere un elemento o un modello di percorso, ad esempio *.txt. I caratteri jolly sono consentiti.

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

-LiteralPath

Specifica i percorsi degli elementi da cui viene eliminato il contenuto. A differenza del parametro Path , il valore di LiteralPath viene usato esattamente come viene tipizzato. Nessun carattere viene interpretato come carattere jolly. Se il percorso include caratteri di escape, racchiuderlo tra virgolette singole ('). Le virgolette singole indicano che PowerShell non interpreta alcun carattere come sequenze di escape.

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

-Path

Specifica i percorsi degli elementi da cui viene eliminato il contenuto. I caratteri jolly sono consentiti. È necessario usare percorsi di elementi, non di contenitori. Ad esempio, è necessario specificare un percorso di uno o più file, non di una directory. I caratteri jolly sono consentiti. 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

-Stream

Si tratta di un parametro dinamico reso disponibile dal provider FileSystem .

Specifica un flusso di dati alternativo per il contenuto. Se il flusso non esiste, questo cmdlet lo crea. I caratteri jolly non sono supportati.

È possibile usare il Clear-Content cmdlet per modificare il contenuto di qualsiasi flusso di dati alternativo, ad esempio Zone.Identifier. Tuttavia, non è consigliabile farlo come modo per eliminare i controlli di sicurezza che bloccano i file scaricati da Internet. Se si verifica che un file scaricato sia sicuro, usare il Unblock-File cmdlet .

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Per altre informazioni, vedere about_FileSystem_Provider.

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

-UseTransaction

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

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

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. 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

None

Non è possibile inviare tramite pipe oggetti a questo cmdlet.

Output

None

Questo cmdlet non restituisce output.

Note

Windows PowerShell include gli alias seguenti per Clear-Content:

  • clc

È possibile usare Clear-Content con il provider FileSystem di PowerShell e con altri provider che modificano il contenuto. Per cancellare gli elementi non considerati come contenuti, ad esempio gli elementi gestiti dai provider di certificati PowerShell o del Registro di sistema, usare Clear-Item.

Il Clear-Content cmdlet è progettato per lavorare con i dati esposti da qualsiasi provider. Per elencare i provider disponibili nella sessione, digitare Get-PsProvider. Per altre informazioni, vedere about_Providers.