Remove-Item

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

L’applet de commande Remove-Item supprime un ou plusieurs éléments. Étant donné qu’il est pris en charge par de nombreux fournisseurs, il peut supprimer de nombreux types d’éléments différents, notamment les fichiers, dossiers, clés de Registre, variables, alias et fonctions.

Cette commande supprime tous les fichiers qui ont des noms qui incluent un point ('.') dans le dossier « C :\Test ». Étant donné que la commande spécifie un point, la commande ne supprime pas les dossiers ou les fichiers qui n’ont aucune extension de nom de fichier.

Remove-Item C:\Test\*.*

Cette commande supprime du dossier actif tous les fichiers qui ont une extension de nom de fichier « .doc » et un nom qui n’inclut pas 1. Il utilise le caractère générique ('*') pour spécifier le contenu du dossier actif. Il utilise les paramètres Include et Exclure pour spécifier les fichiers à supprimer.

Remove-Item * -Include *.doc -Exclude *1*

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

Remove-Item -Path C:\Test\hidden-RO-file.txt -Force

Cette commande supprime tous les fichiers CSV du dossier actif et tous les sous-dossiers de manière récursive.

Étant donné que le paramètre Recurse dans Remove-Item a un problème connu, la commande de cet exemple utilise Get-ChildItem pour obtenir les fichiers souhaités, puis utilise l’opérateur de pipeline pour les transmettre à Remove-Item.

Dans la commande Get-ChildItem, Chemin d’accès a la valeur ' *', qui représente le contenu du dossier actif. Il utilise Include pour spécifier le type de fichier CSV et utilise Recurse pour rendre la récupération récursive.

Si vous essayez de spécifier le type de fichier, tel que -Path *.csv, l’applet de commande interprète l’objet de la recherche comme un fichier qui n’a aucun élément enfant et récurser échoue.

Get-ChildItem * -Include *.csv -Recurse | Remove-Item

Cette commande supprime la clé de Registre « OldApp » et toutes ses sous-clés et valeurs. Il utilise Remove-Item pour supprimer la clé. Le chemin d’accès est spécifié, mais le nom de paramètre facultatif (Path) est omis.

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

Remove-Item HKLM:\Software\MyCompany\OldApp -Recurse

L’exemple suivant montre comment supprimer des fichiers qui contiennent des caractères spéciaux tels que des crochets ou des parenthèses.

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

Cet exemple montre comment utiliser le paramètre dynamique Stream de l’applet de commande Remove-Item pour supprimer un autre flux de données. Le paramètre de flux est introduit dans Windows PowerShell 3.0.

La première commande utilise le paramètre dynamique Stream de l’applet de commande pour obtenir le flux zone.Identifier du fichier «Copy-Script.ps1».

La deuxième commande utilise le paramètre dynamique Stream de l’applet de commande pour supprimer le flux de Zone.Identifier du fichier.

La troisième commande utilise le paramètre dynamique Stream de l’applet de commande pour vérifier que le flux zone.Identifier est supprimé.

La quatrième commande Get-Item cmdlet sans le paramètre Stream pour vérifier que le fichier n’est pas supprimé.

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

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Vous pouvez diriger une chaîne qui contient un chemin d’accès, mais pas un chemin littéral, vers cette applet de commande.

Cette applet de commande ne retourne aucune sortie.

L’applet de commande Remove-Item est conçue pour fonctionner avec 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, voir about_Providers.