Condividi tramite

Clear-Content

  • Riferimento
Modulo:
Microsoft.PowerShell.Management

Elimina il contenuto di un elemento, ma non elimina 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 cmdlet Clear-Content 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 file init.txt in tutte le sottodirectory della directory SmpUsers. 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 del nome di file .log, 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 del nome file .log 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 cmdlet Clear-Content cancella il contenuto da un flusso di dati alternativo lasciando invariato il flusso.

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

Il secondo comando usa il cmdlet Clear-Content 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 modo 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 cmdlet Unblock-File.

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 durante l'esecuzione di 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. Sono consentiti caratteri jolly.

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 nella lingua del provider. Il valore di questo parametro qualifica il parametro Path. La sintassi del filtro, incluso l'uso di 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 dell'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. Sono consentiti caratteri jolly.

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 digitato. Nessun carattere viene interpretato come caratteri 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. Sono consentiti caratteri jolly. I percorsi devono essere percorsi per gli elementi, non per i contenitori. Ad esempio, è necessario specificare un percorso per uno o più file, non un percorso di una directory. Sono consentiti 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

-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 cmdlet Clear-Content 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 cmdlet Unblock-File.

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

None

Non è possibile inviare tramite pipe oggetti a questo cmdlet.

Output

None

Questo cmdlet non restituisce alcun 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 che non sono considerati contenuti, ad esempio gli elementi gestiti dai provider di certificati PowerShell o del Registro di sistema, usare Clear-Item.

Il cmdlet Clear-Content è 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.