Move-Item

Move-Item
    [-Path] <String[]>
    [[-Destination] <String>]
    [-Force]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-PassThru]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Move-Item
    [[-Destination] <String>]
    -LiteralPath <String[]>
    [-Force]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-PassThru]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

O cmdlet Move-Item move um item, incluindo suas propriedades, conteúdo e os itens filhos, de um local para outro. Os locais devem ter suporte no mesmo provedor.

Por exemplo, ele pode mover um arquivo ou subdiretório de um diretório para outro ou mover uma subchave do Registro de uma chave para outra. Quando você move um item, ele é adicionado ao novo local e excluído de seu local original.

Esse comando move o arquivo Test.txt da unidade C: para o diretório E:\Temp e o renomeia de test.txt para tst.txt.

Move-Item -Path C:\test.txt -Destination E:\Temp\tst.txt

Esse comando move o diretório C:\Temp e seu conteúdo para o diretório C:\Logs. O diretório Temp e todos os seus subdiretórios e arquivos, aparecem no diretório Logs.

Move-Item -Path C:\Temp -Destination C:\Logs

Esse comando move todos os arquivos de texto (*.txt) no diretório atual (representado por um ponto (.)) para o diretório C:\Logs.

Move-Item -Path .\*.txt -Destination C:\Logs

Esse comando move todos os arquivos de texto do diretório atual e todos os subdiretórios, recursivamente, para o diretório C:\TextFiles.

Get-ChildItem -Path ".\*.txt" -Recurse | Move-Item -Destination "C:\TextFiles"

O comando usa o cmdlet Get-ChildItem para obter todos os itens filho no diretório atual (representado pelo ponto (.)) e seus subdiretórios que têm uma extensão de nome de arquivo *.txt. Ele usa o parâmetro Recurse para tornar a recuperação recursiva e o parâmetro Include para limitar a recuperação a arquivos de *.txt.

O operador de pipeline (|) envia os resultados desse comando para Move-Item, que move os arquivos de texto para o diretório TextFiles.

Se os arquivos que devem ser movidos para C:\Textfiles tiverem o mesmo nome, Move-Item exibirá um erro e continuará, mas moverá apenas um arquivo com cada nome para C:\Textfiles. Os outros arquivos permanecem em seus diretórios originais.

Se o diretório Textfiles (ou qualquer outro elemento do caminho de destino) não existir, o comando falhará. A pasta não é criada para você, mesmo se usar o parâmetro Force. Move-Item move o primeiro item para um arquivo chamado Textfiles e exibe um erro explicando que o arquivo já existe.

Além disso, por padrão, Get-ChildItem não move arquivos ocultos. Para mover arquivos ocultos, use o parâmetro Force com Get-ChildItem.

Esse comando move as chaves e os valores do Registro dentro da chave do registro MyCompany em HKLM\Software para a chave MyNewCompany. O caractere curinga (*) indica que o conteúdo da chave MyCompany deve ser movido, não a chave em si. Nesse comando, os nomes de parâmetros Path e Destination opcionais são omitidos.

Move-Item "HKLM:\software\mycompany\*" "HKLM:\software\mynewcompany"

Esse comando move o diretório Logs[Sept`06] (e seu conteúdo) para o diretório Logs[2006].

Move-Item -LiteralPath 'Logs[Sept`06]' -Destination 'Logs[2006]'

O parâmetro LiteralPath é usado em vez de Path, porque o nome do diretório original inclui caracteres de colchete esquerdo e direito ([ e ]). O caminho também está entre aspas simples ('), de modo que o símbolo de acento grave (`) não seja interpretado incorretamente.

O parâmetro Destination também deve ser colocado entre aspas simples, pois inclui colchetes que podem ser mal interpretados.

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.

É possível direcionar uma cadeia de caracteres que contém um caminho para este cmdlet.

Por padrão, esse cmdlet não retorna nenhuma saída.

Quando você usa o parâmetro PassThru, esse cmdlet retorna um objeto que representa o item movido.

O PowerShell inclui os seguintes aliases para Move-Item:

• Todas as plataformas:

  • mi
  • move

• Windows:

  • mv

• Esse cmdlet moverá arquivos entre unidades compatíveis com o mesmo provedor, mas moverá diretórios apenas na mesma unidade.

• Como um comando Move-Item move as propriedades, o conteúdo e os itens filho de um item, todas as movimentações são recursivas por padrão.

• Esse cmdlet foi projetado para funcionar com os dados expostos por qualquer provedor. Para listar os provedores disponíveis na sessão, digite Get-PSProvider. Para obter mais informações, consulte about_Providers.