Example usage of Remove-Item.
Remove-Item .\cache\old.tmp -WhatIfRemove-Item cmdlet
Deletes the specified items.
Syntax
Remove-Item [-Path] <string[]> [-Recurse] [-Force] [-WhatIf]This is a practical syntax summary, not every parameter set. Run Get-Command Remove-Item -Syntax and Get-Help Remove-Item -Full in the installed version for its complete syntax and parameter metadata. Common parameters and -WhatIf/-Confirm support depend on the command and PowerShell version.
Examples
Read all available parameter sets and help for the installed module.
Get-Help Remove-Item -FullParameters, options and clauses
| Option / clause | Description |
|---|---|
-Path / -LiteralPath <path[]> | Select targets; inspect wildcard expansion carefully. |
-Recurse | Remove child items recursively. |
-Force | Remove items with restrictive attributes where supported. |
-WhatIf | Preview what would be removed without deleting it. |
-Confirm | Ask before applying removal where supported. |
-Verbose | Write additional diagnostic detail to the verbose stream. |
-Debug | Write debugging messages to the debug stream. |
-ErrorAction <action> | Control how a non-terminating error is handled. |
-ErrorVariable <name> | Store error records in a variable. |
-WarningAction <action> | Control how warnings are handled. |
-WarningVariable <name> | Store warning messages in a variable. |
-InformationAction <action> | Control how information messages are handled. |
-InformationVariable <name> | Store information messages in a variable. |
-OutVariable <name> | Store output in a variable as well as sending it onward. |
-OutBuffer <count> | Set the number of objects to collect before the next command runs. |
-PipelineVariable <name> | Store the current pipeline object in a variable during processing. |
-ProgressAction <action> | Control progress reporting in versions that support this parameter. |
Related PowerShell references
Review a command and its target before running it. Commands that alter files, services, accounts, disks, permissions or databases may be difficult to reverse. Test in a safe environment and keep backups.