Remove-Item
Elimina gli elementi specificati.
Sintassi
Remove-Item
[-Path] <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Recurse]
[-Force]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[-Stream <String[]>]
[<CommonParameters>]
Remove-Item
-LiteralPath <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Recurse]
[-Force]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[-Stream <String[]>]
[<CommonParameters>]
Descrizione
Il Remove-Item
cmdlet elimina uno o più elementi.
Poiché è supportato da molti provider, può eliminare molti tipi diversi di elementi, tra cui file, cartelle, chiavi del Registro di sistema, variabili, alias e funzioni.
Esempio
Esempio 1: Eliminare file con estensione di file
Questo comando elimina tutti i file con nomi che includono un punto ('.') dalla cartella "C:\Test". Poiché il comando specifica un punto, il comando non elimina cartelle o file senza estensione di file.
Remove-Item C:\Test\*.*
Esempio 2: Eliminare alcuni file di documento in una cartella
Questo comando elimina dalla cartella corrente tutti i file con estensione di file ".doc" e un nome che non include 1. Usa il carattere jolly ('*') per specificare il contenuto della cartella corrente. Usa i parametri Include ed Exclude per specificare i file da eliminare.
Remove-Item * -Include *.doc -Exclude *1*
Esempio 3: Eliminare file nascosti e di sola lettura
Questo comando elimina un file nascosto e di sola lettura. Usa il parametro Path per specificare il file. Usa il parametro Force per eliminarlo. Senza Force non è possibile eliminare file di sola lettura o nascosti .
Remove-Item -Path C:\Test\hidden-RO-file.txt -Force
Esempio 4: Eliminare i file nelle sottocartelle in modo ricorsivo
Questo comando elimina tutti i file CSV nella cartella corrente e tutte le sottocartelle in modo ricorsivo.
Poiché il parametro Recurse in Remove-Item
presenta un problema noto, il comando in questo esempio usa per ottenere i file desiderati Get-ChildItem
e quindi usa l'operatore della pipeline per passarli a Remove-Item
.
Get-ChildItem
Nel comando Path ha il valore '*', che rappresenta il contenuto della cartella corrente.
Usa Include per specificare il tipo di file CSV e usa Recurse per rendere ricorsivo il recupero.
Se si tenta di specificare il tipo di file il percorso, ad esempio -Path *.csv
, il cmdlet interpreta l'oggetto della ricerca come file senza elementi figlio e Recurse ha esito negativo.
Get-ChildItem * -Include *.csv -Recurse | Remove-Item
Esempio 5: Eliminare le sottochiavi in modo ricorsivo
Questo comando elimina la chiave del Registro di sistema "OldApp" e tutte le relative sottochiavi e valori.
Remove-Item
Usa per rimuovere la chiave.
Il percorso viene specificato, ma il nome del parametro facoltativo (Path) viene omesso.
Il parametro Recurse elimina in modo ricorsivo tutto il contenuto della chiave "OldApp". Se la chiave contiene sottochiavi e si omette il parametro Recurse , viene richiesto di confermare di voler eliminare il contenuto della chiave.
Remove-Item HKLM:\Software\MyCompany\OldApp -Recurse
Esempio 6: Eliminazione di file con caratteri speciali
Nell'esempio seguente viene illustrato come eliminare file contenenti caratteri speciali come parentesi quadre o parentesi.
Get-ChildItem
Directory: C:\temp\Downloads
Mode LastWriteTime Length Name
---- ------------- ------ ----
-a---- 6/1/2018 12:19 PM 1362 myFile.txt
-a---- 6/1/2018 12:30 PM 1132 myFile[1].txt
-a---- 6/1/2018 12:19 PM 1283 myFile[2].txt
-a---- 6/1/2018 12:19 PM 1432 myFile[3].txt
Get-ChildItem | Where-Object Name -Like '*`[*'
Directory: C:\temp\Downloads
Mode LastWriteTime Length Name
---- ------------- ------ ----
-a---- 6/1/2018 12:30 PM 1132 myFile[1].txt
-a---- 6/1/2018 12:19 PM 1283 myFile[2].txt
-a---- 6/1/2018 12:19 PM 1432 myFile[3].txt
Get-ChildItem | Where-Object Name -Like '*`[*' | ForEach-Object { Remove-Item -LiteralPath $_.Name }
Get-ChildItem
Directory: C:\temp\Downloads
Mode LastWriteTime Length Name
---- ------------- ------ ----
-a---- 6/1/2018 12:19 PM 1362 myFile.txt
Esempio 7: Rimuovere un flusso di dati alternativo
In questo esempio viene illustrato come usare il parametro dinamico Stream del Remove-Item
cmdlet per eliminare un flusso di dati alternativo. Il parametro di flusso viene introdotto in Windows PowerShell 3.0.
Il primo comando usa il Stream parametro dinamico del Get-Item
cmdlet per ottenere il flusso Zone.Identifier del file "Copy-Script.ps1".
Il secondo comando usa il Stream parametro dinamico del Remove-Item
cmdlet per rimuovere il flusso Zone.Identifier del file.
Il terzo comando usa il Stream parametro dinamico del Get-Item
cmdlet per verificare che il flusso Zone.Identifier venga eliminato.
Quarto cmdlet di comando Get-Item
senza il parametro Stream per verificare che il file non venga eliminato.
Get-Item C:\Test\Copy-Script.ps1 -Stream Zone.Identifier
FileName: \\C:\Test\Copy-Script.ps1
Stream Length
------ ------
Zone.Identifier 26
Remove-Item C:\Test\Copy-Script.ps1 -Stream Zone.Identifier
Get-Item C:\Test\Copy-Script.ps1 -Stream Zone.Identifier
Get-Item : Could not open alternate data stream 'Zone.Identifier' of file 'C:\Test\Copy-Script.ps1'.
At line:1 char:1
+ Get-Item 'C:\Test\Copy-Script.ps1' -Stream Zone.Identifier
+ [!INCLUDE[]()][!INCLUDE[]()][!INCLUDE[]()][!INCLUDE[]()][!INCLUDE[]()]~~
+ CategoryInfo : ObjectNotFound: (C:\Test\Copy-Script.ps1:String) [Get-Item], FileNotFoundE
xception
+ FullyQualifiedErrorId : AlternateDataStreamNotFound,Microsoft.PowerShell.Commands.GetItemCommand
Get-Item C:\Test\Copy-Script.ps1
Directory: C:\Test
Mode LastWriteTime Length Name
---- ------------- ------ ----
-a--- 8/4/2011 11:15 AM 9436 Copy-Script.ps1
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 gli elementi che questo cmdlet omette. 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.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-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 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: | False |
-Force
Forza il cmdlet a rimuovere elementi che non possono altrimenti essere modificati, ad esempio file nascosti o di sola lettura o alias o variabili di sola lettura. Il cmdlet non può rimuovere alias o variabili costanti. L'implementazione varia a seconda del provider. Per altre informazioni, vedere about_Providers. Anche usando il parametro Force , il cmdlet non può eseguire l'override delle restrizioni di sicurezza.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Include
Specifica gli elementi da eliminare. Il valore di questo parametro qualifica il parametro Path. Immettere un elemento o modello di percorso, ad esempio "*.txt". I caratteri jolly sono consentiti.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LiteralPath
Specifica un percorso degli elementi da rimuovere. A differenza del parametro Path, il valore di LiteralPath viene usato esattamente com'è 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.
Type: | String[] |
Aliases: | PSPath |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Path
Specifica un percorso degli elementi da rimuovere. I caratteri jolly sono consentiti.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Recurse
Indica che questo cmdlet elimina gli elementi nei percorsi specificati e in tutti gli elementi figlio dei percorsi.
Quando viene usato con il parametro Include , il parametro Recurse potrebbe non eliminare tutte le sottocartelle o tutti gli elementi figlio.
Questo è un problema noto
Come soluzione alternativa, provare a eseguire il piping dei risultati del Get-ChildItem -Recurse
comando in Remove-Item
, come descritto in "Esempio 4" in questo argomento.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Stream
Il parametro Stream è un parametro dinamico aggiunto dal provider FileSystem a Remove-Item
.
Questo parametro funziona solo nelle unità di file system.
È possibile usare Remove-Item
per eliminare 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 .
Questo parametro è stato introdotto in Windows PowerShell 3.0.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-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
È possibile inviare tramite pipe una stringa contenente un percorso, ma non un percorso letterale, a questo cmdlet.
Output
None
Questo cmdlet non restituisce alcun output.
Note
Il Remove-Item
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.