Remove-Item

Supprime les éléments spécifiés.

Syntaxe

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

Description

L'applet de commande Remove-Item supprime un ou plusieurs éléments. Comme elle est prise en charge par de nombreux fournisseurs, elle peut supprimer différents types d'éléments, parmi lesquels des fichiers, des répertoires, des clés de Registre, des variables, des alias et des fonctions.

Paramètres

-Credential <PSCredential>

Spécifie un compte d'utilisateur qui a l'autorisation d'exécuter cette action. La valeur par défaut est l'utilisateur actuel.

Tapez un nom d'utilisateur, tel que « User01 » ou « Domain01\User01 », ou entrez un objet PSCredential, tel que celui généré par l'applet de commande Get-Credential. Si vous tapez un nom d'utilisateur, vous êtes invité à entrer un mot de passe.

Ce paramètre n'est pas pris en charge par les fournisseurs installés avec Windows PowerShell.

Obligatoire ?	false
Position ?	named
Valeur par défaut
Accepter l'entrée de pipeline ?	true (ByPropertyName)
Accepter les caractères génériques ?	false

-Exclude <string[]>

Omet les éléments spécifiés. La valeur de ce paramètre qualifie le paramètre Path. Entrez un élément ou un modèle de chemin d'accès, tel que « *.txt ». Les caractères génériques sont autorisés.

Obligatoire ?	false
Position ?	named
Valeur par défaut
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-Filter <string>

Spécifie un filtre dans le format ou le langage du fournisseur. La valeur de ce paramètre qualifie le paramètre Path. La syntaxe du filtre, notamment l'utilisation de caractères génériques, dépend du fournisseur. Les filtres sont plus efficaces que les autres paramètres, car le fournisseur les applique lors de la récupération des objets, plutôt que de laisser le soin à Windows PowerShell de filtrer les objets une fois qu'ils ont été récupérés.

Obligatoire ?	false
Position ?	named
Valeur par défaut
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-Force

Permet à l'applet de commande de supprimer des éléments qui ne peuvent pas être modifiés autrement, tels que des fichiers cachés ou en lecture seule, ou des alias ou des variables en lecture seule. L'applet de commande ne peut pas supprimer des alias ou variables constants. L'implémentation est différente d'un fournisseur à l'autre. Pour plus d'informations, consultez about_Providers. Même en utilisant le paramètre Force, l'applet de commande ne peut pas remplacer les restrictions de sécurité.

Obligatoire ?	false
Position ?	named
Valeur par défaut
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-Include <string[]>

Supprime uniquement les éléments spécifiés. La valeur de ce paramètre qualifie le paramètre Path. Entrez un élément ou un modèle de chemin d'accès, tel que « *.txt ». Les caractères génériques sont autorisés.

Obligatoire ?	false
Position ?	named
Valeur par défaut
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-LiteralPath <string[]>

Spécifie le chemin d'accès aux éléments supprimés. Contrairement à Path, la valeur de LiteralPath est utilisée exactement telle que vous la tapez. Aucun caractère n'est interprété en tant que caractère générique. Si le chemin d'accès inclut des caractères d'échappement, mettez-le entre des guillemets simples. Les guillemets simples indiquent à Windows PowerShell qu'aucun caractère ne doit être interprété en tant que séquence d'échappement.

Obligatoire ?	true
Position ?	1
Valeur par défaut
Accepter l'entrée de pipeline ?	true (ByPropertyName)
Accepter les caractères génériques ?	false

-Path <string[]>

Spécifie le chemin d'accès aux éléments supprimés. Les caractères génériques sont autorisés. Le nom de paramètre (« -Path ») est facultatif.

Obligatoire ?	true
Position ?	1
Valeur par défaut
Accepter l'entrée de pipeline ?	true (ByValue, ByPropertyName)
Accepter les caractères génériques ?	false

-Recurse

Supprime les éléments aux emplacements spécifiés, de même que dans tous les éléments enfants de ces emplacements.

Le paramètre Recurse ne fonctionne pas correctement dans cette applet de commande.

