Elimina gli elementi specificati.

Sintassi

Remove-Item [-LiteralPath] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-Recurse] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]

Remove-Item [-Path] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-Recurse] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]

Descrizione

Il cmdlet Remove-Item elimina uno o più elementi. Poiché è supportato da molti provider, può eliminare diversi tipi di elementi, inclusi file, directory, chiavi del Registro di sistema, variabili, alias e funzioni.

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 rimuovere elementi che non possono essere modificati in altro modo, ad esempio file nascosti o di sola lettura, alias di sola lettura o variabili. Il cmdlet non può rimuovere gli alias o le variabile 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[]>

Elimina 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 un percorso degli elementi da rimuovere. 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 un percorso degli elementi da rimuovere. È consentito l'utilizzo di caratteri jolly. Il nome del parametro ("-Path") è facoltativo.

Obbligatorio?

true

Posizione?

1

Valore predefinito

Accettare input da pipeline?

true (ByValue, ByPropertyName)

Accettare caratteri jolly?

false

-Recurse

Elimina gli elementi nei percorsi specificati e in tutti gli elementi figlio dei percorsi.

Il parametro Recurse di questo cmdlet non funziona correttamente.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

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 che contiene un percorso (ma non un percorso letterale) a Remove-Item.

Output

Nessuno

Questo cmdlet non restituisce alcun output.

Note

È inoltre possibile fare riferimento a Remove-Item tramite uno o più dei relativi alias predefiniti "del", "erase", "rmdir", "rd", "ri" o "rm". Per ulteriori informazioni, vedere about_Aliases.

Il cmdlet Remove-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>remove-item C:\Test\*.*

Descrizione
-----------
Con questo comando vengono eliminati dalla directory C:\Test tutti i file il cui nome contiene un punto (.). Poiché nel comando viene specificato un punto, non vengono eliminate le directory o i file senza estensione.

Esempio 2

C:\PS>remove-item * -include *.doc -exclude *1*

Descrizione
-----------
Con questo comando vengono eliminati dalla directory corrente tutti i file con estensione doc e il cui nome non contiene 1. Il carattere jolly (*) viene utilizzato per specificare il contenuto della directory corrente. Vengono utilizzati i parametri Include ed Exclude per specificare i file da eliminare.

Esempio 3

C:\PS>remove-item -path C:\Test\hidden-RO-file.txt -force

Descrizione
-----------
Con questo comando viene eliminato un file nascosto e di sola lettura. Viene utilizzato il parametro Path per specificare il file. Il parametro Force viene utilizzato per concedere l'autorizzazione a eliminare il file. Senza tale parametro, non è possibile eliminare i file di sola lettura o nascosti.

Esempio 4

C:\PS>get-childitem * -include *.csv -recurse | remove-item

Descrizione
-----------
Con questo comando vengono eliminati tutti i file CSV nella directory corrente e in tutte le sottodirectory, in modalità ricorsiva.

Poiché il parametro Recurse di questo cmdlet non funziona, viene utilizzato il cmdlet Get-Childitem per ottenere i file desiderati e l'operatore pipeline per passarli al cmdlet Remove-Item.

Nel comando Get-ChildItem, il parametro Path ha un valore di *, che rappresenta il contenuto della directory corrente. Viene utilizzato il parametro Include per specificare il tipo di file CSV e il parametro Recurse per rendere ricorsivo il recupero. 

Se si tenta di specificare il tipo di file nel percorso, ad esempio "-path *.csv", il cmdlet interpreta l'oggetto della ricerca come file senza elementi figlio e il parametro Recurse ha esito negativo.

Esempio 5

C:\PS>remove-item hklm:\software\mycompany\OldApp -recurse

Descrizione
-----------
Con questo comando viene eliminata la chiave del Registro di sistema OldApp e tutte le sottochiavi e i valori relativi. Viene utilizzato il cmdlet Remove-Item per rimuovere la chiave. Il percorso è specificato, ma il nome del parametro facoltativo (Path) è omesso. 

Con il parametro Recurse viene eliminato tutto il contenuto della chiave OldApp in modo ricorsivo. Se la chiave contiene sottochiavi e si omette il parametro Recurse, viene richiesto di confermare l'eliminazione del contenuto della chiave.

Vedere anche



Argomenti della Guida