Remove-Item

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

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

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

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

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

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

O Remove-Item cmdlet elimina um ou mais itens. Como é suportado por muitos fornecedores, pode eliminar vários tipos diferentes de itens, incluindo ficheiros, pastas, chaves de registo, variáveis, pseudónimos e funções.

Este exemplo elimina todos os ficheiros com nomes que incluem um ponto (.) da C:\Test pasta. Como o comando especifica um ponto, o comando não apaga pastas ou ficheiros que não têm extensão de ficheiro.

Remove-Item C:\Test\*.*

Este exemplo apaga da pasta atual todos os ficheiros que tenham uma .doc extensão de ficheiro e um nome que não inclua *1*.

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

Utiliza o carácter coringa (*) para especificar o conteúdo da pasta atual. Utiliza os parâmetros Incluir e Excluir para especificar os ficheiros a eliminar.

Este comando apaga um ficheiro que é tanto oculto como só leitura.

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

Utiliza o parâmetro Path para especificar o ficheiro. Usa o parâmetro Força para a eliminar. Sem o Force, não podes apagar ficheiros apenas de leitura ou ocultos .

Este comando apaga todos os ficheiros CSV na pasta atual e todas as subpastas recursivamente.

Como o parâmetro Recurse em Remove-Item tem um problema conhecido, o comando neste exemplo usa Get-ChildItem para obter os ficheiros desejados, e depois usa o operador pipeline para os passar para Remove-Item.

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

No Get-ChildItem comando, Path tem um valor de (*), que representa o conteúdo da pasta atual. Usa Include para especificar o tipo de ficheiro CSV e usa Recurse para tornar a recuperação recursiva. Se tentar especificar o tipo de ficheiro no caminho, como -Path *.csv, o cmdlet interpreta o sujeito da pesquisa como sendo um ficheiro sem itens filhos, e o Recurse falha.

# Works in all versions of Windows:
Get-ChildItem -Path * -Include *.csv -Recurse | Remove-Item
# Only correctly finds and removes nested CSV files in Windows 1909 and later:
Get-ChildItem -Path *.csv -Recurse | Remove-Item

Este comando elimina a chave de registo "OldApp" e todas as suas subchaves e valores. É usado Remove-Item para remover a chave. O caminho é especificado, mas o nome opcional do parâmetro (Caminho) é omitido.

O parâmetro Recurse elimina recursivamente todo o conteúdo da chave "OldApp". Se a chave contiver subchaves e omitir o parâmetro Recurse , é solicitado que confirme que quer apagar o conteúdo da chave.

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

O exemplo seguinte mostra como eliminar ficheiros que contenham caracteres especiais como colchetes ou parênteses.

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

Este exemplo mostra como usar o parâmetro dinâmico Stream do Remove-Item cmdlet para eliminar um fluxo de dados alternativo. O parâmetro de fluxo é introduzido no Windows PowerShell 3.0.

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'.

O parâmetro Get-ItemStream recebe o Zone.Identifier fluxo do Copy-Script.ps1 ficheiro. Remove-Item usa o parâmetro Stream para remover o Zone.Identifier fluxo do ficheiro. Finalmente, o Get-Item cmdlet mostra que o Zone.Identifier stream foi eliminado.

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Podes canalizar uma corda que contenha um caminho, mas não um caminho literal, para este cmdlet.

Este cmdlet não retorna nenhuma saída.

O PowerShell inclui os seguintes aliases para Remove-Item:

• Todas as plataformas:
  • del
  • erase
  • rd
  • ri
• Windows:
  • rm
  • rmdir

O cmdlet Remove-Item foi projetado para trabalhar com os dados expostos por qualquer provedor. Para listar os provedores disponíveis em sua sessão, digite Get-PSProvider. Para obter mais informações, consulte about_Providers.

Quando tentas eliminar uma pasta que contém itens sem usar o parâmetro Recurse , o cmdlet pede confirmação. Usar -Confirm:$false não suprime o prompt. Isso é intencional.