Obligatoire ?	false
Position ?	named
Valeur par défaut
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-Confirm

Vous invite à confirmer l'exécution de la commande.

Obligatoire ?	false
Position ?	named
Valeur par défaut
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-WhatIf

Décrit le résultat que vous obtiendriez en exécutant la commande, sans réellement l'exécuter.

Obligatoire ?	false
Position ?	named
Valeur par défaut
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-UseTransaction

Inclut la commande dans la transaction active. Ce paramètre est valide uniquement lorsqu'une transaction est en cours. Pour plus d'informations, consultez about_Transactions.

Obligatoire ?	false
Position ?	named
Valeur par défaut
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.

Entrées et sorties

Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.

Entrées	System.String Vous pouvez diriger une chaîne qui contient un chemin d'accès (mais pas un chemin d'accès littéral) vers Remove-Item.
Sorties	None Cette applet de commande ne retourne aucune sortie.

Remarques

Vous pouvez également faire référence à Remove-Item via l'un de ses alias intégrés, « del », « erase », « rmdir », « rd », « ri » ou « rm ». Pour plus d'informations, consultez about_Aliases.

L'applet de commande Remove-Item est conçue pour utiliser les données exposées par n'importe quel fournisseur. Pour répertorier les fournisseurs disponibles dans votre session, tapez « Get-PsProvider ». Pour plus d'informations, consultez about_Providers.

Exemple 1

C:\PS>remove-item C:\Test\*.*

Description
-----------
Cette commande supprime du répertoire C:\Test tous les fichiers dont les noms incluent un point (.). Dans la mesure où la commande spécifie un point, elle ne supprime pas les répertoires ou les fichiers dont le nom n'a pas d'extension.

Exemple 2

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

Description
-----------
Cette commande supprime du répertoire actif tous les fichiers dont le nom est doté de l'extension .doc et n'inclut pas « 1 ». Elle utilise le caractère générique (*) pour spécifier le contenu du répertoire actif. Elle utilise les paramètres Include et Exclude pour spécifier les fichiers à supprimer.

Exemple 3

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

Description
-----------
Cette commande supprime un fichier qui est à la fois masqué et en lecture seule. Elle utilise le paramètre Path pour spécifier le fichier. Elle utilise le paramètre Force pour autoriser sa suppression. Sans le paramètre Force, vous ne pouvez pas supprimer les fichiers masqués ou en lecture seule.

Exemple 4

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

Description
-----------
Cette commande supprime de manière récursive tous les fichiers CSV dans le répertoire actif et dans ses sous-répertoires.

Dans la mesure où le paramètre Recurse ne fonctionne pas correctement dans cette applet de commande, la commande utilise l'applet de commande Get-Childitem pour obtenir les fichiers requis et l'opérateur de pipeline pour les passer à l'applet de commande Remove-Item.

Dans la commande Get-ChildItem, la valeur du paramètre Path est *, ce caractère générique représentant le contenu du répertoire actif. La commande utilise le paramètre Include pour spécifier le type de fichier CSV et le paramètre Recurse pour que l'opération de récupération soit exécutée de manière récursive. 

Si vous essayez de spécifier le type de fichier dans le chemin d'accès, par exemple, « -path *.csv » , l'applet de commande interprète l'objet de la recherche comme étant un fichier sans enfant et le paramètre Recurse échoue.

Exemple 5

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

Description
-----------
Cette commande supprime la clé de Registre OldApp, de même que l'ensemble de ses sous-clés et valeurs. Elle utilise l'applet de commande Remove-Item pour supprimer la clé. Le chemin d'accès est spécifié, mais le nom de paramètre optionnel (Path) est omis. 

Le paramètre Recurse supprime de manière récursive tout le contenu de la clé OldApp. Si la clé contient des sous-clés et que vous omettez le paramètre Recurse, vous êtes invité à confirmer la suppression du contenu de la clé.

Voir aussi

Concepts

about_Providers
Clear-Item
Copy-Item
Get-Item
Invoke-Item
Move-Item
New-Item
Remove-ItemProperty
Rename-Item
Set-Item